Class XbpListBox() Foundation
Class function of the XbpListBox class.
The XbpListBox class provides the listbox dialog element. Listboxes display a finite number of values as a list (similar to Achoice()). Each list item is a character string and is individually added to the list using the :addItem() method. If there are more items in the list than can be shown in the display window of the listbox, a vertical scroll bar allows navigation through the list. Listboxes can also include an optional horizontal scroll bar. The maximum number of items that can be managed by an XbpListBox object is limited to 32 kB under Windows 95 and OS/2, while it is not limited under Windows NT.
There are three modes for marking and selecting items from the list: single selection mode, multiple selection mode and extended selection mode. The multiple selection mode allows several items to be marked in the list at one time. In the extended mode items can be marked using the mouse or special key combinations. Listboxes process some keys and events differently depending on the selection mode. The following table lists the keys processed in "single selection" mode:
Key | Description |
---|---|
Up Arrow | Go to previous item |
Down Arrow | Go to next item |
Home | Go to beginning of list |
End | Go to end of list |
Page Up | Go up one page |
Page Down | Go down one page |
Return | Select current item |
Letter | Go to next item starting with this letter |
Left mouse click | Mark item, unmark previous |
Double click left | Mark item and select |
Left Arrow *) | Scroll four characters to the left |
Right Arrow *) | Scroll four characters to the right |
Ctrl+Page Up *) | Scroll one page to the left |
Ctrl+Page Down *) | Scroll one page to the right |
|
In "multiple selection" mode the selection is turned on or off when an item is clicked or by pressing the space bar.
The special keys Shift and Ctrl are supported in the "extended selection" mode. In addition, items are marked when the mouse is moved while the left button is pressed.
Key | Description |
---|---|
Shift+Up Arrow | Go to previous item and toggle the marking |
Shift+Down Arrow | Go to next item and toggle the marking |
Shift+Home | Go to beginning of list and toggle the marking of all items before the current item |
Shift+End | Go to end of list and toggle the marking of all items after the current item |
Shift+Page Up | Go one page up and toggle the marking |
Shift+Page Down | Go one page down and toggle the marking |
Return | Select all marked items |
Shift+Letter | Go to next item that begins with this letter |
Shift+Blank space | Mark items after pressing a letter |
Shift+Left mouse click | Toggle marking from current item to clicked item |
Ctrl+Left mouse click | Toggle marking only for the clicked item |
Shift+Left Double click | Select all marked items |
The instance variables in this group configure system resources. If changes are made to these values, they must either be made before the :create() method is executed or the :configure() method must be used to activate the changes.
If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.