<Table>.Select (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

Equivalence <Table>.Select

Value of the selected element

Selection at cell level

See also

<Table>.Select (Function)

In french: <Table>.Select

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.
Versions 16 and later
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.
New in version 16
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 column if the control allows the selection mode by column. This option can be configured in the "UI" tab of the control description.
Versions 16 and later
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.
New in version 16
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 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.
Versions 16 and later
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.
New in version 16
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.
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.

Versions 16 and later

This function is now available for WINDEV applications in Linux.

New in version 16

This function is now available for WINDEV applications in Linux.

Example

// Index of the selected row in the "TABLE_Product" control
ResSelect = TABLE_Product.Select()

// Rows selected in a multi-selection Table control populated programmatically
FOR i = 1 _TO_ TABLE_TABLE1.SelectOccurrence()
Trace("Selected element: " + TABLE_TABLE1.Select(i))
END

// Equivalent to:
// i is int
// FOR EACH SELECTED ROW i OF TABLE_TABLE1
// Trace("Selected element: " + TABLE_TABLE1.Select(i-1))
// END

// Delete all selected rows from a Table control
// <Table>.DeleteSelect can also be used
i is int
NbSelection is int
NbSelection = TABLE_MyTable.SelectCount()
FOR i = NbSelection TO 1 STEP -1
TABLE_MyTable.Delete(TABLE_MyTable.Select(i))
END

Syntax

<Result> = <Table control>.Select([<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.

<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

Versions 16 and later
Type of information to return:
tsCellColumn <Result> will correspond to the column number for the selected cell.
tsCellLine <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 line.
This parameter is not available. The function will return the number of the selected row.
New in version 16
Type of information to return:
tsCellColumn <Result> will correspond to the column number for the selected cell.
tsCellLine <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 line.
This parameter is not available. The function will return the number of the selected row.
Type of information to return:
tsCellColumn <Result> will correspond to the column number for the selected cell.
tsCellLine <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 line.
This parameter is not available. The function will return the number of the selected row.

Remarks

Use conditions

<Table>.Select can be used on:

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

Equivalence <Table>.Select

The following syntaxes are equivalent:

Index is int
Index = <Table control>

Index = <Table control>.Select()

Value of the selected element

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

Index is int
Index = <Table control>.Select()
<Element value> = <Table control> [Index]

<Element value> = <Table control> [<Table control>]

Versions 16 and later

Selection at cell level

If the "multiple selection" mode is enabled for the cells of a control, you can use the Selected property to select a cell in the code or to know whether a cell is selected.

New in version 16

Selection at cell level

If the "multiple selection" mode is enabled for the cells of a control, you can use the Selected property to select a cell in the code or to know whether a cell is selected.

Selection at cell level

If the "multiple selection" mode is enabled for the cells of a control, you can use the Selected property to select a cell in the code or to know whether a cell is selected.

Component: wd270obj.dll