LISTWHEEL

From SEGGER Wiki
Jump to: navigation, search

This widget is similar to the LISTBOX widget. Whereas the data of a LISTBOX is selected by moving the cursor with the keyboard or by using a SCROLLBAR, the LISTWHEEL works completely different: The whole data area can be moved via a pointer input device (PID). Striking over the widget from top to bottom or vice versa moves the data up or downwards. When releasing the PID after moving the data area, it slows down its motion and stops by snapping in a new item at the snap position. Furthermore, the data is shown in a loop. This means, the data can be 'rotated' like a wheel.

LISTWHEEL
Listwheel.png
Receives focus No
Skinnable No
OwnerDraw Yes
Uses Memory Devices No
Attached widgets None

Notification codes

The following events are sent from a LISTWHEEL widget to its parent window as part of a WM_NOTIFY_PARENT message:

Message Description
WM_NOTIFICATION_CLICKED LISTWHEEL has been clicked.
WM_NOTIFICATION_RELEASED LISTWHEEL has been released.
WM_NOTIFICATION_MOVED_OUT LISTWHEEL has been clicked and pointer has been moved out of the LISTWHEEL widget without releasing.
WM_NOTIFICATION_SEL_CHANGED An item has been snapped at the snap position.

Keyboard reaction

The widget can not gain the input focus and does not react on keyboard input.

Samples

Below are links to samples that demonstrate how to use BUTTON widgets in emWin.