Events associated with Looper controls

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Help

Editors

Controls (window/page/report)

Controls

Looper control

Events associated with Looper controls

Events managed by default

Filtering the records (browsing looper only)

Click on a Looper control (browser code only)

Optional events

See also

Events associated with Looper controls

Events managed by default

Events managed by WEBDEV

WEBDEV manages the following events by default (order of appearance in the code editor):

Event	Runtime condition

Initialization (Server code)	Run when opening the page. Special case: Browsing looper automatically filled: When this code is run, the Looper control is not filled yet. To force the Looper control to be filled in this code, use: LooperDisplay the properties for managing browsing Looper controls: ..BrowsedFile, ..BrowsedItem or ..Filter.
End of initialization (Server code)	Code for browsing Looper controls filled automatically: Run once the Looper control has been filled. This code can be used to add or modify an element of the Looper control.
Row display (Server code)	Run when a new row must be displayed in the Looper control: redisplaying the Looper control, etc Used to manage calculated attributes.
Filtering the records (Server code)	Code for browsing Looper controls filled automatically: Run just before displaying a row. This event filters the records displayed in the Looper control. This event is detailed at the end of this page.

Remark: In a static page, only optional events are available.

Filtering the records (browsing looper only)

The event "Filtering the records" is run right after a row of the Looper control is displayed. Therefore, it is run:

when initializing the Looper control.
whenever a row is displayed in the Looper control.

This event filters the records displayed in the Looper control.

To implement a filter, the event "Filtering the records" must return a value:

True to specify that the record matches to the filter and that it must be displayed.
False to specify that the record does not match the filter and that it must not be displayed.
Cancel to stop reading the data source of the Looper control (very rare case).

Example:

// -- Filter the records
// Displays the customers who placed orders exceeding 3000 Euros
IF Order.TotalIOT >= 3000 THEN
RESULT True
ELSE
RESULT False
END

In this code, the data handled affects the record currently read by the Looper control. This data comes from the data file or query linked to the Looper control.

Remark: In WINDEV and WINDEV Mobile, the event "Recording the records" is an optional event. In WEBDEV, this event is proposed by default.

Click on a Looper control (browser code only)

The event "Click on the Looper control" is run when the user clicks on a row of the Looper control.

Versions 17 and later
This process is used to select the row. This event returns the values of the attributes corresponding to the row. For example, the following click code is used to find out the value of the ATT_Title attribute for the row that was clicked:

Trace(ATT_Title)

New in version 17
This process is used to select the row. This event returns the values of the attributes corresponding to the row. For example, the following click code is used to find out the value of the ATT_Title attribute for the row that was clicked:

Trace(ATT_Title)

This process is used to select the row. This event returns the values of the attributes corresponding to the row. For example, the following click code is used to find out the value of the ATT_Title attribute for the row that was clicked:

Trace(ATT_Title)

Optional events

Several optional events can be managed.

To add an optional event:

Select the requested control.
Display the code window of this control (F2 key).
Click the link "Add other events to xxx" at the bottom of the window code, after the last event.
All the optional events available for the control are displayed.
Check the optional event to add and validate.
Remark: You can select several optional events.
The selected optional event is automatically added to the events managed by the control.

To disable an optional event, simply perform the same operations to display the list of optional events. Then simply uncheck the optional events to delete.
Remark: If the disabled code contains WLanguage code, this code is automatically deleted.

You can manage, for example:

left mouse button down, up, with a double click,
right button down, up, etc.

For more details, consult the Optional events.