PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • Conditions d'utilisation
  • Trier un champ Table ou Table hiérarchique fichier
  • Gestion d'un champ Table ou Table hiérarchique trié
  • Tri sur une colonne calculée
  • Champ Table ou Table hiérarchique parcouru par programmation
  • Réaliser un tri basé sur la valeur ASCII
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Trie un champ Table ou Table hiérarchique sur une ou plusieurs colonnes (tri lexicographique).
Remarque : Lorsqu'un champ est trié avec la fonction <Table>.Trie, les images permettant de connaître le sens du tri ne sont pas affichées dans les colonnes.
Versions 16 et supérieures
Linux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
Nouveauté 16
Linux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
Linux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
Versions 19 et supérieures
WEBDEV - Code Navigateur Cette fonction est désormais disponible en code Navigateur pour les champs Table en mode navigateur.
Nouveauté 19
WEBDEV - Code Navigateur Cette fonction est désormais disponible en code Navigateur pour les champs Table en mode navigateur.
WEBDEV - Code Navigateur Cette fonction est désormais disponible en code Navigateur pour les champs Table en mode navigateur.
Versions 20 et supérieures
Android Cette fonction est désormais disponible pour les applications Android.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Nouveauté 20
Android Cette fonction est désormais disponible pour les applications Android.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Android Cette fonction est désormais disponible pour les applications Android.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Exemple
// Tri des colonnes "Désignation" et "Prix" du champ "TABLE_Produit"
// La colonne "Désignation" est triée dans l'ordre croissant
// La colonne "Prix" est triée dans l'ordre décroissant
TABLE_Produit.Trie("Désignation", "-Prix")
Syntaxe

Trier un champ Table/Table hiérarchique sur une ou plusieurs colonnes identifiées par leur nom Masquer les détails

<Résultat> = <Champ Table>.Trie(<Nom de la colonne 1> [, <Nom de la colonne 2> [... [, <Nom de la colonne N>]]])
<Résultat> : Booléen
  • Vrai si le tri a été effectué,
  • Faux dans le cas contraire.
<Champ Table> : Nom de champ
Nom du champ à manipuler. Ce champ peut correspondre à :
  • un champ Table.
  • un champ Table hiérarchique.
<Nom de la colonne 1> : Chaîne de caractères avec guillemets
Nom de la première colonne à trier (16 colonnes maximum). Ce paramètre est de la forme :
"[<Sens>]<Nom de la colonne>"

où :
  • <Sens> (caractère) indique le sens du tri :
    • "+" : tri croissant (par défaut),
    • "-" : tri décroissant.
  • <Nom de la colonne> (chaîne de caractères) : nom de la colonne à trier.
<Nom de la colonne 2> : Chaîne de caractères optionnelle avec guillemets
Nom de la seconde colonne à trier (16 colonnes maximum). Ce paramètre est de la forme :
"[<Sens>]<Nom de la colonne>"

où :
  • <Sens> (caractère) indique le sens du tri :
    • "+" : tri croissant (par défaut),
    • "-" : tri décroissant.
  • <Nom de la colonne> (chaîne de caractères) : nom de la colonne à trier.
<Nom de la colonne N> : Chaîne de caractères optionnelle avec guillemets
Nom de la Nème colonne à trier (16 colonnes maximum). Ce paramètre est de la forme :
"[<Sens>]<Nom de la colonne>"

où :
  • <Sens> (caractère) indique le sens du tri :
    • "+" : tri croissant (par défaut),
    • "-" : tri décroissant.
  • <Nom de la colonne> (chaîne de caractères) : nom de la colonne à trier.

Annuler un tri précédemment défini sur un champ Table/Table hiérarchique mémoire Masquer les détails

<Résultat> = <Champ Table>.Trie(<Faux>)
<Résultat> : Booléen
  • Vrai si le tri a été annulé,
  • Faux en cas de problème.
<Champ Table> : Nom de champ
Nom du champ à manipuler. Ce champ peut correspondre à :
  • un champ Table mémoire.
  • un champ Table hiérarchique mémoire.
<Faux> : Constante
Faux : Mot-clé permettant d'annuler un tri précédemment défini sur un champ Table ou Table hiérarchique mémoire.
Remarques

Conditions d'utilisation

La fonction <Table>.Trie peut être utilisée indifféremment sur :
  • un champ mémoire ou fichier avec parcours automatique (option "Parcours automatique" cochée dans l'onglet "Contenu" de la description du champ). Dans le cas d'un champ fichier, le tri est exécuté uniquement sur une seule colonne.
  • un champ monosélection ou multisélection.
    WEBDEV - Code ServeurPHP Rappel : Les champs multisélections sont disponibles uniquement en Ajax. WEBDEV - Code ServeurPHP Rappel : La multisélection n'est pas disponible sur les champs Table en mode classique.
WEBDEV - Code ServeurPHP Cette fonction est disponible pour les champs Table en mode Ajax, les champs Table en mode classique et les champs Table hiérarchique.
WEBDEV - Code Navigateur Cette fonction est disponible uniquement pour les champs Table en mode navigateur.
WEBDEV - Code NavigateurAndroidiPhone/iPad Le champ Table hiérarchique n'est pas disponible.

Trier un champ Table ou Table hiérarchique fichier

Un champ Table ou Table hiérarchique fichier sera trié uniquement selon la première colonne spécifiée (syntaxe 1 et 2). Attention : la colonne utilisée pour le tri doit être reliée à une rubrique clé dans le fichier de données utilisé pour le parcours du champ.
Astuce : Pour trier un champ Table ou Table hiérarchique fichier avec plusieurs colonnes, utilisez une clé composée et la propriété ..RubriqueParcourue :
NomTable..RubriqueParcourue = NOMCLECOMPOSEE
Pour annuler un tri dans un champ Table ou Table hiérarchique fichier, il suffit d'affecter une chaîne vide à la propriété ..RubriqueParcourue.

Gestion d'un champ Table ou Table hiérarchique trié

Rappel : La fonction <Table>.ColonnesTriées permet d'obtenir la liste des colonnes triées.

Tri sur une colonne calculée

Il est déconseillé d'utiliser la fonction <Table>.Trie sur des colonnes calculées. En effet, ces colonnes sont calculées lors de l'affichage de chaque ligne.
Un tri effectué avec la fonction <Table>.Trie sur une colonne calculée sera valide uniquement sur les lignes déjà affichées.

Champ Table ou Table hiérarchique parcouru par programmation

La fonction <Table>.Trie ne fonctionne pas sur un champ parcouru par programmation.

Réaliser un tri basé sur la valeur ASCII

Pour réaliser un tri basé sur la valeur ASCII, il est possible d'utiliser une zone mémoire.
Exemple :
MemCrée("ZM")
MemAjoute("ZM", "abc", "abc")
MemAjoute("ZM", "ZZZ", "ZZZ")
MemAjoute("ZM", "zbc", "zbc")
MemAjoute("ZM", "ééébc", "ééébc")
MemAjoute("ZM", "AB", "AB")
MemAjoute("ZM", "CD", "CD")
MemAjoute("ZM", "çabc", "çabc")
MemAjoute("ZM", "bbc", "bbc")
MemTrie("ZM")
i est un entier
MemPremier("ZM")
TANTQUE PAS MemEnDehors("ZM")
i = MemEnCours("ZM")
Trace(MemRécupère("ZM", i)) // Affichage dans l'ordre ASCII
MemSuivant("ZM")
FIN
Composante : wd240obj.dll
Version minimum requise
  • Version 23
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire