ICONVIEW

From SEGGER Wiki
Jump to: navigation, search

The ICONVIEW widget can be used for icon based menus often required in hand held devices like mobile telephones or pocket organizers. It shows a list of icons where each icon can be labeled with optional text. Icon view widgets support transparency and alpha blending, so any content can be shown in the background. The currently selected icon can be highlighted by a solid color or with an alpha blending effect, which lets the background shine through.

ICONVIEW
Iconview.png
Receives focus Yes
Skinnable No
OwnerDraw Yes
Uses Memory Devices No
Attached widgets

Notification codes

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

Message Description
WM_NOTIFICATION_CLICKED ICONVIEW has been clicked.
WM_NOTIFICATION_RELEASED ICONVIEW has been released.
WM_NOTIFICATION_MOVED_OUT ICONVIEW has been clicked and pointer has been moved out of the ICONVIEW 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 widget has been changed.

Keyboard reaction

The ICONVIEW widget reacts to the following keys if it has the input focus:

Message Description
GUI_KEY_RIGHT Moves the selection to the next icon.
GUI_KEY_LEFT Moves the selection to the previous icon.
GUI_KEY_DOWN Moves the selection down.
GUI_KEY_UP Moves the selection up.
GUI_KEY_HOME Moves the selection to the first icon.
GUI_KEY_END Moves the selection to the last icon.

Samples

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