<Table>.RestorePositionAndSelection (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Use conditions
Special cases
Equivalence

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<Table>.RestorePositionAndSelection (Function)

In french: <Table>.RestaurePositionEtSélection

Not available

Restores the scrollbar position in a Table or TreeView Table control as well as the selected elements. These elements have been saved by <Table>.SavePositionAndSelection.

Versions 18 and later

This function is now available for WINDEV applications in Linux.

New in version 18

This function is now available for WINDEV applications in Linux.

Versions 27 and later

This function is now available for Android applications.

New in version 27

This function is now available for Android applications.

Example

SaveTable is string
SaveTable = TABLE_Table1.SavePositionAndSelection()
TABLE_Table1.Display(taInit)
TABLE_Table1.RestorePositionAndSelection(SaveTable)

Syntax

<Table control>.RestorePositionAndSelection([<Save>])

<Table control>: Control name

Name of the control to be used. This control can correspond to:
a Table control.
a TreeView Table control.

<Save>: Optional character string

Save characteristics returned by <Table>.SavePositionAndSelection. If this parameter is not specified:
The last save performed by <Table>.SavePositionAndSelection on the control is used (if it exists).
fIf the option "Remember position and selection" is checked in the control description ("Details" tab), the last value saved is used.
Otherwise, an error occurs.

Remarks

Use conditions

<Table>.RestorePositionAndSelection 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 multiselection control.

Special cases

The name of the control used for the save (<Table>.SavePositionAndSelection) can differ from the name used for the restore operation. This feature can be useful to duplicate the position and the selection on two Table controls displayed alternatively for example.
<Table>.RestorePositionAndSelection has no effect if the control is empty.
<Table>.RestorePositionAndSelection does not work on Table controls based on a data file with ongoing movement (i.e. Table controls without proportional scrollbar).

Equivalence

The functions <Table>.SavePositionAndSelection and <Table>.RestorePositionAndSelection are equivalent to the option "Remember position and selection" available in the "Details" tab of the control description.

Component: wd270obj.dll