Function InsertBlock2( _
   const dsString& BlockName As System.String, _
   double InsertX As System.Double, _
   double InsertY As System.Double, _
   double InsertZ As System.Double, _
   double ScaleX As System.Double, _
   double ScaleY As System.Double, _
   double ScaleZ As System.Double, _
   double Rotation As System.Double _
) As BlockInstance

BlockInstance InsertBlock2( 
   System.string BlockName,
   System.double InsertX,
   System.double InsertY,
   System.double InsertZ,
   System.double ScaleX,
   System.double ScaleY,
   System.double ScaleZ,
   System.double Rotation
)

InsertBlock2( 
   BlockName : String,
   InsertX : Number,
   InsertY : Number,
   InsertZ : Number,
   ScaleX : Number,
   ScaleY : Number,
   ScaleZ : Number,
   Rotation : Number
) : dsBlockInstance

HRESULT InsertBlock2( 
   BSTR BlockName,
   DOUBLE InsertX,
   DOUBLE InsertY,
   DOUBLE InsertZ,
   DOUBLE ScaleX,
   DOUBLE ScaleY,
   DOUBLE ScaleZ,
   DOUBLE Rotation,
   IBlockInstance** Blk
) 

DSRESULT InsertBlock2( 
   const dsString& BlockName,
   double InsertX,
   double InsertY,
   double InsertZ,
   double ScaleX,
   double ScaleY,
   double ScaleZ,
   double Rotation,
   dsBlockInstance** Blk
) 

Parameters

BlockName

Name for the Block instance

InsertX

x coordinate where to insert the Block instance

InsertY

y coordinate where to insert the Block instance

InsertZ

z coordinate where to insert the Block instance

ScaleX

Scale factor for the x axis

ScaleY

Scale factor for the y axis

ScaleZ

Scale factor for the z axis

Rotation

Angle, in radians, by which to rotate the Block instance (see Remarks)

Blk[out] or Return Value

Block instance

This code snippet shows how to insert a Block instance.

COM native C++

//Insert the existing Block instance or insert Block instance from a DWG file

 

bstr_t blockFileName ( L"<path_and_DWG_file_name_OR_existing_Block_name>" );

double insertX = 0, insertY = 0, insertZ = 0, scaleX = 1, scaleY = 1, scaleZ = 1, rotation = 0;

BlockInstancePtr blockInstance = sketchMgr->InsertBlock2( blockFileName, insertX, insertY, insertZ, scaleX, scaleY, scaleZ, rotation );

Before calling this method, you can call ICommandMessage::PromptForBlockInsertion if you want to prompt the user to specify how to insert the Block instance.

Use a positive value for Rotation to rotate the Block instance counterclockwise and a negative value to rotate the Block instance clockwise.