C++
void xrefSubcommandUnloadItem( AcDbDatabase*, int, AcDbObjectId ) override;
Description
Like the other Xref Subcommand Item reactors, this has the same activity flags. blockId will be NULL for kStart and kEnd, indicating the beginning and end of the Xref UNLOAD command. However, the kStartItem and kEndItem calls will be made only when a previously loaded Xref gets unloaded for any reason, including an unresolved parent Xref (so it does not always mean that the UNLOAD command is in progress).
The reason for any kStart/kEnd call from this reactor is to let applications know that the Xref is being unloaded while still having a valid database loaded into memory. This means that this Xref can potentially get restored later. Any changes made during this callback should be undone if this Xref later gets restored, which is indicated by the following callbacks. Note, that this callback is not related to setting the isUnloaded flag for the Xref. It is only triggered when the Xref is going to be left in a state where a restore is possible.
Parameters
| Parameters | Description |
|---|---|
| pHost | Pointer to the host database |
| activity | Passed in activity that the UNLOAD is carrying out; possible values are kStart, kAbort, kStartItem, kEndItem, or kEnd |
| blockId | Passed in object ID of the XREF which is being UNLOADED |