ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / Developing an application or website / Controls, windows and pages / Controls: Available types / Looper control
  • Overview
  • Attributes and controls of a Looper control based on a data file
  • Attributes and controls of a Looper control based on a data file in WEBDEV
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
Overview
This type of Looper control uses data from a data file or query.
Each row found in the Looper control corresponds to a record of the data source.
The number of records that can be viewed is unlimited, only the visible rows of control are loaded in memory.
The Live Data (available in the editor) is used to easily resize the controls found in the rows.
Attributes and controls of a Looper control based on a data file
WEBDEV - Server codeWEBDEV - Browser codePHP

Attributes and controls of a Looper control based on a data file in WEBDEV

A Looper control includes:
  • controls, that are repeated on each row.
  • attributes. An attribute defines the control characteristic that will change on each row. For example, if the value and color of the PRICE control must change on each row, you need to define two different attributes for the same control.
For new Looper controls based on a data file, a control and an attribute are automatically created for each item from the data file or query.
This attribute corresponds to the association between the control linked to the item of the data source (data file or query) and the change of control value on each row.
To modify one or more characteristics of these controls (color, status, width, height, ...), you must:
  • add new attributes ("New" or "Insert" button in the control description).
  • handle these attributes through programming in the "Display a row" event of the Looper control.
For example, the Looper control "LOOP_MyLooper" is based on the data file "Customer". This data file contains 10 items (name, address, phone number, ... of each customer). When creating the Looper control, 10 controls and 10 attributes will be automatically created:
  • Each control will be linked to an item of data file "Customer".
  • Each attribute will indicate the characteristic that must be modified on each row: the value of the control.
In order for the background color of the "EDT_CustomerName" control to change on each row, you must:
  • add a new attribute ("ATT_ColorAttribute" for example). This attribute will be associated with the "EDT_CustomerName" control and it will have the "Background color" property.
  • handle this attribute through programming to define the desired background color. For example:
    // -- Displaying a row of LOOP_MyLooper
    Index is int
    // Retrieve the index of the current row
    Index = LOOP_MyLooper
     
    IF IsEven(Index) = True THEN
    // The background color will be red for the even rows
    ATT_ColorAttribute[Index] = LightRed
    ELSE
    // The background color will be blue for the odd rows
    ATT_ColorAttribute[Index] = LightBlue
    END
Remark: A pager is automatically associated with new Looper controls based on a data file. This pager is used to display the records found in the Looper control.
Related Examples:
webmillion Complete examples (WEBDEV): webmillion
[ + ] The following topics are presented in this example:
1/ Using queries
2/ Using "browsing" loopers in automatic browse
3/ Using "browsing" loopers in manual browse

Summary of the example supplied with WEBDEV:
This Web application, powered by WEBDEV, is used to display, find and order tee-shirts.
Once the order is placed, you have the ability to use the PayBox module for secure payment.

This example contains a page used to generate a data file containing an important number of records.
WM Attendance Cross-platform examples (WINDEV Mobile): WM Attendance
[ + ] This application is an attendance manager. It allows you to list the persons who attended a meeting.
The database is filled beforehand with the list of registered persons.
You have the ability to find a person by using his/her name.
The following topics are presented in this example:
1/ using a browsing looper based on a query
2/ using a database in HFSQL format.
WM Managing Contacts Cross-platform examples (WINDEV Mobile): WM Managing Contacts
[ + ] This example presents the management of contacts for Android et iOS.
It is used o:
- list the contacts found on the phone
- call the contacts
- send SMSs to the contacts
- ...
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 06/22/2023

Send a report | Local help