ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

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 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
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
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
TABLE_ProductTable.SelectPlus(5)
// Select rows # 5 and 7
// in the multi-selection Table control "TABLE_ProductTable"
TABLE_ProductTable.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.
WEBDEV - Server codeWEBDEV - Browser codePHP 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.
WEBDEV - Server codeWEBDEV - Browser codePHP In "Server" Table controls, only one index can be specified.
Remarks

Use conditions

<Table>.SelectPlus 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.
    WEBDEV - Server codePHP Reminder: Multi-selection is not available for Table controls in "Server" mode.
WEBDEV - Server codePHP This function is available for Table controls in "Server" and "Server + AJAX" mode, and for TreeView Table controls.
WEBDEV - Browser code This function is available for Table controls in "Browser" mode only.
WEBDEV - Browser code 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:
    <Table control>.SelectPlus(<Table control>.Count)
  • Count property:
    <Table control> = <Table control>.Count
  • <Table>.Count function:
    <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(<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 <Table>.SelectPlus is called.
WINDEVJava

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:
  1. Perform a search with <Source>.ReadSeek.
  2. 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:
    // Positions the row selector on the 3rd row
    // And selects the rows 3, 4 and 5
    TABLE_ListCustomers = 3
    TABLE_ListCustomers.SelectPlus(3, 4, 5)
Component: wd300obj.dll
Minimum version required
  • Version 23
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 06/20/2023

Send a report | Local help