list_box Tile (DCL)

A list box contains a list of text strings, arranged in rows.

Supported Platforms: Windows, Mac OS, and Web

Windows

: list_box {
   action alignment allow_accept fixed_height 
   fixed_width fixed_width_font height is_enabled 
   is_tab_stopkey label list mnemonic multiple_select
   tab_truncate tabs value width 
}

Mac OS and Web

: list_box {
   action alignment allow_accept fixed_height 
   fixed_width is_enabled key label 
   list multiple_select tabs value width 
}

Usually the list is of variable length, but list boxes can be used for fixed-length lists when a different kind of tile, such as a set of radio buttons, takes up too much space in the dialog box. When users select a row, it is highlighted. A list box can contain more rows than can fit in the box, so a scroll bar always appears to the right of the list box. (The scroll bar is enabled only if the list has more items than can appear at once.) By dragging the scroll bar cursor or clicking on its arrows, users can scroll through the list box items. Some applications may allow users to select multiple rows.