<Table>.SelectPlus (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

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

Equivalence with the TableSelectPlus function

Special case: Table control with continous scrollbar

"Selecting a row" event

Browsing Table control containing more than 10 000 rows

Row picker

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.

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

// Select row #5 in the "TABLE_ProductTable" control
TABLE_ProductTable.SelectPlus(5)

// Select rows # 5 and 7
// in the multiselection Table control "TABLE_ProductTable"
TABLE_ProductTable.SelectPlus(5, 7)

Syntax

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

<Table control>: Control name

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

<Subscript 1>: Optional integer

Subscript of the first row to select.
If <Subscript 1> and <Subscript N> are not specified, all the rows found in the control are selected.
<Table>.SelectPlus has no effect if <Subscript 1> and <Subscript N> correspond to rows that are already selected. The subscript of the selected row is returned by <Table>.Select.
If this parameter corresponds to -1, the "current" row (the one with focus) is selected.
A single subscript can be specified if the control is a "classic" Table control.

<Subscript N>: Optional integer

Subscript of the Nth row to select.
If <Subscript 1> and <Subscript N> are not specified, all the rows found in the specified control are selected.
<Table>.SelectPlus has no effect if <Subscript 1> and <Subscript N> correspond to rows that are already selected. The subscript of the selected row is returned by <Table>.Select.
A single subscript can be specified if the control is a "classic" Table control.

Remarks

Use conditions

<Table>.SelectPlus can be used on:

a browsing or memory control.
a single-selection or multiselection control.
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.

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:

<Table control>.SelectPlus(<Table control>..Count)
Property ..Count:

<Table control> = <Table control>..Count
<Table>.Count:

<Table control> = <Table control>.Count()

Equivalence with the TableSelectPlus function

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

<Table control>.SelectPlus(<Subscript>)

<Table control> = <Subscript>

Special case: Table control with continous scrollbar

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

Remark: We recommend that you use a Table control with proportional scrollbar.

"Selecting a row" event

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

Browsing Table control containing more than 10 000 rows

In a browsing Table control 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.
Use <Table>.Display associated with the taCurrentSelection constant.

Row picker

When the style of the Table control contains a row picker, 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:

// Positions the row picker on the 3rd row
// And selects the rows 3, 4 and 5
TABLE_ListCustomers = 3
TABLE_ListCustomers.SelectPlus(3, 4, 5)

Component : wd260obj.dll