Class AcDbLayoutDictionary

Dictionary for storing and managing AcDbLayout objects.

This class extends AcDbDictionary to provide specialized functionality for managing layout objects, including searching by block table record ID and tracking the maximum tab order.

Example

const layoutDict = new AcDbLayoutDictionary(database);
const layout = layoutDict.getBtrIdAt('some-block-id');
const maxOrder = layoutDict.maxTabOrder;

Hierarchy (View Summary)

Constructors

constructor

Properties

_recordsById _recordsByName

Accessors

attrs database maxTabOrder numEntries objectId ownerId

Methods

close getAt getAttr getAttrWithoutException getBtrIdAt getIdAt has hasId newIterator remove removeAll removeId setAt setAttr

Constructors

constructor

Properties

Protected_recordsById

_recordsById: Map<string, AcDbLayout>

Map of records indexed by object ID

Protected_recordsByName

_recordsByName: Map<string, AcDbLayout>

Map of records indexed by name

Accessors

attrs

database

  • get database(): AcDbDatabase

  • Gets the database in which this object is resident.

    When an object isn't added to a database, this property returns the current working database. After it is added to a database, it will be set automatically. You should never set this value manually.

    Returns AcDbDatabase

    The database this object belongs to

    Example

    const db = obj.database;
  • set database(db: AcDbDatabase): void

  • Sets the database for this object.

    This is typically set automatically when the object is added to a database. Manual setting should be avoided unless you know what you're doing.

    Parameters

    Returns void

    Example

    obj.database = myDatabase;

maxTabOrder

  • get maxTabOrder(): number

  • Gets the maximum tab order value of layouts in the layout dictionary.

    Returns number

    The maximum tab order value, or -1 if no layouts exist

    Example

    const maxOrder = layoutDict.maxTabOrder;
    console.log('Maximum tab order:', maxOrder);

numEntries

  • get numEntries(): number

  • Gets the number of entries in the dictionary.

    Returns number

    The number of entries in the dictionary

    Example

    const count = dictionary.numEntries;
    console.log(`Dictionary has ${count} entries`);

objectId

  • get objectId(): string

  • Gets the object ID.

    AutoCAD uses 64-bit integers to represent handles, which exceed the maximum integer value of JavaScript. Therefore, strings are used to represent object handles.

    Returns string

    The object ID as a string

    Example

    const id = obj.objectId;
    console.log(`Object ID: ${id}`);
  • set objectId(value: string): void

  • Sets the object ID.

    Parameters

    • value: string

      The new object ID

    Returns void

    Example

    obj.objectId = 'new-object-id';

ownerId

  • get ownerId(): string

  • Gets the object ID of the owner of this object.

    Returns string

    The owner object ID

    Example

    const ownerId = obj.ownerId;
  • set ownerId(value: string): void

  • Sets the object ID of the owner of this object.

    Parameters

    • value: string

      The new owner object ID

    Returns void

    Example

    obj.ownerId = 'parent-object-id';

Methods

close

  • close(): void

  • Closes the object.

    All changes made to the object since it was opened are committed to the database, and a "closed" notification is sent. This method can be overridden by subclasses to provide specific cleanup behavior.

    Returns void

    Example

    obj.close();

getAt

  • getAt(name: string): undefined | AcDbLayout

  • Gets the object with the specified name from the dictionary.

    Parameters

    • name: string

      Name of the object to retrieve

    Returns undefined | AcDbLayout

    The object with the specified name, or undefined if not found

    Example

    const layout = dictionary.getAt('MyLayout');
    if (layout) {
      console.log('Layout found:', layout);
    }

getAttr

  • getAttr(attrName: string): any

  • Gets the value of the specified attribute.

    This method will throw an exception if the specified attribute doesn't exist. Use getAttrWithoutException() if you want to handle missing attributes gracefully.

    Parameters

    • attrName: string

      The name of the attribute to retrieve

    Returns any

    The value of the specified attribute

    Throws

    When the specified attribute doesn't exist

    Example

    try {
      const value = obj.getAttr('objectId');
    } catch (error) {
      console.error('Attribute not found');
    }

getAttrWithoutException

  • getAttrWithoutException(attrName: string): any

  • Gets the value of the specified attribute without throwing an exception.

    This method returns undefined if the specified attribute doesn't exist, making it safer for optional attributes.

    Parameters

    • attrName: string

      The name of the attribute to retrieve

    Returns any

    The value of the specified attribute, or undefined if it doesn't exist

    Example

    const value = obj.getAttrWithoutException('optionalAttribute');
    if (value !== undefined) {
      // Use the value
    }

getBtrIdAt

  • getBtrIdAt(id: string): undefined | AcDbLayout

  • Searches the dictionary for a layout associated with the specified block table record ID.

    Parameters

    • id: string

      The block table record ID to search for

    Returns undefined | AcDbLayout

    The layout associated with the block table record ID, or undefined if not found

    Example

    const layout = layoutDict.getBtrIdAt('some-block-id');
    if (layout) {
      console.log('Found layout:', layout.layoutName);
    }

getIdAt

has

  • has(name: string): boolean

  • Checks if the dictionary contains an object with the specified name.

    Parameters

    • name: string

      Name to search for

    Returns boolean

    True if the dictionary contains an object with the specified name, false otherwise

    Example

    if (dictionary.has('MyLayout')) {
      console.log('Layout exists');
    }

hasId

  • hasId(id: string): boolean

  • Checks if the dictionary contains an object with the specified ID.

    Parameters

    • id: string

      ID to search for

    Returns boolean

    True if the dictionary contains an object with the specified ID, false otherwise

    Example

    if (dictionary.hasId('some-object-id')) {
      console.log('Object exists');
    }

newIterator

remove

  • remove(name: string): boolean

  • Removes the entry specified by name from the dictionary.

    Parameters

    • name: string

      String representing the entry's key (or name)

    Returns boolean

    True if the entry was found and removed, false otherwise

    Example

    const removed = dictionary.remove('MyLayout');
    if (removed) {
      console.log('Layout removed successfully');
    }

removeAll

removeId

  • removeId(id: string): boolean

  • Removes the entry specified by object ID from the dictionary.

    Parameters

    • id: string

      ID of the object to delete

    Returns boolean

    True if the entry was found and removed, false otherwise

    Example

    const removed = dictionary.removeId('some-object-id');

setAt

  • setAt(key: string, value: AcDbLayout): void

  • Adds a new entry to the dictionary.

    If an entry with the specified key already exists, the existing entry is erased and replaced with the new one.

    Parameters

    • key: string

      String representing the object's search key name

    • value: AcDbLayout

      The new object to add to the dictionary

    Returns void

    Example

    const layout = new AcDbLayout();
    dictionary.setAt('MyLayout', layout);

setAttr

Settings

Member Visibility

On This Page

Constructors
Properties
Accessors
Methods