C++
void xrefSubcommandAttachItem( AcDbDatabase*, int, const ACHAR* ) override;
Description
This callback indicates that XREF subcommand ATTACH is invoked, or that a pre-existing XREF is resolved. The ATTACH subcommand is interactive, and triggers multiple calls to xrefSubcommandAttachItem. The value of activity indicates the reason for the call.
The activity values are:
| kStart | ATTACH subcommand invoked |
| kStartItem | XREF specified by pPath is to be read. This occurs for the initial XREF and any dependents it has |
| kEndItem | XREF specified by pPath is resolved. This occurs for the initial XREF and any dependents it has |
| kEnd | ATTACH subcommand completed |
| kAbort | ATTACH operation either terminated or failed to be resolved |
pPath is the path/filename of the XREF being attached. pPath is the full path of the XREF, including filename and extension.
The xrefSubcommandAttachItem may be called multiple times with an activity value of kStartItem or kEndItem and pPath specification. The call can be triggered by any action which results in a "RESOLVE" on the XREF. Possible triggers include plotting or printer-plotting from the main menu, IGESIN or DXFIN, reloading the XREF, or redefining an existing block.
Parameters
| Parameters | Description |
|---|---|
| pHost | Input pointer to the host database |
| activity | Passed in activity that the ATTACH is carrying out; possible values are kStart, kAbort, kStartItem, kEndItem, or kEnd |
| pPath | Passed in path specification of the XREF which is being attached |