DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions Table hiérarchique
  • Gestion d'un champ Table hiérarchique trié
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Trie une branche d'un champ Table hiérarchique sur une ou plusieurs colonnes.
Exemple
// Tri des colonnes "Désignation" et "Prix" dans le champ "TABLEH_Produit"
// La colonne "Désignation" est triée dans l'ordre croissant
// La colonne "Prix" est triée dans l'ordre décroissant
TableTrieFils(TABLEH_Produit, Null, "Désignation", "-Prix")
// Tri de la branche selon le prix décroissant
TableTrieFils(TABLEH_Produit, "Plomberie" + TAB + "Robinets", "Désignation", "-Prix")
Syntaxe

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

<Résultat> = TableTrieFils(<Champ Table hiérarchique> , <Branche à trier> , <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 hiérarchique> : Nom de champ
Nom du champ Table hiérarchique à manipuler.
Si ce paramètre correspond à une chaîne vide (""), le champ manipulé est le champ auquel appartient l'événement en cours.
<Branche à trier> : Entier ou chaîne de caractères
Si ce paramètre est un entier, il correspond à l'indice du parent contenant la branche à trier.
Si ce paramètre correspond à NULL, le tri est effectué sur les éléments "Racine".
Si ce paramètre correspond à une chaîne de caractères, il correspond à l'élément parent contenant la branche à trier.
<Nom de la colonne 1> : Chaîne de caractères
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
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
Nom de la Niè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.

Trier une branche d'un champ Table hiérarchique selon une liste de noms de colonnes Masquer les détails

<Résultat> = TableTrieFils(<Liste des colonnes> , <Branche à trier>)
<Résultat> : Booléen
  • Vrai si le tri a été effectué,
  • Faux dans le cas contraire.
<Liste des colonnes> : Chaîne de caractères
Liste des colonnes à trier (16 colonnes maximum). Ce paramètre est de la forme :
"[<Sens>]<Nom de la colonne1> + TAB + [<Sens>]<Nom de la colonne2> + TAB + ..." 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. Le nom d'une colonne peut être obtenu avec la fonction TableEnumèreColonne.
<Branche à trier> : Entier ou chaîne de caractères
Si ce paramètre est un entier, il correspond à l'indice du parent contenant la branche à trier.
Si ce paramètre correspond à NULL, le tri est effectué sur les éléments "Racine".
Si ce paramètre correspond à une chaîne de caractères, il correspond à l'élément parent contenant la branche à trier.

Trier une branche d'un champ Table hiérarchique sur les dix premières colonnes visibles Masquer les détails

<Résultat> = TableTrieFils(<Champ Table hiérarchique> , <Branche à trier> [, <A trier>])
<Résultat> : Booléen
  • Vrai si le tri a été effectué,
  • Faux dans le cas contraire.
<Champ Table hiérarchique> : Nom de champ
Nom du champ Table hiérarchique à trier. Ce paramètre est de la forme :
"[<Sens>]<Champ Table hiérarchique>" où :
  • <Sens> (caractère) indique le sens du tri :
    • "+" : tri croissant (par défaut),
    • "-" : tri décroissant.
  • <Champ Table hiérarchique> (chaîne de caractères) : nom du champ Table hiérarchique à trier.
<Branche à trier> : Entier ou chaîne de caractères
Si ce paramètre est un entier, il correspond à l'indice du parent contenant la branche à trier.
Si ce paramètre correspond à NULL, le tri est effectué sur les éléments "Racine".
Si ce paramètre correspond à une chaîne de caractères, il correspond à l'élément parent contenant la branche à trier.
<A trier> : Booléen optionnel
Remarques

Gestion d'un champ Table hiérarchique trié

Classification Métier / UI : Code UI
Composante : wd290obj.dll
Version minimum requise
  • Version 12
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale