TableSelect (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Controls, pages and windows / Table functions

Use conditions
Equivalence TableSelect
Value of the selected element

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

TableSelect (Function)

In french: TableSelect

Returns the index of the selected element in the Table or TreeView Table control. This index can correspond to:

the number of the selected row. The selected row corresponds to the current row on which the selection bar is displayed.
the number of the selected column if the control allows the selection mode by column. This option can be configured in the "UI" tab of the control description.
the number of the selected cell if the controls allows the selection mode by cell. This option can be configured in the "UI" tab of the control description.
the column number of the selected cell if the controls allows the selection mode by cell. This option can be configured in the "UI" tab of the control description.

Example

// Indice de la ligne sélectionnée dans le champ "TABLE_Produit"
ResSelect = TableSelect(TABLE_Produit)

// Lignes sélectionnées dans un champ Table par programmation multisélection
FOR i = 1 _TO_ TableSelectCount(TABLE_TABLE1)
	Trace("Elément sélectionné: " + TableSelect(TABLE_TABLE1, i))
END

// Équivalent à:
// i est un entier
// POUR TOUTE LIGNE SELECTIONNEE i DE TABLE_TABLE1
//	 Trace("Elément sélectionné: " + TableSelect(TABLE_TABLE1, i-1))
// FIN

// Supprimer toutes les lignes sélectionnées dans un champ Table
// Il est également possible d'utiliser la fonction TableSupprimeSelect
i is int
NbSelection is int 
NbSelection = TableSelectCount(TABLE_MaTable)
FOR i = NbSelection TO 1 STEP -1
	TableDelete(TABLE_MaTable, TableSelect(TABLE_MaTable, i))
END

Syntax

<Result> = TableSelect(<Table control> [, <Rank> [, <Information to return>]])

<Result>: Integer

Index of the selected element in the specified Table control,
-1 if no element is selected.

<Table control>: Control name

Name of the control to be used. This control can correspond to:
a Table control.
a TreeView Table control.
If this parameter corresponds to an empty string (""), the control to which the current event belongs is used.

<Rank>: Optional integer

Rank of selection for a multi-selection control. If this parameter is not specified, the index of the first selected row is returned.
For example, to retrieve the first selected element, <Rank> = 1.
To retrieve the second selected element, <Rank> = 2, etc.

<Information to return>: Optional Integer constant

Type of information to return:
tsCellColumn <Result> will correspond to the column number for the selected cell.
tsCellRow <Result> will correspond to the row number for the selected cell.
tsColumn <Result> will correspond to the number of the selected column.
tsRow
(Default value) <Result> will correspond to the number of the selected row.
If this parameter is not specified, the function will return the number of the selected row.

Remarks

Use conditions

TableSelect can be used on:

Table or TreeView Table controls based on a data file.
Table or TreeView Table controls populated programmatically.
single-selection or multi-selection controls. For multi-selection Table controls, you must use TableSelect in a loop to get all the selected rows.

Equivalence TableSelect

The following syntaxes are equivalent:

Indice est un entier
Indice = <Champ Table>

Indice = TableSelect(<Champ Table>)

Value of the selected element

To retrieve the value of the selected element, the syntax is:

Indice est un entier
Indice = TableSelect(<Champ Table>)
<Valeur de l'élément> = <Champ Table> [Indice]

<Valeur de l'élément> = <Champ Table> [<Champ Table>]

Component: wd300obj.dll