Share

Dictionary Class

Description

This .NET class wraps the AcRxDictionary ObjectARX class.

This class maintains a collection of pointers to an Object, with keyed search via either a char* text string, or a 32-bit ID. Neither the key nor the stored pointer value may be NULL.

An instance of this class can only be created via the class Kernel, which provides three overloaded versions of the function newDictionary().

The Dictionary may be instantiated so that it sorts based on the key or does not sort the entries at all. In either case the dictionary may be set up to delete the contained Object pointers when they are removed, replaced, or the dictionary is deleted. If the dictionary is not set up to delete its entries (the service registry dictionary is set up this way), then it is up to the user to delete them.

If the dictionary is set up not to delete the Object entries, then it returns their pointer values from atPut() and remove() calls, making it easier to delete them if desired. Otherwise NULL is returned, and delete is called on the pointers.

Class Hierarchy

Autodesk.AutoCAD.Runtime.DisposableWrapper
    Autodesk.AutoCAD.Runtime.RXObject
        Autodesk.AutoCAD.Runtime.Dictionary

Visual Basic

Public Class Dictionary
Inherits RXObject
Inherits IDictionary

C#

public class Dictionary : RXObject, IDictionary;

Links

Dictionary Methods, Dictionary Properties

Was this information helpful?