6.15 CADAddInsert

CADAddInsert places a Block by adding a Block insert object with a Transform to a drawing or another block.

IO	Parameter	Type	Description
in	theCADArea	longint	Area ID
in	theBlockID	longint	A Block ID or kCADRootBlockID for the root drawing
in	theLayerOrSubLayerID	longint	Layer ID or Sublayer ID
in	theInsertBlockID	longint	Block ID of the Block to place
in	theMatrixParam1	real	Parameter 1 of a Linear transformation matrix
in	theMatrixParam2	real	Parameter 2 of a Linear transformation matrix
in	theMatrixParam3	real	Parameter 3 of a Linear transformation matrix
in	theMatrixParam4	real	Parameter 4 of a Linear transformation matrix
in	theMatrixParam5	real	Parameter 5 of a Linear transformation matrix
in	theMatrixParam6	real	Parameter 6 of a Linear transformation matrix
out	theNewObjID	longint	Object ID of the new object
out	function result	OSErr	Error result code, also see Error handling

Important
Non-terminating circular block inserts will lead to plug-in crashes (e.g. when block A places block B and at the same time block B places block A).

Related methods
CADAddInsertXY, CADObjInsert, CADGetInsertID, CADSetInsertID, CADGetInsert, CADSetInsert, CADGetInsertXY, CADSetInsertXY, CADGetBlockInfo, CADGetBlocks, CADStandardMatrix.