ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

This content has been translated automatically.  Click here  to view the French version.
Help / Developing an application or website / Controls, windows and pages / Controls: Available types / Check Box control
  • Overview of the Check Box control
  • Check Box control in a window or page
  • Creating a Check Box control
  • Display modes available
  • Limitations in Android and iOS
  • Check Box control in a report
  • Using a Check Box control
  • Check Box in a Table control
  • Check Box control and data binding
  • Permuter
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
Others
Stored procedures
Overview of the Check Box control
A Check Box control can correspond to:
  • a control allowing the user to answer a question with Yes or No in a window or page.
  • a column of a Table control allowing the user to select one or more rows.
  • a checkbox displayed in a report.
  • an interactive checkbox displayed in a form report.
Check Box control in a window or page
In the window or page editor, a Check Box control allows the user to answer a question with 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. Users select the desired options. For each option, the check box returns the option status.
Example:
Example of a check box

Creating a Check Box control

To create a Check Box control:
  1. On the "Creation" tab, in the "Usual controls" group, click "Check Box".
  2. Click where the control will be created in the window or page. The control appears in the editor.
Tip: It is also possible to directly create a "pre-formatted" Check Box control by scrolling down "Check Box control".. The list of available controls is displayed with the project skin template. Simply click the control you want to create in the editor.
This list proposes to create Switch controls. For more details, see Switch control.
To view the characteristics of the control, select "Description" in the context menu.
iPhone/iPad

Display modes available

WINDEV and WINDEV Mobile feature different types of Check Box controls:
  • standard check box,
  • standard check box with sub-captions,
  • image switches (with the possibility of using one image on each option),
  • image switch with underline (with possibility of using one image on each option).
The different tabs of the description window allow you to configure the control:
  • The display mode of the Check Box control can be selected in the "General" tab of the control description.
  • The "Detail" tab allows you to:
    • Set up a three-state switch,
    • Set Check Box control options,
    • Setting the picture mode:
      • Size of image area and number of image states.
      • Selection banner display options.
  • The "Content" tab allows you to enter the characteristics specific to the display mode (image, underline, line height, etc.) in the different languages of the application.. These elements can be modified programmatically.
  • The "Style" tab is used to define some characteristics specific to the display mode. It is possible to define:
    • the spacing between the caption and the sub-caption ("Sub-caption of options" element).
    • the position of the options text: top, bottom, ... ("Option Text" element).
    • tick position: top, bottom, ... ("Tick frame" element).
The programming mode can change according to the type of display. For more details, see Handling a check box programmatically.
AndroidiPhone/iPad For iPhone/iPad and Android applications, you can 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 control description window.
AndroidiPhone/iPad

Limitations in Android and iOS

Only images are supported for option checkmarks. If no image is specified, the system image is used. The elements "Checkmark" and "Checkmark border", in the style tab of the Check Box controls, are ignored.
Check Box control in a report
iPhone/iPad 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 field value is Faux, the box is unchecked:
Two types of Check Box controls are available in the report editor:
  • Standard Check Box control, which is simply displayed in the report.
  • Interactive Check Box control, that can be selected / cleared by the user. This control can be used in:
    • the generated PDF files.
To create a Check Box control:
  • Method 1: Default creation of a classic Check Box control:
    1. On the "Creation" tab, in the "Visual" group, click "Check Box".
    2. Click where you want to create the control. The control appears in the editor.
  • Method 2: Default creation of an editable Check Box control:
    1. On the "Creation" tab, in the "Interactions" group, click "Check Box".
    2. Click where you want to create the control. The control appears in the editor.
To view the characteristics of the control, select "Description" in the context menu.
Note: It is possible to change the type of a Check Box control directly:
  1. Open the control description window.
  2. On the "UI" tab, select or deselect "Interactive (form reports)".
  3. Confirm.
iPhone/iPad

Using a Check Box control

The Wingdings font must be installed on end users' computers so that the Check Box control is displayed properly.
Check Box in a Table control
Check Box control and data binding
Check Box controls can use data binding under the following conditions:
  • if the Check Box control has a single option, it must be linked to a simple variable
  • if the Check Box control has several options, it must be linked to an array.
If this condition is not respected, a UI error will be generated.
Permuter
WINDEV, WINDEV Mobile and WEBDEV allow you to automatically transform a Check Box control into a Radio Button control and vice versa:
  1. Select the control to transform in the window or page.
  2. On the "Modification", 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 version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 09/19/2024

Send a report | Local help