List Widget

 
________________________________________________________
LIST Widget
Provides a scrollable list of textual items
________________________________________________________
 
Legal Usage                Level-0 Widget:                Yes
                 Parent to:                None
                 Child of:                        PANEL
 
Example Image
 
     
 
Example Program
 
See LIST Widget for a program that provides a LIST widget similar to the display shown above.
 
NOTE
 
See the following program for another example using the LIST widget.
 
          Ice Cream Sundae
 
Attributes
 
See LIST Widget Attributes for the LIST widget attribute list.
 
Remarks
 
The LIST widget is similar to a COMBO widget except the LIST widget does not allow you to enter a string, but only to select from a list of items. A vertical scrollbar always appears in this widget. There is no horizontal scrollbar.
 
Events
 
Events for the LIST widget are:
 
·
SELECTION
·
SYSTEM
 
SELECTION
 
This event will be generated any time the user changes selections in the list. If the user clicks the mouse anywhere that is not a valid list item entry, a SELECTION event will be generated and -1 is returned for the SELECTION attribute.
 
SYSTEM MENU
 
This event is generated when the operator selects items from the SYSTEM MENU.