ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / Developing an application or website / Controls, windows and pages / Controls: Available types / Table control
  • Overview
  • Creating a Combo Box column
  • Characteristics of Combo Box columns
  • Limitations in Java
  • Programming a Combo Box column
  • Initializing the content of the Combo Box column
  • Selecting an element of the Combo Box column programmatically
  • Retrieving the content of a Combo Box column
  • Combo Box with or without input
  • Remark
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
Combo Box columns in the Table controls (prefix syntax)
Overview
A Table control (populated programmatically, based on a data file or based on a variable) can include Combo Box columns.
Combo Box columns can be used to view data file items (Combo Box, List Box, Radio Button or Check Box file items) in a Table control. Combo Box columns are also used to view images in a Table control.
Reminder: To display an image in a Table control, use an Image column.
For more details on Combo Box controls, see Combo Box control.
Creating a Combo Box column
To create a Combo Box column, simply select "Combo Box" in the column type:
Characteristics of Combo Box columns
Generally, a Combo Box column in a Table control has all the characteristics of a Combo Box control. This Combo Box column can be linked to a data file, for example.
The following characteristics are available:
  • Editable or non-editable Combo Box ("Details" tab of the column description).
  • Combo Box with or without assisted input ("Details" tab of the column description).
  • Sorted or unsorted Combo Box (only for a Combo Box populated programmatically, "Details" tab of the column description).
  • Configuration of the button associated with the Combo Box ("Details" tab of the column description).
  • Configuration of the drop-down list: width, height, resizable list ("Details" tab of the column description).
  • Selection bar in the Combo Box ("UI" tab of the column description).
  • Style settings of the Combo Box ("Style" tab, "Combo Box column (button)").
You can enter the initial value of the Combo Box column if it is not bound to a data file item.
Remark: The height of a row in the Combo Box column is identical to the height of a row in the Table control.
Java

Limitations in Java

The following characteristics are not supported in Java:
  • Spin control of the Combo Box visible only on the current row.
  • Custom expanded height and width.
Programming a Combo Box column

Initializing the content of the Combo Box column

The content of the Combo Box column can be initialized:
  • in the editor, in the details of the column: in this case, the content cannot be graphic (images, drawings, etc.).
  • in the code with <List Box>.Add, in the initialization event of the Table control, for example.
The content of the Combo Box column cannot be modified, even for an editable Combo Box. Therefore, the values in a Combo Box column will be the same for all the rows of the Table control.

Selecting an element of the Combo Box column programmatically

To select an element of the Combo Box column, simply specify its index. This index can be used by the functions for managing Table controls.
For example:
  • adding a row with <Table>.Add:
    // TABLE_CustomerTable contains:
    // - a Combo Box column that displays the title of the customers
    // (1 corresponds to "Mr", 2 to "Mrs" and 3 to "Miss")
    // - a String column that displays the name of the customers
    // Add "Mr" and "Doe" at the end of this Table control
    TABLE_CustomerTable.Add(1 + TAB + "Moore")
  • modifying the 5th row with <Table>.ModifyLine:
    // TABLE_CustomerTable contains:
    // - a Combo Box column that displays the title of the customers
    // (1 corresponds to "Mr", 2 to "Mrs" and 3 to "Miss")
    // - a String column that displays the name of the customers
    // Modify the 5th row with "Mrs" and "Thomas"
    TABLE_CustomerTable.ModifyLine(5, 2, "Thomas")

Retrieving the content of a Combo Box column

The value selected in a Combo Box column can be retrieved with the Value property.

Combo Box with or without input

  • Important:
    • In a non-editable Combo Box column, the content of the Combo Box cannot be retrieved directly: only the index can be retrieved. To get the value selected in the Combo Box column, use the DisplayedValue property.
    • In an editable Combo Box column, the content of the combo box can be retrieved directly.
  • The Combo Box column stores the corresponding index (if an item is bound to the column, this item also stores the index). Therefore, the content of the Combo Box control not be modified.
  • The events associated with a Combo Box column are identical to those of a Combo Box control.
  • Combo Box columns without input and in read-only mode cannot be expanded.

Remark

Combo Box controls in Table controls have the same content for all rows: only the selected value changes according to the row. However, since version 14, it is possible to change the content of Combo Box columns for each row. To do so, use the Content property of the Combo Box column.
Minimum version required
  • Version 23
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 06/10/2022

Send a report | Local help