<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

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.

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 control to use. This control can correspond to:
a Table control.
a TreeView Table control.

<Save>: Optional character string

Backup characteristics returned by <Table>.SavePositionAndSelection. If this parameter is not specified:
The last backup 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 browsing or memory control.
a single-selection or multiselection control.

Special cases

The control name used for backup (<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 browsing Table controls 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: wd260obj.dll