|
|
|
|
|
|
|
|
|
|
- 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
<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.
// 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.
<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.
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.
  Reminder: Multi-selection is not available for Table controls in "Server" mode.
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. 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 <Source>.ReadSeek.
- 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)
This page is also available for…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|