Radio Button Control

This document covers the following topics:


Description

A radio button control is a selection item. You can logically group several radio button controls by assigning them a common GROUP-ID attribute. Out of this group, none or one may be selected by default. To pre-select a radio button control, you assign it a CHECKED attribute with a value of checked. Please note that only the radio button control checked last will remain checked; the one checked before will be unchecked automatically.

You use it, for example, to let the end user switch an option on or off, affecting the status of other radio button controls of the same group. A change in the state of a toggle button control, by contrast, will not affect the state of other toggle button controls in the same dialog.

Attributes for Radio Button Control

Attribute Name Query Set/Modify In Attr. Window
ACCELERATOR X X/X X
BACKGROUND-COLOUR-NAME X X/X X
BACKGROUND-COLOUR-VALUE X X/X X
CHECKED X X/X X
CLIENT-DATA X X/X  
CLIENT-HANDLE X X/X  
CLIENT-KEY X X/X  
CLIENT-VALUE X X/X  
CONTEXT-MENU X X/X X
DIL-TEXT X X/X X
ENABLED X X/X X
FIRST-CHILD X -/-  
FOLLOWS X X/X  
FONT-HANDLE X X/X X
FOREGROUND-COLOUR-NAME X X/X X
FOREGROUND-COLOUR-VALUE X X/X X
GROUP-ID X X/- X
HELP-ID X X/X X
LAST-CHILD X -/-  
MODIFIED X -/X  
MODIFIED-SUCCESSOR X -/-  
OWNER X X/-  
PARENT X X/-  
PREDECESSOR X -/-  
RECTANGLE-H X X/X X
RECTANGLE-W X X/X X
RECTANGLE-X X X/X X
RECTANGLE-Y X X/X X
RTL X -/- X
STRING X X/X X
SUCCESSOR X -/-  
SUPPRESS-CLICK-EVENT X X/X  
TOOLTIP X X/X  
TYPE X X/-  
VISIBLE X X/X X

Events

Click Event (may be suppressed).