LooperSort (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Controls, pages and windows / Looper functions

Use conditions
Canceling the sort
Sort
Looper bound to a data source and using a programmed iteration

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

LooperSort (Function)

In french: ZoneRépétéeTrie

Allows you to:

Sort a Looper control according to one or more attributes.
Sort a Looper control on all its attributes.
Cancel a sort that was performed beforehand (which means ignore the sort).

Example

// Tri selon un des attributs du champ Zone répétée choisi dans un champ Sélecteur
SWITCH SEL_SELECT1
	CASE 1: LooperSort("NOM")
	CASE 2: LooperSort("SOCIETE")
	CASE 3: LooperSort("VILLE")
END

// Tri par nom par ordre croissant et par date par ordre décroissant
LooperSort("NOM" + TAB + "-DATE")

// Tri du champ Zone répétée ZR_Client par ordre décroissant sur tous ses attributs
LooperSort("-ZR_Client")

// Annule le tri précédemment effectué sur le champ Zone répétée ZR_Client
LooperSort("ZR_Client", False)

Syntax

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

<Result> = LooperSort(<List of attributes>)

<Result>: Boolean

True if the sort was performed,
False otherwise.

<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:
"[<Sens>]<Attribut 1>" + TAB + "[<Sens>]<Attribut 2>" + TAB + ...
with:
: sorting direction (optional), can take the following values:
"+": sorting will be ascending (default value).
"-": sorting will be in descending order.
: name of the attribute used for sorting.
In browser code, the sort can be performed on a single attribute only.

Sorting a Looper control or canceling a previous sort Hide the details

<Result> = LooperSort([<Direction>]<Looper> [, <Indicator>])

<Result>: Boolean

True if the sort was performed or canceled,
False otherwise.

<[<Direction>]<Looper>>: Character string

Name of the Looper control to sort.
If <Direction> is equal to "+", the Looper control will be sorted in ascending order (by default).
If <Direction> is equal to "-", the Looper control will be sorted in descending order.

<Indicator>: Optional boolean

True to perform the sort (default value),
False to cancel a sort that was performed beforehand.

Remarks

Use conditions

LooperSort can be used on:

a Looper control based on a data file,
a Looper control populated programmatically.

This function is not available for Linear Looper controls. This function is available for Looper controls in browser mode only.

This function is available for Looper controls in AJAX mode, Looper controls in classic mode and Linear Looper controls.

Canceling the sort

The sort is not canceled by LooperDelete, LooperDeleteAll, LooperSearch and LooperCount.
If an attribute is modified by LooperModify and if this attribute is used as sort attribute for the Looper control, the sort on this attribute is canceled.

Sort

The sort will be taken into account during the next addition of a row into the Looper control (LooperAdd, LooperAddLine, LooperInsert and LooperInsertLine).

Looper bound to a data source and using a programmed iteration

LooperSort 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 iteration, 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