ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Controls, pages and windows / Looper functions
  • Selection bar and LooperPosition function
  • Displaying a row at the first position in the Looper control (syntax 1)
  • Use conditions
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
LooperPosition (Function)
In french: ZoneRépétéePosition
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 = LooperPosition(LOOP_Product)
Syntax

Displaying a Looper control from a specific row Hide the details

LooperPosition(<Looper control> , <Index>)
<Looper control>: Control name
Name of the Looper control to be used.
If this parameter corresponds to an empty string (""), the Looper control used is the Looper control to which the current event belongs.
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 LooperCount).

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

<Result> = LooperPosition(<Looper control>)
<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.
If this parameter corresponds to an empty string (""), the Looper control used is the Looper control to which the current event belongs.
Caution: No linear Looper control can be used.
Remarks

Selection bar and LooperPosition function

LooperPosition does not change the current row (i.e. the row highlighted by the selection bar).
Therefore, if the Looper control has focus when LooperPosition 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, LooperPosition tries to display as many rows as possible in the Looper control.
LooperPosition will display the specified row only if this row is followed by a sufficient number of non-empty rows.
WEBDEV - Server codeWEBDEV - Browser code

Use conditions

  • WEBDEV - Server code LooperPosition can only be used in a standard Looper control without scrollbar.
  • WEBDEV - Browser code LooperPosition can only be used with a Looper control in Browser code.
Business / UI classification: UI Code
Component: wd290obj.dll
Minimum version required
  • Version 10
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 06/22/2023

Send a report | Local help