Help / WLanguage / WLanguage functions / Controls, pages and windows / Looper functions
  • Use conditions
  • Sort
  • Looper bound to a data source and using a programmed iteration
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WindowsLinuxPHPWEBDEV - Browser code
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Stored procedures
<Looper>.Sort (Function)
In french: <Zone répétée>.Trie
Allows sorting a Looper control according to one or more of its attributes.
// Sort according to one of the Looper control attributes selected in a Radio Button control
CASE 1: LOOP_Customer.Sort("NAME")
CASE 2: LOOP_Customer.Sort("COMPANY")
CASE 3: LOOP_Customer.Sort("CITY")

Sorting a Looper control according to a list of attributes Hide the details

<Result> = <Looper control>.Sort(<List of attributes>)
<Result>: Boolean
  • True if the sort was performed,
  • False otherwise.
<Looper control>: Control name
Name of the Looper control to be used.
<List of attributes>: Character string
Name of the attributes according to which the Looper control will be sorted (up to 10 attributes). This character string must have the following format:
"[<Direction>]<Attribute 1>" + TAB + "[<Direction>]<Attribute 2>" + TAB + ...
  • <Direction>: sort direction (optional), can take the following values:
    • "+": the sort will be performed in ascending order (default value).
    • "-": the sort will be performed in descending order.
  • <Attribute>: name of the attribute used for the sort.
WEBDEV - Browser code In browser code, the sort can be performed on a single attribute only.

Use conditions

<Looper>.Sort can be used on:
  • a Looper control based on a data file,
  • a Looper control populated programmatically.
WEBDEV - Browser code This function is not available for Linear Looper controls. This function is available for Looper controls in browser mode only.
WEBDEV - Server codePHP This function is available for Looper controls in Ajax mode, Looper controls in classic mode and Linear Looper controls.


The sort will be taken into account during the next addition of a row into the Looper control (<Looper>.Add, <Looper>.AddLine, <Looper>.Insert and <Looper>.InsertLine).

Looper bound to a data source and using a programmed iteration

<Looper>.Sort does not work on a Looper control with the following characteristics:
  • Looper control bound to a data source,
  • Looper control that uses Browse programmatically ("Content" tab in the control description window).
To change the display order of a Looper control with programmed browse, you must adapt the code found in the different read processes of the Looper control (process for reading the first one, the next one, the previous one, ...).
Component: wd300obj.dll
Minimum version required
  • Version 23
This page is also available for…
Click [Add] to post a comment

Last update: 12/22/2023

Send a report | Local help