PC SOFT

ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Home | Sign in | English EN

This content has been translated automatically. Click here to view the French version.
  • 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.
Versions 16 and later
Linux This function is now available for WINDEV applications in Linux.
New in version 16
Linux This function is now available for WINDEV applications in Linux.
Linux This function is now available for WINDEV applications in Linux.
Versions 18 and later
WEBDEV - Server codePHP This function can now be used to handle TreeView Table controls in WEBDEV and PHP sites.
New in version 18
WEBDEV - Server codePHP This function can now be used to handle TreeView Table controls in WEBDEV and PHP sites.
WEBDEV - Server codePHP This function can now be used to handle TreeView Table controls in WEBDEV and PHP sites.
Versions 19 and later
WEBDEV - Browser code This function is now available in Browser code for Table controls in browser mode.
New in version 19
WEBDEV - Browser code This function is now available in Browser code for Table controls in browser mode.
WEBDEV - Browser code This function is now available in Browser code for Table controls in browser mode.
Example
// Sélection de la ligne 5 dans le champ "TABLE_TableProduit"
TableSelectPlus(TABLE_TableProduit, 5)
// Sélection des lignes 5 et 7
// dans le champ Table multisélection "TABLE_TableProduit"
TableSelectPlus(TABLE_TableProduit, 5, 7)
Syntax
TableSelectPlus(<Table control> [, <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.
If this parameter corresponds to an empty string (""), the control to which the current process belongs will be used.
<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 TableSelectPlus has no effect. The subscript of a selected row can be obtained with the TableSelect function.
If this parameter corresponds to -1, the "current" row (the one with focus) is selected.
WEBDEV - Server codeWEBDEV - Browser codePHP 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.
If the parameters <Subscript 1> and <Subscript N> correspond to lines already selected, the function TableSelectPlus has no effect. The subscript of a selected row can be obtained with the function TableSelect.
WEBDEV - Server codeWEBDEV - Browser codePHP A single subscript can be specified if the control is a "classic" Table control.
Remarks

Use conditions

TableSelectPlus can be used on:
  • a browsing or memory control.
  • a single-selection or multi-selection control.
    WEBDEV - Server codePHP Reminder: Multi-selection is not available for Table controls in classic mode.
WEBDEV - Server codePHP This function is available for Table controls in Ajax mode, Table controls in classic mode and 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.
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:
  • Function TableSelectPlus:
    TableSelectPlus(<Champ Table>, <Champ Table>..Occurrence)
  • Occurrence property:
    <Champ Table> = <Champ Table>..Occurrence
  • Function TableCount:
    <Champ Table> = TableOccurrence(<Champ Table>)

Equivalence with the TableSelectPlus function

For a single-selection Table or TreeView Table control (without stored item), the two following syntaxes are equivalent:
TableSelectPlus(<Champ Table>, <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 TableSelectPlus 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 TableDisplay 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
    TableSelectPlus(TABLE_ListeClients, 3, 4, 5)
Component: wd270obj.dll
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment