C++
void xrefSubcommandBindItem( AcDbDatabase*, int, AcDbObjectId ) override;
Description
This callback indicates that the XREF subcommand BIND is being invoked, or that a pre-existing XREF is bound. The BIND is carried out on all dependents in the XREF as well. The BIND subcommand is interactive, and will trigger multiple calls to xrefSubcommandBindItem. The value of activity indicates the reason for the call.
The activity values are as follows:
| kStart | BIND subcommand is invoked (blockId holds no meaningful value at this point) |
| kStartItem | XREF with the objectIdblockId is bound. This occurs for the initial XREF and any dependents it has |
| kEndItem | XREF with the objectIdblockId was successfully bound. This occurs for the initial XREF and any dependents it has |
| kEnd | BIND subcommand completed |
| kAbort | BIND operation either terminated or failed to complete on the specified blockId |
| kStartXBindBlock | Sent for an XDep Block bound by XBind |
| kStartXBindSymbol | Sent for all other symbols: Layers, Linetypes, TextStyles, and DimStyles |
Note:kStartItem still returns an xref Block ID for XBind, as it now does for xref Bind.
Parameters
| Parameters | Description |
|---|---|
| pHost | Input pointer to the host database |
| activity | Passed in activity that the BIND is carrying out; possible values are kStart, kEnd, kAbort, kStartItem, kEndItem |
| blockId | Passed in object ID of the xref being bound |