PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

  • Overview of Check Box control
  • Check Box control in a window or in a page
  • Creating a Check Box control
  • Available display modes
  • Three-state check box
  • Limits in Java
  • Check Box control in a report
  • Using a Check Box control
  • Check box in a Table control
  • "Check box" column in a Table control
  • Check box and databinding
  • Swap
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 of Check Box control
A check box can correspond to:
  • a control allowing the user to answer a question by yes or no in a window or in a page.
  • a column of a Table control allowing the user to select one or more rows in a Table control.
  • a box to check in a report.
Versions 15 and later
Android The Check Box controls are now available for the Android applications.
New in version 15
Android The Check Box controls are now available for the Android applications.
Android The Check Box controls are now available for the Android applications.
Versions 16 and later
Universal Windows 10 App The Check Box controls are now available for the Windows Phone applications.
WINDEVLinux The Check Box controls are now available for the WINDEV applications in Linux.
New in version 16
Universal Windows 10 App The Check Box controls are now available for the Windows Phone applications.
WINDEVLinux The Check Box controls are now available for the WINDEV applications in Linux.
Universal Windows 10 App The Check Box controls are now available for the Windows Phone applications.
WINDEVLinux The Check Box controls are now available for the WINDEV applications in Linux.
Versions 17 and later
iPhone/iPad The Check Box controls are now available for the iPhone/iPad applications.
New in version 17
iPhone/iPad The Check Box controls are now available for the iPhone/iPad applications.
iPhone/iPad The Check Box controls are now available for the iPhone/iPad applications.
Versions 18 and later
iPhone/iPad This type of control is now available for the reports in the iPhone/iPad applications.
Universal Windows 10 App This type of control is now available for the applications in Windows Store apps mode.
New in version 18
iPhone/iPad This type of control is now available for the reports in the iPhone/iPad applications.
Universal Windows 10 App This type of control is now available for the applications in Windows Store apps mode.
iPhone/iPad This type of control is now available for the reports in the iPhone/iPad applications.
Universal Windows 10 App This type of control is now available for the applications in Windows Store apps mode.
Versions 21 and later
Universal Windows 10 App The Check Box controls are now available in Universal Windows 10 App mode.
New in version 21
Universal Windows 10 App The Check Box controls are now available in Universal Windows 10 App mode.
Universal Windows 10 App The Check Box controls are now available in Universal Windows 10 App mode.
Check Box control in a window or in a page
In the window editor or in the page editor, the Check Box control is a control allowing the user to answer a question by yes or no:
  • if the option is checked, the option is set to True.
  • if the option is unchecked, the option is set to False.
A check box can display up to 256 options. The users selects the requested options. For each option, the check box returns the option status.
Example:

Creating a Check Box control

To create a Check Box control:
  1. In the window or page editor, click (or select "Insert .. Control .. Check box").On the "Creation" pane, in the "Usual controls" group, click "Check box".
  2. Click the position where the control will be created in the window or page. The control appears in creation mode.
WINDEVWINDEV Mobile Tip: You also have the ability to create a "preset" check box by clicking the arrow found on the right of icon. The list of available controls (with their preview in the skin template of project) is displayed. All you have to do is click the requested control to create it in the editor.
WINDEVWINDEV Mobile Tip: You also have the ability to create a "preset" check box by expanding "Check box". The list of available controls (with their preview in the skin template of project) is displayed. All you have to do is click the requested control to create it in the editor.
To display the control characteristics, select "Description" from the popup menu of control.
WINDEV Note: You have the ability to manage a general tooltip for the control or a tooltip for each one of the control options ("Help" tab).
WindowsLinuxiPhone/iPadWindows MobileUniversal Windows 10 App

Available display modes

WINDEV and WINDEV Mobile propose different display modes for the check boxes:
  • standard check box,
  • standard check box with sub-captions,
  • check box in Vista style (ability to use an image for each option),
  • check box in Vista style with sub-captions (ability to use an image for each option).
LinuxUniversal Windows 10 App The check boxes in Vista style are not available.
The different tabs in the description window are used to configure the control:
  • The display mode of the check box is selected in the "General" tab of control description.
  • The "Content" tab is used to enter the characteristics specific to the display mode (image, sub-caption, row height, ...) in the different application languages. These elements can be modified by programming.
  • The "Style" tab is used to define some characteristics specific to the display mode. You also have the ability to define:
    • Versions 16 and later
      the spacing between the caption and the sub-caption ("Sub-caption of options" element).
      New in version 16
      the spacing between the caption and the sub-caption ("Sub-caption of options" element).
      the spacing between the caption and the sub-caption ("Sub-caption of options" element).
    • the position of text of options: at the top, at the bottom, ... ("Text of options" element).
    • Versions 18 and later
      the checkmark position: at the top, at the bottom, ... ("Checkmark border" element).
      New in version 18
      the checkmark position: at the top, at the bottom, ... ("Checkmark border" element).
      the checkmark position: at the top, at the bottom, ... ("Checkmark border" element).
The programming mode can change according to the type of display. See Handling a check box by programming for more details.
Versions 17 and later
iPhone/iPad For the iPhone and iPad applications, you have the ability to create:
  • standard check boxes with sub-captions.
  • native check boxes. In this case, the check box will use the iOS style. To get a native check box, check "Native check box (iOS)" in the "Details" tab of the description window of control.
New in version 17
iPhone/iPad For the iPhone and iPad applications, you have the ability to create:
  • standard check boxes with sub-captions.
  • native check boxes. In this case, the check box will use the iOS style. To get a native check box, check "Native check box (iOS)" in the "Details" tab of the description window of control.
iPhone/iPad For the iPhone and iPad applications, you have the ability to create:
  • standard check boxes with sub-captions.
  • native check boxes. In this case, the check box will use the iOS style. To get a native check box, check "Native check box (iOS)" in the "Details" tab of the description window of control.
AndroidiPhone/iPad For the iPhone/iPad applications and for the Android applications, you have the ability to create:
  • standard check boxes.
  • iPhone/iPad standard check boxes with sub-captions.
  • native check boxes. In this case, the check box will use the iOS or Android style. To get a native check box, check "Native check box" in the "Details" tab of the description window of control.
Versions 21 and later
Android The native Check Box controls are now available for the Android applications.
New in version 21
Android The native Check Box controls are now available for the Android applications.
Android The native Check Box controls are now available for the Android applications.
WindowsLinuxWindows MobileUniversal Windows 10 App

Three-state check box

In the window editor, three states can be managed for the options of the Check Box controls.
At run time, clicking an unchecked option will check the option and a second click on this option will give it an undefined value. In this case, the option returns -1.
In order for your check box to support the three-state options:
  • check the corresponding option in the "Details" tab of the description window of Check Box control. All the options of the check box will support the three states.
  • by programming, use ..TriState on one of the options found in the check box. This option will support the three states.
Java

Limits in Java

The following characteristics are not supported in Java:
  • three-state check box.
  • proportional columns (if the options of the check box are displayed in several columns).
  • multiline captions for the options of check box
  • text of the options found in the check box with formatting (R. T. F.).
  • help number associated with each option of check box.
  • different display modes of check box. Only the standard check box is available.
Check Box control in a report
WINDEVWEBDEV - Server codeiPhone/iPadWindows Mobile In the report editor, the Check Box control corresponds to a box to check:
  • If the control value is set to True, the box is checked:
  • If the control value is set to False, the box is unchecked:
To create a Check Box control:
  1. In the report editor, click .On the "Creation" pane, in the "Usual controls" group, click "Check box".On the "Creation" pane, in the "Visual" group, click "Check box".
  2. Click the position where the control will be created in the report. The control appears in creation mode.
To display the control characteristics, select "Description" from the popup menu of control.
WINDEVWEBDEV - Server codeiPhone/iPadWindows Mobile

Using a Check Box control

In order for the Check Box control to be displayed properly on the end-user computers, the Wingdings font must be installed on their computers.
Check box in a Table control
WINDEVWEBDEV - Server codeWindows MobileJava

"Check box" column in a Table control

To allow the check box to be checked (or not) when clicking the "Check box" column:
  1. The Table control must be in edit.
  2. The "Check box" column must be in edit.
  3. All other columns of Table control must be read-only.
Using a Check Box column in a table:
The following behavior can occur when using a Check Box column in a browsing Table control:
  • The check boxes of visible rows are checked.
  • The checkmarks are lost whenever the scrollbar moves.
This behavior indicates that the check box is not linked to a file item.
To manage a check box in a Table control, you must:
  • create a suitable item (whose type is check box for example) in your data file. In this case, this item can be managed in a browsing Table control.
  • create a memory Table control.
Check box and databinding
Versions 15 and later
The databinding is available for the Check Box controls under the following conditions:
  • if the check box has a single option, it must be linked to a simple variable.
  • if the check box has several options, it must be linked to an array.
If this condition is not respected, a GUI error will be generated.
New in version 15
The databinding is available for the Check Box controls under the following conditions:
  • if the check box has a single option, it must be linked to a simple variable.
  • if the check box has several options, it must be linked to an array.
If this condition is not respected, a GUI error will be generated.
The databinding is available for the Check Box controls under the following conditions:
  • if the check box has a single option, it must be linked to a simple variable.
  • if the check box has several options, it must be linked to an array.
If this condition is not respected, a GUI error will be generated.
Swap
WINDEV, WINDEV Mobile and WEBDEV allow you to automatically transform a Check Box control into a Radio Button control (and conversely). To do so, select the control to transform and select "Control .. Swap .. Radio button/Check box".WINDEV, WINDEV Mobile and WEBDEV allow you to automatically transform a Check Box control into a Radio Button control (and conversely):
  1. Select the control to transform.
  2. On the "Modification" pane, in the "Transformations" group, expand "Refactoring and swapping" and select "Radio button/Check box".
Related Examples:
The Check Box control Unit examples (WINDEV): The Check Box control
[ + ] Using a check box control.
Minimum required version
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment