<Looper>.Position (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

Looper functions

Prefix syntax

Position

Presentation

Example

Selection bar and <Looper>.Position function

Displaying a row at the first position in the Looper control (syntax 1)

Use conditions

See also

<Looper>.Position (Function)

In french: <Zone répétée>.Position

Moves the scrollbar to display a specific row or returns the index of the first row displayed in a Looper control populated programmatically.

Example

// Index of the first row displayed in "LOOP_Product"
ResPosition = LOOP_Product.Position()

Syntax

Displaying a Looper control from a specific row Hide the details

<Looper control>.Position(<Index>)

<Looper control>: Control name

Name of the Looper control to be used.
Caution: No linear Looper control can be used.

<Index>: Integer

Index of the row that will be displayed at the first position in the Looper control.
The last row is selected by default if this parameter is greater than the number of rows in the Looper control (returned by <Looper>.Count).

Getting the index of the first row displayed in a Looper control Hide the details

<Result> = <Looper control>.Position()

<Result>: Integer

Index of the first row displayed in the specified Looper control.

<Looper control>: Control name

Name of the Looper control to be used.
Caution: No linear Looper control can be used.

Remarks

Selection bar and <Looper>.Position function

<Looper>.Position does not change the current row (i.e. the row highlighted by the selection bar).

Therefore, if the Looper control has focus when <Looper>.Position is run, the current row and the specified row must be visible at the same time. If the current row and the specified row cannot be displayed at the same time, the Looper control will be displayed from the current row (and not from the row at <Index>).

Displaying a row at the first position in the Looper control (syntax 1)

The row displayed at the first position may not be the requested row. Indeed, <Looper>.Position tries to display as many rows as possible in the Looper control.

<Looper>.Position will display the specified row only if this row is followed by a sufficient number of non-empty rows.

Use conditions

<Looper>.Position can only be used in a standard Looper control without scrollbar.

Component: wd270obj.dll