C++
void beginInsert( AcDbDatabase*, const AcGeMatrix3d&, AcDbDatabase* ) override;
Description
This callback function indicates that the drawing database pFrom is being added to the drawing database pTo and the transformation matrix xform is applied on the inserted data. It is triggered by the INSERT* command, or if the equivalent of pTo->insert(xform, pFrom) is called.
Note: In the context of the AutoCAD INSERT command, the "insert" process that this notification deals with is strictly the operation of importing objects from a drawing file on disk into the drawing currently in the AutoCAD editor. So, if the INSERT command is inserting a block that is already in the drawing, then no importation process occurs and the AcEditor::beginInsert notification is not sent.
Parameters
| Parameters | Description |
|---|---|
| pTo | Passed in pointer to target drawing database |
| xform | Passed in 3D transformation matrix of the objects which are being inserted |
| pFrom | Passed in pointer to source drawing database which contains the objects being inserted |