Class AcApLineCmd

Command to create one line.

Hierarchy (View Summary)

Constructors

constructor

Accessors

globalName localName mode userData

Methods

execute onCommandEnded onCommandWillStart trigger

Constructors

constructor

Accessors

globalName

  • get globalName(): string

    Gets the global (untranslated) name of the command.

    The global name is typically used for programmatic access and should remain consistent across different language localizations.

    Returns string

    The global command name

  • set globalName(value: string): void

    Sets the global (untranslated) name of the command.

    Parameters

    • value: string

      The global command name (e.g., 'LINE', 'CIRCLE', 'ZOOM')

    Returns void

localName

mode

userData

  • get userData(): TUserData

    Gets the custom user-defined data associated with this command.

    userData is a generic, strongly-typed container that allows consumers of the command to attach arbitrary metadata without modifying the command class itself.

    The shape of userData is defined by the generic parameter TUserData when the command is declared:

    Returns TUserData

    The user-defined data object associated with this command

    Example

    interface MyCommandData {
      sourceLayerId: string
      isPreview: boolean
    }

    class MyCommand extends AcEdCommand<MyCommandData> {}

    const cmd = new MyCommand()
    cmd.userData.sourceLayerId = 'Layer-01'
    cmd.userData.isPreview = true

    This design provides flexibility similar to THREE.Object3D.userData while preserving full compile-time type safety.

Methods

execute

  • execute(context: AcApContext): Promise<void>

    Executes the command logic.

    This abstract method must be implemented by subclasses to define the specific behavior of the command. The method receives the current application context providing access to the view and document.

    Parameters

    Returns Promise<void>

    Example

    execute(context: AcApContext) {
      const view = context.view;
      const doc = context.doc;

      // Get user input
      const point = await view.editor.getPoint();

      // Create entity in document
      const entity = new SomeEntity(point);
      doc.database.addEntity(entity);
    }

ProtectedonCommandEnded

ProtectedonCommandWillStart

trigger

  • trigger(context: AcApContext): Promise<void>

    Triggers the command execution with proper event handling.

    This method should not be overridden by subclasses as it handles the event notification workflow. Subclasses should implement the execute() method instead.

    The execution flow:

    1. Fires commandWillStart event
    2. Calls the execute() method
    3. Fires commandEnded event

    Parameters

    • context: AcApContext

      The current application context containing view and document

    Returns Promise<void>

    Example

    const command = new MyCommand();
    command.trigger(docManager.context);

Settings

Member Visibility

On This Page

Constructors
Accessors
Methods