Function PromptForBlockInsertion( _
   BSTR PreviewBlockName As System.String, _
   VARIANT_BOOL SpecifyScale As System.Boolean, _
   DOUBLE DefaultScaleX As System.Double, _
   DOUBLE DefaultScaleY As System.Double, _
   DOUBLE DefaultScaleZ As System.Double, _
   VARIANT_BOOL SpecifyRotation As System.Boolean, _
   DOUBLE DefaultRotation As System.Double, _
   DOUBLE* X As System.Double, _
   DOUBLE* Y As System.Double, _
   DOUBLE* Z As System.Double, _
   DOUBLE* ScaleX As System.Double, _
   DOUBLE* ScaleY As System.Double, _
   DOUBLE* ScaleZ As System.Double, _
   DOUBLE* Rotation As System.Double _
) As dsPromptResultType_e

dsPromptResultType_e PromptForBlockInsertion( 
   System.string PreviewBlockName,
   System.bool SpecifyScale,
   System.double DefaultScaleX,
   System.double DefaultScaleY,
   System.double DefaultScaleZ,
   System.bool SpecifyRotation,
   System.double DefaultRotation,
   out System.double X,
   out System.double Y,
   out System.double Z,
   out System.double ScaleX,
   out System.double ScaleY,
   out System.double ScaleZ,
   out System.double Rotation
)

PromptForBlockInsertion( 
   PreviewBlockName : System.String,
   SpecifyScale : Boolean,
   DefaultScaleX : Number,
   DefaultScaleY : Number,
   DefaultScaleZ : Number,
   SpecifyRotation : Boolean,
   DefaultRotation : Number,
) : {
   X : Number,
   Y : Number,
   Z : Number,
   ScaleX : Number,
   ScaleY : Number,
   ScaleZ : Number,
   Rotation : Number,
   Result : String
}

HRESULT PromptForBlockInsertion( 
   const dsString& PreviewBlockName,
,
   bool SpecifyScale,
,
   double DefaultScaleX,
,
   double DefaultScaleY,
,
   double DefaultScaleZ,
,
   bool SpecifyRotation,
,
   double DefaultRotation,
,
   double* X,
,
   double* Y,
,
   double* Z,
,
   double* ScaleX,
,
   double* ScaleY,
,
   double* ScaleZ,
,
   double* Rotation
,
   dsPromptResultType_e* Result
) 

DSRESULT PromptForBlockInsertion( 
   BSTR PreviewBlockName,
,
   VARIANT_BOOL SpecifyScale,
,
   DOUBLE DefaultScaleX,
,
   DOUBLE DefaultScaleY,
,
   DOUBLE DefaultScaleZ,
,
   VARIANT_BOOL SpecifyRotation,
,
   DOUBLE DefaultRotation,
,
   DOUBLE* X,
,
   DOUBLE* Y,
,
   DOUBLE* Z,
,
   DOUBLE* ScaleX,
,
   DOUBLE* ScaleY,
,
   DOUBLE* ScaleZ,
,
   DOUBLE* Rotation
,
   dsPromptResultType_e* Result
) 

Parameters

PreviewBlockName

Name of the Block definition to insert to create the Block instance

SpecifyScale

True to use the values specified for DefaultScaleX, DefaultScaleY, and DefaultScaleZ for the Block instance's scale factors, false to use the user-interactive values (see Remarks)

DefaultScaleX

Scale factor for the x axis for the Block instance if SpecifyScale is set to true (see Remarks)

DefaultScaleY

Scale factor for the y axis for the Block instance if SpecifyScale is set to true (see Remarks)

DefaultScaleZ

Scale factor for the z axis for the Block instance if SpecifyScale is set to true (see Remarks)

SpecifyRotation

True to use the value specified for DefaultRotation for the Block instance's rotation angle, false to use the user-interactive value (see Remarks)

DefaultRotation

Angle, in radians, by which to rotate the Block instance if SpecifyRotation is set to true (see Remarks)

X[out]

x coordinate where to insert the Block instance

Y[out]

y coordinate where to insert the Block instance

Z[out]

z coordinate where to insert the Block instance

ScaleX[out]

Scale factor for the x axis of the Block instance

ScaleY[out]

Scale factor for the y axis of the Block instance

ScaleZ[out]

Scale factor for the z axis of the Block instance

Rotation[out]

Angle, in radians, by which to rotate the Block instance

Parameters

Result[out] or Return Value

Status of the input for inserting the Block instance as defined in dsPromptResultType_e

NOTE: A positive value for the rotation angle rotates the Block instance counterclockwise, and a negative value rotates the Block instance clockwise.

Typical use of this method involves:

1. Defining the Block definition using IDocument::CreateBlockDefinition, if needed. If a Block definition already exists, skip this step.
2. Defining how to insert the Block using ICommandMessage::PromptForBlockInsertion.
3. Inserting the Block using ISketchManager::InsertBlock2 and the output values of ICommandMessage::PromptForBlockInsertion.