PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget iOSApple WatchCatalystUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
TableTri (Fonction)
En anglais : TableSort_55
La fonction TableTri est conservée uniquement pour compatibilité.
Dans cette version, utilisez la fonction TableTrie.
Voici la documentation de la fonction TableTri.
 
But
Trier une table mémoire sur une ou plusieurs colonnes
Syntaxe
  • Syntaxe 1 : Trier une table sur plusieurs colonnes

    <Résultat> = TableTri(<Liste_Colonnes>)
    • <Résultat> est un booléen qui retourne le résultat du tri
    • <Liste Colonnes> est une chaîne de caractères contenant le nom des colonnes à trier (10 colonnes maxi).<Liste_Colonnes> est de la forme :
      [<sens>]<Colonne1>+TAB+[<sens>]<Colonne2>+TAB+...
      • <sens> est le sens du tri (optionnel), il peut prendre pour valeur + (croissant) ou - (décroissant)
      • <Colonne> est le nom de la colonne à trier
  • Syntaxe 2 : Trier une table

    <Résultat> = TableTri([<sens>]<Table> [,<Indicateur>])
    • <Résultat> est un booléen qui retourne le résultat du tri
    • <Table> est le nom de la table à trier
    • <indicateur> est un booléen qui permet d'annuler ou non le tri
Détail
<Résultat> vaut Vrai, si le tri a pu s'exécuter, et Faux sinon (si les paramètres sont incorrects...).
  • Syntaxe 1 : <Résultat> = TableTri(<Liste_Colonnes>)
    • Le tri s'effectue uniquement sur les colonnes précisées dans <Liste colonnes>. La première colonne servant au tri est la première indiquée, la deuxième...
    • Dans <Liste colonnes>, si le signe + est présent devant le nom d'une colonne, le tri se fera dans l'ordre croissant pour cette colonne.
    • Dans <Liste colonnes>, si le signe - est présent devant le nom d'une colonne, le tri se fera dans l'ordre décroissant pour cette colonne.
    • Par défaut le tri se fait dans l'ordre croissant.
  • Syntaxe 2 : <Résultat> = TableTri([<sens>]<Table> [,<Indicateur>])
    • Le tri se fait sur les 10 premières colonnes visibles de la table, si elles existent. La première colonne servant au tri est la colonne visible se trouvant à gauche dans la table.
    • Si le signe + est présent devant le nom de la table, le tri se fera dans l'ordre croissant pour les 10 colonnes visibles de la table.
    • Si le signe - est présent devant le nom de la table, le tri se fera dans l'ordre décroissant pour les 10 colonnes visibles de la table.
    • Par défaut le tri se fait dans l'ordre croissant
    • Si <Indicateur> est à Vrai (valeur par défaut), le tri est effectué.
    • Si <Indicateur> est à Faux, le tri est annulé.
    • <Indicateur> à Faux permet donc d'annuler un tri qui a été précédemment demandé.
    • Après l'annulation du tri (avec <Indicateur> à Faux), l'ordre des lignes de la table n'est pas modifié, mais les lignes qui seront ajoutées par TableAjoute ou TableInsere ne seront pas triées.
Notes
  • Si la table a été définie "triable" sous l'éditeur, la table peut être triée sur une colonne en cliquant sur le titre de la colonne.
  • Une case de colonne combo qui n'a aucun indice sélectionné est considérée comme vide.
  • TableTri permet de trier une table, que la table ait été définie sous l'éditeur triable ou non triable.
  • Il est déconseillé d'utiliser la fonction TableTri 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 TableTri sur ces colonnes ne sera valide que sur les lignes déjà affichées.
  • Pour les colonnes de type combo, le tri est fonction du contenu de la combo et non pas de l'indice de la combo.
  • Les combos dans les tables étant graphiques, le contenu de la combo qui va servir de critère de tri doit être décrit par gARécuperer.
  • Lorsque la table est triée (par TableTri ou par un clic de la souris), les ajouts dans la table par TableAjoute ou TableInsère tiennent compte du tri.
  • Le tri n'est pas annulé par TableSupprime, TableSupprimeTout, TableAffiche, TableCherche, TableAjuste, TableOccurrence, TablePosition, TableSelect, TableSelectPlus.
  • Important : si une colonne est modifiée (par saisie dans la colonne ou par TableModifie) et si cette colonne est triée, le tri sur la colonne est annulé.
Composante : wd250obj.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire