<Table>.SelectPlus (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

Table functions

Prefix syntax

SelectPlus

Presentation

Example

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

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

Row selector

See also

Add

AddColumn

AddInProgress

AddLine

AddLineWithAnimation

AddTitleHeader

Adjust

BreakSubscript

CellSelect

CellSelectOccurrence

CollapseExpand

ColumnSubscript

Count

Delete

DeleteAll

DeleteSelect

DeleteWithAnimation

DisableFilter

Display

End

EndFilling

EnumBreak

EnumColumn

FilteredColumn

FixColumn

FormulaAdd

FormulaDeleteAll

InfoXY

InputInProgress

InputSearch

Insert

InsertColumn

InsertLine

InsertLineWithAnimation

Modify

ModifyColumn

ModifyLine

MoveColumn

MoveLine

Position

RecNum

RefreshVisible

RestorePositionAndSelection

Save

SavePositionAndSelection

SearchEverywhere

Select

SelectCount

SelectMinus

SelectPlus

SelectToFile

SetFocus

Sort

SortedColumn

StartFilling

SwapLine

ToClipboard

ToText

ToWord

ToXML

Functions for managing Table controls (prefix syntax)

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
Table control based on a data file containing more than 10 000 rows
Row selector

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<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.

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.

<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.

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)

Component: wd280obj.dll