ReleaseExtensionDictionary Method (IViewport)

ReleaseExtensionDictionary Method (IViewport) | Send Feedback
See Also

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

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

# Syntax

Visual Basic |
--- | ---
    Function ReleaseExtensionDictionary() As System.Boolean

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

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

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

C++ |
--- | ---
    DSRESULT ReleaseExtensionDictionary(
       bool* Result
    )

#### Parameters

Result[out] or Return Value
  True if the dictionary is released 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 this Viewport, call IViewport::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

####

IViewport Interface
IViewport Members
IViewport::GetExtensionDictionary Method ()

# Availability

DraftSight V1R4.0