<Table>.Select (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

Equivalence <Table>.Select

Value of selected element

See also

<Table>.Select (Function)

In french: <Table>.Select

Returns the subscript of selected element in the Table or TreeView Table control. This subscript 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 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 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 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 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 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 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 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 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 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.

Versions 18 and later

This function can now be used to handle the TreeView Table controls in the WEBDEV and PHP sites.

New in version 18

This function can now be used to handle the TreeView Table controls in the WEBDEV and PHP sites.

This function can now be used to handle the TreeView Table controls in the WEBDEV and PHP sites.

Versions 19 and later

This function is now available in Browser code for Table controls in browser mode.

New in version 19

This function is now available in Browser code for Table controls in browser mode.

Example

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

// Rows selected in a multiselection memory Table control
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

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

<Table control>: Control name

Name of control to use. This control can correspond to:
a Table control.
a TreeView Table control.

<Rank>: Optional integer

Rank of selection for a multiselection control. If this parameter is not specified, the subscript of first selected row is returned.
For example, to retrieve the first selected element, <Rank> = 1.
To retrieve the second selected element, <Rank> = 2, etc.
This parameter is not available for the "classic" Table controls.

<Information to return>: Optional Integer constant

Versions 16 and later
Type of information to return:
tsColumn <Result> will correspond to the number of the selected column.
tsCellColumn <Result> will correspond to the column number for the selected cell.
tsRow
(Default value) <Result> will correspond to the number of the selected row.
tsCellLine <Result> will correspond to the row number for the selected cell.
If this parameter is not specified, the function will return the number of the selected line.
New in version 16
Type of information to return:
tsColumn <Result> will correspond to the number of the selected column.
tsCellColumn <Result> will correspond to the column number for the selected cell.
tsRow
(Default value) <Result> will correspond to the number of the selected row.
tsCellLine <Result> will correspond to the row number for the selected cell.
If this parameter is not specified, the function will return the number of the selected line.
Type of information to return:
tsColumn <Result> will correspond to the number of the selected column.
tsCellColumn <Result> will correspond to the column number for the selected cell.
tsRow
(Default value) <Result> will correspond to the number of the selected row.
tsCellLine <Result> will correspond to the row number for the selected cell.
If this parameter is not specified, the function will return the number of the selected line.

Remarks

Use conditions

<Table>.Select can be used on:

a browsing or memory control.
a single-selection or multiselection control. For multiselection Table controls, you must use <Table>.Select in a loop to get all the selected rows.
Reminder: Multiselection is not available for Table controls in classic mode.

This function is available for Table controls in Ajax mode, Table controls in classic mode and TreeView Table controls.

This function is available for Table controls in browser mode only.

The TreeView Table control is not available.

Equivalence <Table>.Select

The following syntaxes are equivalent:

Subscript is int
Subscript = <Table control>

Subscript = <Table control>.Select()

Value of selected element

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

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

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

Component : wd250obj.dll