C++
void xrefSubcommandOverlayItem( AcDbDatabase*, int, const ACHAR* ) override;
Description
This callback indicates that XREF subcommand OVERLAY is being invoked, or that a pre-existing XREF is being resolved. The OVERLAY subcommand is interactive, and will trigger multiple calls to xrefSubcommandAttachItem. The value of activity indicates the reason for the call.
The activity values are:
| kStart | OVERLAY 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 | OVERLAY subcommand completed |
| kAbort | OVERLAY operation was either terminated or failed to be resolved |
pPath is the path/filename of the XREF being overlaid. 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 OVERLAY is carrying out; possible values are kStart, kAbort, kStartItem, kEndItem, or kEnd |
| pPath | Passed in path specification of the XREF which is being attached |