PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

  • Overview
  • Initializing the choice of a Radio Button control
  • Displaying a Radio Button control with no default option
  • Retrieving the option selected in a Radio Button control
  • Case of a Radio Button control that returns an integer
  • For a radio button that returns a value
  • Pre-filled SWITCH on the Radio Button controls
  • Modifying the caption of a Radio Button control
  • Case of Radio Button controls with sub-captions
  • Modifying the colors of the captions for the options found in a Radio Button control
  • Properties specific to the Radio Button controls
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
Overview
WINDEV, WEBDEV and WINDEV Mobile allow you to handle a Radio Button control by programming. To do so, use the variable of the Radio Button control in the code.
Regardless of the type of radio button, each option can be associated with:
  • an integer. This integer can take a value from 1 to N, N being the total number of options found in the radio button. The first option is the option #1, the second option is the option #2, ... The options are numbered from top to bottom and from left to right.
  • WINDEVWindows MobileUniversal Windows 10 App a specific returned value . This returned value is specified in the "Content" tab of the description window of the control.
WINDEVWindows MobileUniversal Windows 10 App Using the numbering or the returned values?
The method for programming the radio buttons that return an integer differs from the method for programming the radio buttons that return a value. The benefit of using returned values is visible when inserting or moving an option in the radio button:
  • If the radio button returns an integer, inserting or moving an option in the radio button forces you to revise the entire code for managing the value of the radio button (to manage the change in the numbers).
  • If the radio button returns a specific value, inserting an option into the radio button only requires to take the new option into account. Moving an option requires no modification.
Versions 18 and later
WINDEViPhone/iPad Note: Several WLanguage functions are used to add, insert or delete options in a Radio Button control. See Functions for managing the Radio Button controls for more details.
New in version 18
WINDEViPhone/iPad Note: Several WLanguage functions are used to add, insert or delete options in a Radio Button control. See Functions for managing the Radio Button controls for more details.
WINDEViPhone/iPad Note: Several WLanguage functions are used to add, insert or delete options in a Radio Button control. See Functions for managing the Radio Button controls for more details.
WINDEVAndroidiPhone/iPad Note: Several WLanguage functions are used to add, insert or delete options in a Radio Button control. See Functions for managing the Radio Button controls for more details.
Initializing the choice of a Radio Button control
By default, the first option is selected when a Radio Button control is displayed.
To check an option of a Radio Button control:
  • if the Radio Button control returns an integer, use the following syntax:
    <Name of Radio Button> = <Option Subscript>
  • if the Radio Button control returns a specific value (in WINDEV or WINDEV Mobile only), use the following syntax:
    <Name of Radio Button> = <Option Value>
The selection of an option unchecks the option that is currently selected.
Note: If the control is associated with a data file item, the assignment is automatically performed by using:
See Linking a Radio Button control to an item for more details.
WINDEVWEBDEV - Server codeAndroidiPhone/iPadWindows MobileUniversal Windows 10 AppJava

Displaying a Radio Button control with no default option

A Radio Button control is always positioned on a position (1 by default).
To display a Radio Button control with no default option, all you have to do is assign the initial value of the control to:
  • -1 for a Radio Button control that returns an integer,
  • "" (empty string) for a Radio Button control that returns a value.
Note: A Radio Button control with no default value cannot be accessed by TAB.
Example:
// Display the radio button without initial value
RADIO_MyRadioButton = -1
// or RADIO_MyRadioButton = ""
Retrieving the option selected in a Radio Button control

Case of a Radio Button control that returns an integer

To retrieve the subscript of the option selected in the Radio Button control, use the following syntax:
<Option Subscript> = <Name of Radio Button>
In this case, the <Option Subscript> parameter is an integer corresponding to the number of the selected option.
To find out the caption of the option selected in the Radio Button control, use the following syntax:
<Option Caption> = <Name of Radio Button>[Name of Radio Button]..Caption
Note: If the control is associated with a data file item, the entered value is automatically retrieved by using:
See Linking a Radio Button control to an item for more details.
WINDEVWindows MobileUniversal Windows 10 App

For a radio button that returns a value

To retrieve the value of the option selected in the radio button, use the following syntax:
<Option Value> = <Name of Radio Button>
In this case, the <Option Value> parameter is a character string corresponding to the returned value of the selected option.
Note: ..ReturnedValue is also used to find out and modify the value returned by each option of the Radio Button control.
To retrieve the subscript of the selected option, a specific process must be performed. Example:
// Value returned by the selected option
Result1 = RADIO_TodaysDish
// Find the subscript of the selected option
Subscript is int
I is int
FOR I = 1 _TO_ RADIO_TodaysDish..Occurrence
        IF RADIO_TodaysDish[I]..ReturnedValue = Result1 THEN Subscript = I
END
To find out the caption of the option selected in the radio button, use the following syntax:
<Option Caption> = <Name of Radio Button>[Option Subscript]..Caption
Note: If the control is associated with a data file item, the entered value is automatically retrieved by using:
See Linking a Radio Button control to an item for more details.
Versions 18 and later

Pre-filled SWITCH on the Radio Button controls

When typing the SWITCH statement relative to a Radio Button control, the code editor automatically adds the CASE corresponding to the different options of the radio button. The caption of each option is automatically added in line comment.
Some examples:
  • Code for a radio button that returns an integer: typing "SWITCH RADIO_Title" in the code editor displays:
    Code for a radio button that returns an integer
  • Code for a radio button that returns a value: typing "SWITCH RADIO_TodaysMenu" in the code editor displays:
    Code for a radio button that returns a value
New in version 18

Pre-filled SWITCH on the Radio Button controls

When typing the SWITCH statement relative to a Radio Button control, the code editor automatically adds the CASE corresponding to the different options of the radio button. The caption of each option is automatically added in line comment.
Some examples:
  • Code for a radio button that returns an integer: typing "SWITCH RADIO_Title" in the code editor displays:
    Code for a radio button that returns an integer
  • Code for a radio button that returns a value: typing "SWITCH RADIO_TodaysMenu" in the code editor displays:
    Code for a radio button that returns a value

Pre-filled SWITCH on the Radio Button controls

When typing the SWITCH statement relative to a Radio Button control, the code editor automatically adds the CASE corresponding to the different options of the radio button. The caption of each option is automatically added in line comment.
Some examples:
  • Code for a radio button that returns an integer: typing "SWITCH RADIO_Title" in the code editor displays:
    Code for a radio button that returns an integer
  • Code for a radio button that returns a value: typing "SWITCH RADIO_TodaysMenu" in the code editor displays:
    Code for a radio button that returns a value
Modifying the caption of a Radio Button control
..Caption is used to:
  • change the caption of the Radio Button control:
    <Name of Radio Button>..Caption = <Caption>
  • change the caption of all the options found in the Radio Button control:
    The options must be separated by the TAB character.
    You have the ability to specify the first options only.
    <Name of Radio Button>..Caption = <Option 1>+TAB+<Option 2>+TAB+<Option 3>...
  • retrieve and modify the caption of an option:
    // Retrieve the sub-caption
    <Sub-caption> = <Name of radio button>[<Option subscript>]..SubCaption

    // Modify the sub-caption
    <Name of radio button>[<Option subscript>]..SubCaption = <New sub-caption>
WINDEViPhone/iPadWindows MobileUniversal Windows 10 App

Case of Radio Button controls with sub-captions

..SubCaption is also used to find out and modify the sub-captions of the options found in the Radio Button control.
// Retrieve the sub-caption
<Sub-caption> = <Name of radio button>[<Option subscript>]..SubCaption

// Modify the sub-caption
<Name of radio button>[<Option subscript>]..SubCaption = <New sub-caption>
Modifying the colors of the captions for the options found in a Radio Button control
WINDEVWindows MobileJava To modify the colors of the captions for the options found in a Radio Button control, you have the ability to use the following syntax:
<Control Name>..Caption = gPen(<Color of Option 1>) + ...
<Caption of Option 1> + TAB + ...
gPen(<Color of Option N>) + <Caption of Option N>
<Color of Option> corresponds to:
Properties specific to the Radio Button controls
The following properties are used to manage the characteristics of a Radio Button control by programming.
HorizontalAlignmentUsed to find out and modify the horizontal alignment of a control.
VerticalAlignmentUsed to find out and modify the vertical alignment of a control.
ColorUsed to find out and modify the color of the text for the options found in the Radio Button control.
BrushColorUsed to find out and modify the background color of the Radio Button control.
NumberColumnUsed to find out the number of columns in a Radio Button control.
OccurrenceUsed to find out the number of options in a Radio Button control.
SubCaptionUsed to find out and modify the sub-caption of an option found in a Radio Button control.
InitialValueUsed to find out the initial value of a Radio Button control.
ReturnedValueUsed to find out and modify the value returned by an option found in a Radio Button control.
To find out the entire list of WLanguage properties that can be used with a Radio Button control, see Properties associated with a Radio Button control.
Minimum required version
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment