ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

New WINDEV and WINDEV Mobile 2025 feature!
Help / Developing an application or website / Controls, windows and pages / Controls: Available types / Segmented Button control
  • Segmented Button control overview
  • Creating a Segmented Button control
  • Characteristics of Segmented Button controls
  • Description window
  • Check Box and Radio Button modes
  • Automatic Application Features (AAF) associated with the control
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
Others
Stored procedures
Segmented Button control overview
The Segmented Button control can be understood as a set of ON/OFF buttons grouped together in a single control. By default, this control uses a cohesive design language.
This control features two intuitive modes: single choice (radio button) or multiple choice (check box).
The content of each choice can be a text or an image.
Creating a Segmented Button control
To create a Segmented Button control:
  1. On the "Creation" tab, in the "Usual controls" group, click "Segmented Button".
  2. Click at the desired location to create the control. The control appears in the editor.
To view the control characteristics, select "Description" in the context menu.
Characteristics of Segmented Button controls

Description window

You can can specify the main characteristics of the Segmented Button control in the "General" tab of the description window:
  • Mode: This option defines how the Segmented Button control can be used. You can allow one of the following:
    • single choice (Radio Button mode).
    • multiple choice (Check Box mode).
  • Options: Each segment of the control corresponds to an option. For each option, you can define:
    • the background image of the segment. This image takes precedence over the text. The image can have several states: Off, Hover, Pressed, On, Grayed out.
    • the option text.
    • the option tooltip.
You can adjust other settings in the different tabs of the control description window:
  • Space between options ("Details" tab).
  • Style of the different segments ("Style" tab). You can for example:
    • show or hide a vertical separator between options.
    • use a specific background color to highlight the pushed button.
Note: To display a text and an icon in a segmented button option, you need to:
  • use the gImage function.
  • use Markdown text.

Check Box and Radio Button modes

The Segmented Button control reacts differently, depending on the selected mode.
  • In Radio Button mode, only one option can be selected. Clicking a selected option does not deselect it.
    To deselect a selected option and leave no option selected, you need to modify the value of the option programmatically.
  • In Check Box mode, multiple options can be selected. Clicking a selected option automatically deselects it.
WINDEV

Automatic Application Features (AAF) associated with the control

By default, the "Remember value" AAF option is associated with the control. This option is available in the context menu of the control.
Note: This feature is only available from version 2025 Update 1. In previous versions, the AAF context menu is not displayed when the control is right-clicked.
Minimum version required
  • Version 2025
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 02/17/2025

Send a report | Local help