TableSelectPlus (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

"Select a row" event

Selection at cell level

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

Row selector

See also

BuildBrowsingTable (Example)

BuildBrowsingTable

Constants for managing Table, Treeview Table, Looper and List Box controls

FileToMemoryTable

Table control management functions

TableAddLineWithAnimation

TableAddTitleHeader

TableAdjust

TableBreakSubscript (Example)

TableBreakSubscript

TableCellSelect

TableCellSelectOccurrence

TableCollapseExpand

TableColumnSelect

TableColumnSelectOccurrence

TableDeleteWithAnimation

TableFormulaDeleteAll

TableInfoXY (Example)

TableInsertLineWithAnimation

TableRestorePositionAndSelection

TableSave

TableSavePositionAndSelection

TableSearch

TableSearchEverywhere

Use conditions
Positioning on the last row of the Table or TreeView Table control
Equivalence with the TableSelectPlus function
Special case: Table control with continous scrollbar
"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

TableSelectPlus (Function)

In french: TableSelectPlus

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

// Select row #5 in the "TABLE_ProductTable" control
TableSelectPlus(TABLE_ProductTable, 5)

// Select rows # 5 and 7
// in the multi-selection Table control "TABLE_ProductTable"
TableSelectPlus(TABLE_ProductTable, 5, 7)

Syntax

TableSelectPlus(<Table control> [, <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.
If this parameter corresponds to an empty string (""), the control to which the current process belongs will be used.

<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.
TableSelectPlus 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 TableSelect.
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.
TableSelectPlus 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 TableSelect.
In "Server" Table controls, only one index can be specified.

Remarks

Use conditions

TableSelectPlus 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.
Reminder: Multi-selection is not available for Table controls 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:

TableSelectPlus function:

TableSelectPlus(<Table control>, <Table control>.Count)
Count property:

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

<Table control> = TableCount(<Table control>)

Equivalence with the TableSelectPlus function

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

TableSelectPlus(<Table control>, <Index>)

<Table control> = <Index>

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.

"Select a row" event

The "Select a row" event is not run when TableSelectPlus 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:

// Example for selecting a cell
TABLE_ListCustomers[3,2].Selected = 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 HReadSeek.
Call TableDisplay 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:

// Positions the row selector on the 3rd row
// And selects the rows 3, 4 and 5
TABLE_ListCustomers = 3
TableSelectPlus(TABLE_ListCustomers, 3, 4, 5)

Component: wd270obj.dll