PC SOFT

ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Home | Sign in | English EN
  • 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
  • "Selecting a row" event
  • Browsing Table control containing more than 10 000 rows
  • Row picker
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
// 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([<Subscript 1> [... [, <Subscript N>]]])
<Table control>: Control name
Name of the control to be used. 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.
If the parameters <Subscript 1> and <Subscript N> correspond to lines already selected, the function <Table>.SelectPlus has no effect. The subscript of a selected row can be obtained with the <Table>.Select function.
If this parameter corresponds to -1, the "current" row (the one with focus) is selected.
<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.
If the parameters <Subscript 1> and <Subscript N> correspond to lines already selected, the function <Table>.SelectPlus has no effect. The subscript of a selected row can be obtained with the function <Table>.Select.
Remarks

Use conditions

<Table>.SelectPlus can be used on:
  • a browsing or memory control.
  • a single-selection or multi-selection control.

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:
  • Function <Table>.SelectPlus:
    <Champ Table>.SelectPlus(<Champ Table>..Occurrence)
  • Occurrence property:
    <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 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:
  1. Perform a search with HReadSeek.
  2. Use function <Table>.Display with constant taCurrentSelection.

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:
    // 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.SelectPlus(3, 4, 5)
Component: wd270obj.dll
Minimum version required
  • Version 23
This page is also available for…
Comments
Click [Add] to post a comment