Combo Box columns in Table controls (prefix syntax)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

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

WEBDEV

WINDEV Mobile

Others

See also

Combo Box columns in 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 field, use a column of type Image.

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).
Drop-down list settings: width, height, resizable list ("Detail" tab in 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.

Note: The height of a Combo column row is the same as the height of a Table field row.

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:

under the editor, in the column details: it cannot then be graphed.
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_TableClient contient:
// - une colonne de type Combo affichant la civilité des clients
// (1 correspond à "Mr", 2 à "Mme" et 3 à "Melle")
// - une colonne de type chaîne affichant le nom des clients
// Ajout de "Mr" et "Dubois" à la fin de ce champ Table
TABLE_TableClient.Ajoute(1 + TAB + "Dubois")

modifying the 5th row with <Table>.ModifyLine:

// TABLE_TableClient contient:
// - une colonne de type Combo affichant la civilité des clients
// (1 correspond à "Mr", 2 à "Mme" et 3 à "Melle")
// - une colonne de type chaîne affichant le nom des clients
// Modification de la 5° ligne avec "Mme" et "Thomas"
TABLE_TableClient.ModifieLigne(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 Combo column withoutinput, it is not possible to directly retrieve the contents of a combo: only the index can be known.. 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 fields have the same content for all lines: only the selected value changes depending on the line.. 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.