LISTBOX widgets are used to select one element of a list. A list box can be created without a surrounding frame window, or as a child window of a FRAMEWIN widget. As items in a list box are selected, they appear highlighted. Note that the background color of a selected item depends on
whether the list box window has input focus.
| LISTBOX
|
|
|
| Receives focus
|
Yes
|
| Skinnable
|
No
|
| OwnerDraw
|
Yes
|
| Uses Memory Devices
|
No
|
| Attached widgets
|
|
Notification codes
The following events are sent from a LISTBOX widget to its parent window as part of a WM_NOTIFY_PARENT message:
| Message |
Description
|
| WM_NOTIFICATION_CLICKED
|
LISTBOX has been clicked.
|
| WM_NOTIFICATION_RELEASED
|
LISTBOX has been released.
|
| WM_NOTIFICATION_MOVED_OUT
|
LISTBOX has been clicked and pointer has been moved out of the LISTBOX widget without releasing.
|
| WM_NOTIFICATION_SCROLL_CHANGED
|
The scroll position of the optional scroll bar has been changed.
|
| WM_NOTIFICATION_SEL_CHANGED
|
The selection of the LISTBOX widget has changed.
|
Keyboard reaction
The LISTBOX widget reacts to the following keys if it has the input focus:
| Message |
Description
|
| GUI_KEY_SPACE
|
If the widget works in multi selection mode this key toggles the state of the current selected item.
|
| GUI_KEY_RIGHT
|
If the maximum X-size of the list box items is larger than the list box itself this key scrolls the list box content to the left.
|
| GUI_KEY_LEFT
|
If the maximum X-size of the list box items is larger than the list box itself this key scrolls the list box content to the right.
|
| GUI_KEY_DOWN
|
Moves the selection bar down.
|
| GUI_KEY_UP
|
Moves the selection bar up.
|
Samples
Below are links to samples that demonstrate how to use BUTTON widgets in emWin.
