RadioButton control
A RadioButton is a small round button that is used to turn an option
on and off. When the option is on, the button has a dark center. When the
option is off, the center is blank.
In a GroupBox
RadioButtons are often grouped in a GroupBox. In this case, the
user can select only one button in the group, and the group usually has
a default button.
Properties
|
RadioButton property |
Datatype |
Description |
|---|---|---|
|
String |
A description of the control and/or its purpose for |
|
|
String |
A label that briefly describes the control, such as |
|
|
AccessibleRole (enumerated) |
Describes what kind of user interface element the |
|
|
Boolean |
Specifies whether the control becomes dark when it TRUE — Control becomes dark FALSE — Control does not become dark |
|
|
Long |
Specifies the numeric value of the background |
|
|
BorderStyle (enumerated) |
Specifies the style of the border of the control. StyleLowered! StyleRaised! |
|
|
Boolean |
Specifies whether PowerBuilder moves the control to TRUE — Control moved to top. FALSE |
|
|
Boolean |
Specifies whether the item is selected (the center TRUE — Control is FALSE — Control is not |
|
|
ClassDefinition |
PowerObject |
An object of type PowerObject containing |
|
Boolean |
Specifies whether PowerBuilder puts the control TRUE — FALSE — When the control is clicked, the |
|
|
String |
Specifies the name of the stock icon or the file When the user drags the control, the |
|
|
Boolean |
Specifies whether the control is enabled (can be TRUE — Control is FALSE — Control is not |
|
|
String |
Specifies the name of the typeface in which the |
|
|
FontCharSet (enumerated) |
Specifies the font character set used for the text |
|
|
FontFamily (enumerated) |
Specifies the font family (type style) used for the AnyFont! Decorative! Modern! Roman! Script! Swiss! |
|
|
FontPitch (enumerated) |
Specifies the pitch (spacing) of the font used for Default! Fixed! Variable! |
|
|
Integer |
Specifies the height of the control, in |
|
|
Boolean |
Specifies whether the text in the control is TRUE — Text is FALSE — Text is not italic. |
|
|
Boolean |
Specifies whether the text displays to the left of TRUE — Text displays to FALSE — Text does not display to the |
|
|
String |
Specifies the name of the stock pointer or the file |
|
|
Boolean |
Specifies that characters should be displayed in TRUE — Characters display in right-to-left FALSE — Characters display in left-to-right |
|
|
Integer |
Specifies the tab value of the control (0 means the To permit tabbing in a GroupBox, change |
|
|
String |
Specifies the tag value assigned to the |
|
|
String |
Specifies the text that displays next to the |
|
|
Long |
Specifies the numeric value of the color used for |
|
|
Integer |
Specifies the size of the text in the control, in |
|
|
Boolean |
Specifies whether the text in the control is TRUE — Text is FALSE — Text is not |
|
|
Boolean |
Specifies whether the control is visible. Values TRUE — Control is visible. FALSE |
|
|
Integer |
Specifies the stroke weight of the text in the |
|
|
Integer |
Specifies the width of the control, in PowerBuilder |
|
|
Integer |
Specifies the X position (the distance from the |
|
|
Integer |
Specifies the Y position (the distance from the top |
Events
|
RadioButton event |
Occurs |
|---|---|
|
When the control is clicked (selected or |
|
|
Immediately before the Open event occurs in the |
|
|
Immediately after the Close event occurs in the |
|
|
When a dragged control is dropped on the |
|
|
When a dragged control enters the |
|
|
When a dragged control leaves the |
|
|
When a dragged control is within the |
|
|
Just before the control receives focus (before it |
|
|
When the user presses the F1 key or drags the |
|
|
When the control loses focus (becomes |
|
|
When a Windows message occurs that is not a |
|
|
When the right mouse button is pressed on the |
Functions
|
RadioButton function |
Datatype returned |
Description |
|---|---|---|
|
String |
Returns the name assigned to the |
|
|
Integer |
Starts or ends the dragging of the |
|
|
Integer |
Creates a reference to a context-specific instance |
|
|
PowerObject |
Returns a reference to the name of the parent |
|
|
Integer |
Makes the control invisible |
|
|
Integer |
Moves the control to a specified |
|
|
Integer |
Returns the distance of the pointer from the left |
|
|
Integer |
Returns the distance of the pointer from the top of |
|
|
Boolean |
Adds an event to the end of the message queue for |
|
|
Integer |
Prints the control |
|
|
Integer |
Changes the size of the control |
|
|
Integer |
Sets focus to the control |
|
|
Integer |
Specifies the position of the control in the |
|
|
Integer |
Controls automatic redrawing of the control after |
|
|
Integer |
Makes the control visible |
|
|
Integer |
Triggers a specified event for the control and |
|
|
Object |
Returns the type of the control |