Function Entry: ADDLIST

← Prev | ↑ Chapter | Next → | Index | Symbols

Function Entry: ADDLIST

Name

`addlist`

Class

DCL Function

Syntax

(add_list str)

Arguments and Values

  • str: string; the value to add or substitute in the active list.

Description

Adds or modifies a string in the currently active dialog-box list. Must be called between `startlist and endlist. The semantics depend on the operation specified by startlist: append (operation 2), change (operation 1), or replace-after-clear (operation 3`).

Return Values

The added string on success; nil on failure.

Side Effects

Updates the contents of the active list-box or pop-up-list tile.

Examples

  • Initialise: 

    (setq llist '("first line" "second line" "third line"))
(start_list "longlist")
(mapcar 'add_list llist)
(end_list)

  • Modify the second list item: 

    (start_list "longlist" 1 0)
(add_list "2nd line")
(end_list)

Availability

  • AutoCAD 2026: documented.
  • BricsCAD V26: presumed compatible.
  • Status: AutoCAD documented; BricsCAD presumed-both pending Phase 4 verification.

Source Notes