<Looper>.Display (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

Display

Presentation

Example

See also

<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.
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.
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: wd280obj.dll