4D Doc Center : LISTBOX TRIER COLONNES

4D v14.3

LISTBOX TRIER COLONNES


LISTBOX TRIER COLONNES ( {* ;} objet ; numColonne ; sensDuTri {; numColonne2 ; sensDuTri2 ; ... ; numColonneN ; sensDuTriN} )

Paramètre	Type	Description
*	Opérateur	Si spécifié, objet est un nom d'objet (chaîne) Si omis, objet est une variable
objet	Objet de formulaire	Nom d’objet (si * est spécifié) ou Variable (si * est omis)
numColonne	Entier long	Numéro(s) de colonne(s) de tri
sensDuTri	Opérateur	">"pour effectuer un tri croissant ou "<" pour effectuer un tri décroissant

Description

La commande LISTBOX TRIER COLONNES permet de trier (réordonner) toutes les lignes de la list box désignée par les paramètres objet et * sur la base des valeurs d’une ou plusieurs colonne(s).

Si vous passez le paramètre optionnel *, vous indiquez que le paramètre objet est un nom d’objet (une chaîne). Si vous ne passez pas ce paramètre, vous indiquez que le paramètre objet est une variable. Dans ce cas, vous ne passez pas une chaîne mais une référence de variable. Pour plus d'informations sur les noms d’objets, reportez-vous à la section Propriétés des objets.

Passez dans numColonne le numéro de la colonne dont les valeurs seront utilisées comme critère de tri. Vous pouvez utiliser tout type de données, à l’exception des colonnes contenant des images et des pointeurs.

Passez dans sensDuTri le symbole > ou < indiquant l’ordre du tri : croissant ou décroissant. Si sensDuTri est égal au symbole “supérieur à” (>), l’ordre du tri est croissant. Si sensDuTri est égal au symbole “inférieur à” (<), l’ordre du tri est décroissant.

Vous pouvez définir des tris multi-niveaux : pour cela, passez autant de paires numColonne;sensDuTri que nécessaire. Le niveau de tri est défini par la position du paramètre lors de l’appel.

Conformément au principe de fonctionnement des list box, les colonnes sont synchronisées, ce qui signifie que le tri d’une colonne est automatiquement répercuté sur toutes les colonnes de l’objet.