ReleaseExtensionDictionary Method (IEntityHelper)

ReleaseExtensionDictionary Method (IEntityHelper) | Send Feedback
See Also

Result[out]
  True if the dictionary is release and erased, false if not (see Remarks)

Obj
  Entity for which to delete the dictionary

Releases and erases the dictionary, if the dictionary exists and is empty, for the specified entity.

# Syntax

Visual Basic |
--- | ---
    Function ReleaseExtensionDictionary( _
       ByVal Obj As System.Object _
    ) As System.Boolean

C# |
--- | ---
    System.bool ReleaseExtensionDictionary(
       System.object Obj
    )

JavaScript |
--- | ---
    ReleaseExtensionDictionary(
       Obj : Object
    ) : Boolean

COM native C++ |
--- | ---
    HRESULT ReleaseExtensionDictionary(
       IDispatch* Obj,
       VARIANT_BOOL* Result
    )

C++ |
--- | ---
    DSRESULT ReleaseExtensionDictionary(
       dsObject* Obj,
       bool* Result
    )

#### Parameters

Obj
  Entity for which to delete the dictionary
Result[out] or Return Value
  True if the dictionary is release and erased, false if not (see Remarks)

# Remarks

If the dictionary exists and is not empty, i.e., it contains one or more XRecords, then it is not released and erased. You must remove or erase all XRecords from the dictionary before you can release and erase the dictionary. See IDictionary::RemoveEntry and IXRecord::Erased.

To restore a released and erased dictionary for the specified entity, call IEntityHelper::CreateExtensionDictionary or IDictionary::Erased. If you close the drawing before restoring the released and erased dictionary, then that dictionary is deleted from the drawing and cannot be restored.

This method also returns true if the dictionary does not exist.

# See Also

####

IEntityHelper Interface
IEntityHelper Members
IEntityHelper::GetExtensionDictionary Method ()

# Availability

DraftSight V1R5.0