Contents
- Index
Forms - Radiobutton
When one of a few options can be selected (options must be mutually exclusive). A GSAK boolean variable with the same name as this control is created and the value on form exit is True if this radio button is selected or False if not. Groupbox containers can be used to group like controls together, but should especially be used with radiobuttons. As only one radio button can be selected per container, this allows you to have multiple groups of radio buttons on a form
Supported properties
Caption - The caption (description) for this radiobutton. Clicking on this caption will also toggle the status of the radio button. The caption also supports a limited subset of HTML . For more information see this link
Caption Position - Left - Place the caption to the left of the check box. Right - place the caption to the right of the check box (The default is right)
Color - This is a number (Use "Macro=>Color picker" to select the corresponding color number (though the forms designer will automatically do this for you).
Container - The control that the radiobutton control "belongs" to. Every control has a container, and each control defaults to having the form as its container. Only a named Groupbox can be specified for the Container property (or blank to default to the form). When using the properties Top and Left, they are always relative to the control's container. Groupbox containers can be used to group like controls together. Note: You must always define the container before any controls that use this container.
Enabled - Yes, No. The enabled property set to "No" will automatically show the control in the "gray ghost" outline and prevent the user moving focus to it.
ExitOnChange - Yes, No. Setting this value to Yes will cause the form to exit immediately you click on the radiobutton. Use this option when you want to change something on the form (and then redisplay it) because the radiobutton value has changed.
Font - This font name for the caption
FontColor - The font color for the caption. This is a number (Use "Macro=>Color picker" to select the corresponding color number (though the forms designer will automatically do this for you).
FontSize - The font size for the caption
FontStyle - Allows you to specify the caption style. Supported styles are bold, italic, underline, strikeout. You can allocate any combination of these values to the style. Just separate each value with a ; (semi colon)
Height - Vertical height in pixels
Left - Position from the Left, which is the number of pixels relative to the container
Name - The radiobutton control name
TabOrder - The Taborder property applies to all controls than can receive input focus and regulates the order the controls will jump to when using tab on the keyboard. This means it doesn't matter what order the controls are defined in your code - the taborder property will decide your tabbing order. Taborder is a "smart" property. For example, if you set the value of a control to say 7, then any existing control that has a tab order of 7 will automatically be changed to 8, and all higher tab numbers will be incremented by one.
Also note that the tab order is relative to the container, so controls inside a group box have their own tabbing order starting at zero. The group box itself has a tabbing order within its container as well (usually the form) Don't be alarmed if you update your form and see taborder values starting at 8. The macro form has a few "hidden" controls that take up tab slots. You can actually use any number you like for the Taborder (even zero). You just need to remember that tabbing order is respected in an ascending numerical sequence
Top - Position from the top, which is the number of pixels relative to the container
Type - The control type, which must always be "Radiobutton"
Visible - Yes, No. If set to "No" then the button will not be visible on the form
Width - Horizontal length in pixels