Next: , Previous: CADAddImage, Up: CAD areas and methods


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.