<Table>.SelectPlus (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

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

Use conditions
Positioning on the last row of the Table or TreeView Table control
Equivalence with the TableSelectPlus function
Special case: Table field with rebound elevator
"Select a row" event
Selection at cell level
Table control based on a data file containing more than 10 000 rows
Row selector

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<Table>.SelectPlus (Function)

In french: <Table>.SelectPlus

Selects a row in a Table or TreeView Table control. The selected row corresponds to the current row on which the selection bar is displayed.

Example

// Sélection de la ligne 5 dans le champ "TABLE_TableProduit"
TABLE_TableProduit.SelectPlus(5)

// Sélection des lignes 5 et 7 
// dans le champ Table multisélection "TABLE_TableProduit"
TABLE_TableProduit.SelectPlus(5, 7)

Syntax

<Table control>.SelectPlus([<Index 1> [... [, <Index N>]]])

<Table control>: Control name

Name of the control to be used. This control can correspond to:
a Table control.
a TreeView Table control.

<Index 1>: Optional integer

Index of the first row to select.
If <Index 1> and <Index N> are not specified, all the rows in the control are selected.
<Table>.SelectPlus has no effect if <Index 1> and <Index N> correspond to rows that are already selected. You can get the index of a selected row with <Table>.Select.
If this parameter corresponds to -1, the "current" row (the one with focus) is selected.
In "Server" Table controls, only one index can be specified.

<Index N>: Optional integer

Index of the Nth row to select.
If <Index 1> and <Index N> are not specified, all the rows in the specified control are selected.
<Table>.SelectPlus has no effect if <Index 1> and <Index N> correspond to rows that are already selected. You can get the index of a selected row with <Table>.Select.
In "Server" Table controls, only one index can be specified.

Remarks

Use conditions

<Table>.SelectPlus 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.
Reminder: Multi-selection is not available for Table fields in "Server" mode.

This function is available for Table controls in "Server" and "Server + AJAX" mode, and for TreeView Table controls.

This function is available for Table controls in "Browser" mode only.

The TreeView Table control is not available.

Positioning on the last row of the Table or TreeView Table control

To position on the last row of a Table or TreeView Table control, use one of the following syntaxes:

<Table>.SelectPlus function:
<Champ Table>.SelectPlus(<Champ Table>.Occurrence)
Property Count:
<Champ Table> = <Champ Table>.Occurrence
Function <Table>.Count:
<Champ Table> = <Champ Table>.Occurrence()

Equivalence with the TableSelectPlus function

For a single-selection Table or TreeView Table control (without stored item), the two following syntaxes are equivalent:

<Champ Table>.SelectPlus(<Indice>)

<Champ Table> = <Indice>

Special case: Table field with rebound elevator

Selecting a non-visible row in the Table control does not give focus to the selected row.

Note: We recommend using a Table field with a proportional scrollbar..

"Select a row" event

The "Select a row" event is not run when <Table>.SelectPlus is called.

Selection at cell level

The Selected property can be used to select a cell or to determine if a cell is selected in Table controls with "Multiple selection" mode.

For example:

// Exemple de sélection d'une cellule
TABLE_ListeClients[3,2].Sélectionnée = True

Table control based on a data file containing more than 10 000 rows

In a Table control based on a data file containing more than 10 000 rows, for performance reasons, the positioning in the Table control is approximate.

For an exact positioning, you must:

Perform a search with <Source>.ReadSeek.
Call <Table>.Display with the taCurrentSelection constant.

Row selector

When the style of the Table control contains a row selector, the arrow on the left is positioned on:

the last selected row when the multiple selection is performed with the mouse or with the keyboard,

the row to which "focus" is gien by assigning the Table control. For example:

// Positionne le sélecteur de ligne sur la 3ème ligne
// Et sélectionne les lignes 3, 4 et 5
TABLE_ListeClients = 3 
TABLE_ListeClients.SélectPlus(3, 4, 5)

Component: wd300obj.dll