The listbox object allows you to display a list of items on the page or dialog in a scrollable area. For example, you could display a list of song titles (so the user could choose a song to play), or a list of topics (so the user could decide what topic to view next).
Each list item consists of a single line of text, and an optional string of internal data that can be associated with the item. The item text is the visible part; it's what shows up in the list, and it's what the user will see as the item. The item data is an optional invisible part; it doesn't show up in the list, and is only visible when performing actions on the object. Using the listbox object's built-in features, the implementation of a document browser is made easy. For example, the item text could be the title of the document while it's associated item data could be the full path to the file to open. The listbox object can also be shown as a checklistbox, where each item in the list contains a checkbox.
The listbox object has an extensive action set so you can load and manipulate listbox items at run time for full flexibility.
The object also contains a series of visible properties that can be controlled. Some of these settings include color, font, scroll bars, border and tooltips.
Note: Keyboard-friendly users can access listbox objects at run time by using the Tab and Shift+Tab keys to cycle through the tab order.
Tip: You can add a listbox object by choosing Object > Listbox from the menu.