AcDbSoftOwnershipId

Class Hierarchy

AcDbObjectId
    AcDbSoftOwnershipId

C++

class AcDbSoftOwnershipId : public AcDbObjectId;

File

dbid.h

Description

This class is a specialization of AcDbObjectId that is used to distinguish an object specified by an AcDbSoftOwnershipId as being soft owned by some other object. Other properties are the same as the more generic AcDbObjectId.

Remarks

When establishing a reference to another object, consider whether the reference should protect an object from purge, or if WBLOCK needs to follow the pointer reference and copy the reference as well, and whether or not there needs to be an owner-ownee relationship.

Use an AcDbSoftOwnershipId to reference another object when one object needs to own another, but the owner object does not rely on the existence of the object it owns. For example, a layer table owns layerTableRecords for user-defined layers, but the table doesn't need these records for its existence. So, as far as the layer table is concerned, these records can be purged at any time, or left behind in a WBLOCK, without affecting the layer table's existence or function. Therefore, the relationship needs to be a softOwnership.

Specifying an AcDbSoftOwnershipId reference to another object mandates that the owned object is written out to the DWG and DXF files along with the owner object.

Links

AcDbSoftOwnershipId Constructor, AcDbSoftOwnershipId Operators