ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Controls, pages and windows / Looper functions
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>.Display (Function)
In french: <Zone répétée>.Affiche
Refreshes a Looper control based on a data file from a given position: the modifications performed in the linked data file are applied to the Looper control.
Remark: <Looper>.Display can be used on Looper controls based on a data file or populated programmatically.
Example
// Refresh "LOOP_ProductLooper" from the start of the control
LOOP_ProductLooper.Display(taStart)
Syntax
<Looper control>.Display([<Position>])
<Looper control>: Control name
Name of the Looper control to refresh.
<Position>: Integer, character or constant (optional)
Indicates the start position for the refresh. If this parameter is not specified, the elements of the Looper control are redisplayed from the current element in the Looper control.
This parameter can correspond to:
  • An integer. The refresh is performed from this position. The selected row is not modified. The "Select a row" event of <Position> is run. The current element in the Looper control is the same as the current record in the data file. If this integer is invalid (outside the authorized bounds), the call to <Looper>.Display triggers an error.
  • A character or a constant:
    taCurrentFirst
    • Refreshes the Looper control from the current record in the data file.
    • The first row of the Looper control is selected. This row corresponds to the current record of the Looper control.
    taCurrentSelection
    • Refreshes the Looper control from the position of selection bar in the Looper control.
    • The position of selection bar is not modified. The current record in the data file will correspond to the record selected in the Looper control (after <Looper>.Display is called).
    taInit
    • Runs the initialization and end of initialization codes of the Looper control.
    • Fills the Looper control.
    • The first row of the Looper control is selected. This row corresponds to the current record at the end of initialization code of the Looper control.
    taNext
    • Redisplays the Looper control and point at the beginning of the Looper control on the next page (same as using the pager to access the next page).
    • The first visible row of the Looper control is selected. This row corresponds to the current record of the Looper control.
    Universal Windows 10 AppAndroid This constant is not available.
    taPrevious
    • Refreshes the Looper control and points to the beginning of the Looper control on the previous page (same as using the pager to access the previous page).
    • The first visible row of the Looper control is selected. This row corresponds to the current record of the Looper control.
    Universal Windows 10 AppAndroid This constant is not available.
    taReExecuteQuery
    • Re-execute the query linked to the Looper control. For more details, see Tables and queries.
    • Refreshes the Looper control and sets the position at the beginning of the control.
    • The first row of the Looper control is selected. This row corresponds to the first record of the Looper control.
    Caution: Only the query linked to the Looper control is run. If specific options have been specified with <Source>.ExecuteQuery (hModifyFile, for example), these options are ignored.
    taStart
    (Default value)
    • Refreshes the Looper control and sets the position at the beginning of the control.
    • The first row of the Looper control is selected. This row corresponds to the first record of the Looper control.
      Remark: For a Looper control populated programmatically, the first element is not selected.
Component: wd300obj.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