RADIO buttons, like check boxes, are used for selecting choices. A dot appears when a RADIO button is turned on or selected. The difference from check boxes is that the user can only select one RADIO button at a time. When a button is selected, the other buttons in the widget are turned off, as shown to the right. One RADIO button widget may contain any number of buttons.
RADIO
|
RADIO with new skin.
|
Receives focus
|
Yes
|
Skinnable
|
Yes
|
OwnerDraw
|
No
|
Uses Memory Devices
|
No
|
Attached widgets
|
None
|
Notification codes
The following events are sent from a RADIO widget to its parent window as part of a WM_NOTIFY_PARENT message:
Message |
Description
|
WM_NOTIFICATION_CLICKED
|
RADIO has been clicked.
|
WM_NOTIFICATION_RELEASED
|
RADIO has been released.
|
WM_NOTIFICATION_MOVED_OUT
|
RADIO has been clicked and pointer has been moved out of the RADIO widget without releasing.
|
WM_NOTIFICATION_VALUE_CHANGED
|
Value (selection) of the RADIO widget has changed.
|
Keyboard reaction
The BUTTON widget reacts to the following keys if it has the input focus:
Message |
Description
|
GUI_KEY_RIGHT
|
Increments the selection by 1.
|
GUI_KEY_DOWN
|
Increments the selection by 1.
|
GUI_KEY_LEFT
|
Decrements the selection by 1.
|
GUI_KEY_UP
|
Decrements the selection by 1.
|
Samples
Below are links to samples that demonstrate how to use RADIO widgets in emWin.