<Source>.RestorePosition (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English (generic vocabulary)

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / Managing databases / HFSQL / HFSQL functions

Miscellaneous

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<Source>.RestorePosition (Function)

In french: <Source>.RetourPosition

Not available with this kind of connection

Restores the previously saved context of a table (function <Source>.SavePosition): record in progress, filter, read pointers.

<Source>.RestorePosition is used to restore:

the different pointers in the index,
the current filter.

This function can be used with the tables, HFSQL views or queries.

Example

// Find a record
Customer.ReadSeekFirst(Name, Name)
WHILE Customer.Found() = True
	// Saves the current context
	nPos = Customer.SavePosition(Name)
	// Check a customer with another name
	Customer.ReadSeek(Name, Name2)
	IF Customer.Found() = True THEN Counter = Counter + 1
	// Restores the context
	HRestorePosition(nPos)
	Customer.ReadNext(Name)
END

Syntax

<Result> = <Source>.RestorePosition()

<Result>: Boolean

True if the specified position was restored,
False otherwise. HError returns more details about the problem.

<Source>: Type corresponding to the specified source

Name of the table whose context is to be restored.

Remarks

Miscellaneous

The number of calls to <Source>.SavePosition is not limited.
You can nest <Source>.SavePosition and <Source>.RestorePosition for the same table.

Business / UI classification: Business Logic

Component: wd300hf.dll