|
|
|
|
|
- Gestion d'un champ Table hiérarchique trié
TableTrieFils (Fonction) En anglais : TableSortChild Trie une branche d'un champ Table hiérarchique sur une ou plusieurs colonnes.
TableTrieFils(TABLEH_Produit, Null, "Désignation", "-Prix")
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é - Lorsqu'un champ Table hiérarchique est trié par la fonction TableTrieFils, les ajouts dans le champ réalisés par les fonctions TableAjoute, TableAjouteLigne, TableAjouteFils, TableInsère, TableInsèreLigne ou TableInsèreFils tiennent compte du tri.
- Lorsqu'un champ Table hiérarchique est trié par un clic de souris, les ajouts dans le champ réalisés par les fonctions TableAjoute, TableAjouteLigne, TableAjouteFils, TableInsère, TableInsèreLigne ou TableInsèreFils ne tiennent pas compte du tri.
- Le tri n'est pas annulé par les fonctions TableAffiche, TableAjuste, TableCherche, TableOccurrence, TablePosition, TableSelect, TableSelectMoins, TableSelectPlus, TableSupprime et TableSupprimeTout.
- Le tri est annulé :
Classification Métier / UI : Code UI Composante : wd300obj.dll
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|