DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions Zones répétées
  • Conditions d'utilisation
  • Annulation du tri
  • Tri
  • Zone répétée liée à une source de données et utilisant un parcours programmé
  • Versions précédentes
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
Permet de :
  • Trier un champ Zone répétée selon un ou plusieurs de ses attributs.
  • Trier un champ Zone répétée sur tous ses attributs.
  • Annuler un tri précédemment effectué (c'est-à-dire ne plus tenir compte du tri).
Exemple
// Tri selon un des attributs du champ Zone répétée choisi dans un champ Sélecteur
SELON SEL_SELECT1
CAS 1: ZoneRépétéeTrie("NOM")
CAS 2: ZoneRépétéeTrie("SOCIETE")
CAS 3: ZoneRépétéeTrie("VILLE")
FIN
// Tri par nom par ordre croissant et par date par ordre décroissant
ZoneRépétéeTrie("NOM" + TAB + "-DATE")
// Tri du champ Zone répétée ZR_Client par ordre décroissant sur tous ses attributs
ZoneRépétéeTrie("-ZR_Client")
// Annule le tri précédemment effectué sur le champ Zone répétée ZR_Client
ZoneRépétéeTrie("ZR_Client", Faux)
Syntaxe

Trier un champ Zone répétée selon une liste d'attributs Masquer les détails

<Résultat> = ZoneRépétéeTrie(<Liste d'attributs>)
<Résultat> : Booléen
  • Vrai si le tri a pu s'exécuter,
  • Faux dans le cas contraire.
<Liste d'attributs> : Chaîne de caractères
Nom des attributs selon lesquels le champ Zone répétée doit être trié (jusqu'à 10 attributs maximum). Cette chaîne de caractères doit être de la forme :
"[<Sens>]<Attribut 1>" + TAB + "[<Sens>]<Attribut 2>" + TAB + ...
avec :
  • <Sens> : sens du tri (optionnel), peut prendre les valeurs suivantes :
    • "+" : le tri sera croissant (valeur par défaut).
    • "-" : le tri sera décroissant.
  • <Attribut> : nom de l'attribut utilisé pour le tri.
WEBDEV - Code Navigateur En code navigateur, le tri peut être effectué uniquement sur un seul attribut.

Trier ou annuler le tri d'un champ Zone répétée Masquer les détails

<Résultat> = ZoneRépétéeTrie([<Sens>]<Zone répétée> [, <Indicateur>])
<Résultat> : Booléen
  • Vrai si le tri a pu s'exécuter ou être annulé,
  • Faux dans le cas contraire.
<[<Sens>]<Zone répétée>> : Chaîne de caractères (entre guillemets)
Nom du champ Zone répétée à trier.
  • Si <Sens> est égal à "+", le champ Zone répétée sera trié dans l'ordre croissant (par défaut).
  • Si <Sens> est égal à "-", le champ Zone répétée sera trié dans l'ordre décroissant.
<Indicateur> : Booléen optionnel
  • Vrai pour effectuer le tri (valeur par défaut),
  • Faux pour annuler un tri précédemment effectué.
Remarques

Conditions d'utilisation

La fonction ZoneRépétéeTrie peut être utilisée indifféremment sur :
  • un champ Zone répétée fichier,
  • un champ Zone répétée par programmation.
WEBDEV - Code Navigateur Cette fonction n'est pas disponible sur les champs Zone répétée linéaire. Cette fonction est disponible uniquement sur les champs Zone répétée en mode navigateur.
WEBDEV - Code ServeurPHP Cette fonction est disponible pour les champs Zone répétée en mode Ajax, les champs Zone répétée en mode classique et les champs Zone répétée linéaire.

Annulation du tri

Tri

Le prochain ajout d'une répétition dans le champ Zone répétée (fonctions ZoneRépétéeAjoute, ZoneRépétéeAjouteLigne, ZoneRépétéeInsère et ZoneRépétéeInsèreLigne) tient compte du tri.

Zone répétée liée à une source de données et utilisant un parcours programmé

La fonction ZoneRépétéeTrie ne fonctionne pas sur un champ Zone répétée ayant les caractéristiques suivantes :
  • champ Zone répétée lié à une source de données,
  • champ Zone répétée utilisant l'option Parcours programmé (onglet "Contenu" de la fenêtre de description du champ).
Pour changer l'ordre d'affichage d'un champ Zone répétée avec parcours programmé, il est nécessaire d'adapter le code se trouvant dans les différents traitements de lecture du champ Zone répétée (traitements lecture du premier, du suivant, du précédent, ...).
WEBDEV - Code Serveur

Versions précédentes

Cette fonction remplace la fonction ZoneRépétéTri, conservée par compatibilité avec WEBDEV 1.5.
Composante : wd300obj.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 22/12/2023

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