ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Controls, pages and windows / Looper functions
  • Selection bar and <Looper>.Position function
  • Displaying a row at the first position in the Looper control (syntax 1)
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
<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.
Component: wd290obj.dll
Minimum version required
  • Version 23
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 06/22/2023

Send a report | Local help