AcDbHardPointerId

Class Hierarchy

AcDbObjectId
    AcDbHardPointerId

C++

class AcDbHardPointerId : public AcDbObjectId;

File

dbid.h

Description

This class is a specialization of AcDbObjectId that is used to distinguish an object specified by an AcDbHardPointerId as being hard pointed to by some other object. Other than that, the 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 AcDbHardPointerId to reference another object when the initial object relies on the existence of another object, but both objects will be owned by yet other objects. An example of this is an entity having a hardpointer reference to the layer object it uses. The entity must have the layer present (that is, protected from purge and copied by WBLOCK), but the layer object is owned by the layer table.

For more information on hard vs. soft, ownership vs. pointer, and general objectId usage see the ObjectARX Developer's Guide.

Links

AcDbHardPointerId Constructor, AcDbHardPointerId Operators