: list_box


Display a vertical list of text, with optional scrollbar and title.     DCL Active Tile


This active tile displays a list box. When the user selects an item, it is highlighted. A scroll bar appears automatically when there are more items than the list_box tile is able to display.

Creating and Modifying a List Box with LISP Functions

To create and modify the list displayed by the list_box tile, use these LISP functions:

int1 Meaning
1 Change one item in the list.
2 Add an item to the end of the list.
3 Create a new list; the default.

NOTE There are no LISP functions for inserting an item in the middle of the list nor for deleting an item from the list.

Valid Attributes

: list_box {

          action = "(string)";

          allow_accept = flag;

          alignment = position;

          fixed_height = flag;

          fixed_width = flag;

          height = number;

          is_enabled = flag;

          is_tab_stop = flag;

          key = "string";

          label = "string";

          list = "string";

          mnemonic = "char";

          multiple_select = flag;

          tabs = "string";

          value = "string";

          width = number;

}

Example

: list_box {

          action = "(subdir)";

          label = "Select a color:";

          list = "Red\nGreen\nBlue";

          value = "0";

     }

NOTE

Related DCL Tiles

button

edit_box

image_button

popup_list

radio_button

slider

toggle

Tell me about...

Programming Overview of DCL (Dialog Control Language)

About Predefined Attributes