ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / Developing an application or website / Controls, windows and pages / Controls: Available types / Linear Looper control
  • Overview of Linear Looper control
  • Page control
  • Attributes of a Linear Looper control
  • Creating a Linear Looper control
  • Vocabulary
  • Notes
  • Operations in AJAX
  • Link of Linear Looper controls
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 of Linear Looper control

Page control

A Linear Looper control is used to display a set of controls in a horizontal scrolling list.
The Linear Looper control is used to harmoniously display a menu with images for example.
The information displayed in the Linear Looper control can:
  • be defined programmatically: this is referred to as Linear Looper populated programmatically.
  • come from a data file or query: this is referred to as Linear Looper control based on a data file.
  • come from a WLanguage variable: this is referred to as Linear Looper control based on a variable.
Remark: The Linear Looper control shares numerous characteristics with the Looper control. It is specifically intended to display a small number of elements in order to propose a nice viewing.
Attributes of a Linear Looper control
A linear 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.
To find out or modify the characteristic of a control (its value, its color, ...), all you have to do is handle this control or the corresponding attribute by programming.
Creating a Linear Looper control
To create a Linear Looper control:
  1. On the "Creation" tab, in the "Data" group, expand "Looper" and click "Linear Looper".
  2. Click where you want to create the control in the page. The Linear Looper control creation wizard starts automatically.
To view the characteristics of the control, select "Description" in the context menu. There are two types of information:
  • information about the entire Looper control (select the name of the Looper control).
  • the information regarding each attribute of the Looper control (all you have to do is select the name of an attribute in the Looper control).
Vocabulary
To easily handle a Linear Looper control, you must be familiar with the following vocabulary:
NameDefinition
AttributeAn attribute corresponds to a modifiable value for each element of the Linear Looper control.
An attribute can be linked to a property of a control found in the Linear Looper control to make this property change in all the columns.
For each attribute, you must define:
  • the attribute name.
  • the name of the control in the linear looper that is linked to the attribute.
  • the property of the control corresponding to the attribute (value, color, ...).
Linear Looper based on a data fileThe Linear Looper control is based on a data file or on a query. A record from the data file is displayed on each row. Two types of linear Loopers based on a data file are available:
  • Linear Looper with in-memory data source: the content of the linear Looper control is loaded in memory, then displayed. The access to the different elements of the Linear Looper control is faster. This mode is reserved for data files with less than 100,000 records.
  • Linear Looper with direct access to the data source (no limit): The Linear Looper control displays the content of the data file or query directly. The current record corresponds to the selected element. Selecting an element in the Looper control triggers an access to the linked data file. This type of Linear Looper control is reserved for data files with more than 100,000 records.
Linear Looper populated programmaticallyThe Linear Looper control is neither based on a data file nor on a query. The elements displayed in the Linear Looper control are defined by the developer (through programming).
Linear Looper based on a variableThe Linear Looper control is based on a variable (global to the project or page; class member, etc.).
Notes

Operations in AJAX

Linear Looper controls cannot be modified in AJAX (addition or deletion of elements).
However, their content can be read from a function or from a process in AJAX mode. Similarly, the processes of the controls displayed by the Linear Looper control can be in AJAX mode.

Link of Linear Looper controls

For more details on Linear Looper controls linked to a data file or query, see Looper control linked to a data file.
Related Examples:
The Linear Looper control Unit examples (WEBDEV): The Linear Looper control
[ + ] This example explains how to use the "Linear Looper" control of WEBDEV.
The "Linear Looper" control is used to create some graphic menus for example.
Minimum version required
  • Version 15
Comments
Click [Add] to post a comment

Last update: 06/22/2023

Send a report | Local help