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
  • Zone répétée multisélection
  • Gestion des erreurs
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
Déplace une répétition ou échange deux répétitions d'un champ Zone répétée.
Exemple
// Echange la répétition en cours et la répétition 5
ZR_ZoneRépétée1.DéplaceLigne(ligneSélectionnée, 5, tdEchange)
// Déplace la répétition en cours Ã  la répétition 3
ZR_ZoneRépétée1.DéplaceLigne(ligneSélectionnée, 3, tdDéplace)
// Echange la ligne en cours avec la ligne suivante
ZR_ZoneRépétée1.DéplaceLigne(ligneSélectionnée, tdSuivant, tdEchange)
Syntaxe

Déplacement à une position spécifique Masquer les détails

<Résultat> = <Champ Zone répétée>.DéplaceLigne(<Indice de la répétition à déplacer> , <Indice de la répétition destination> [, <Opération à effectuer>])
<Résultat> : Entier
Nouvel indice de la répétition déplacée.
<Champ Zone répétée> : Nom de champ
Nom du champ Zone répétée à manipuler.
<Indice de la répétition à déplacer> : Entier
Position de la répétition à déplacer. Cette position doit être comprise entre 1 et le nombre de répétitions du champ (connu par exemple par la fonction <Zone répétée>.Occurrence ou la propriété Occurrence).
Pour déplacer la répétition actuellement sélectionnée, utilisez la constante ligneSélectionnée.
<Indice de la répétition destination> : Entier
Nouvelle position de la répétition. Cette position doit être comprise entre 1 et le nombre de répétitions du champ (connu par exemple par la fonction <Zone répétée>.Occurrence ou la propriété Occurrence). Si ce paramètre n'est pas valide, une erreur fatale est générée.
Pour manipuler la répétition actuellement sélectionnée, utilisez la constante ligneSélectionnée.
<Opération à effectuer> : Constante ou combinaison de constantes optionnelle de type Entier
Changement de position de la répétition à effectuer :
tdAfficheDestinationLa répétition modifiée est affichée dans le champ Zone répétée. Si nécessaire, un défilement automatique des répétitions est effectué pour afficher la répétition modifiée. La répétition sélectionnée (bandeau de sélection) n'est pas modifiée.
Cette constante peut être combinée avec les constantes tdDéplace et tdEchange.
tdDéplace
(valeur par défaut)
La répétition est déplacée vers l'indice de la répétition destination.
tdEchangeLa répétition source et la répétition destination sont échangées.

Déplacement relatif à la position en cours Masquer les détails

<Résultat> = <Champ Zone répétée>.DéplaceLigne(<Indice de la répétition à déplacer> , <Déplacement relatif> [, <Opération à effectuer>])
<Résultat> : Entier
Nouvel indice de la répétition déplacée.
<Champ Zone répétée> : Nom de champ
Nom du champ Zone répétée à manipuler.
<Indice de la répétition à déplacer> : Entier
Position de la répétition à déplacer. Cette position doit être comprise entre 1 et le nombre de répétitions du champ (connu par exemple par la fonction <Zone répétée>.Occurrence ou la propriété Occurrence).
Pour déplacer la répétition actuellement sélectionnée, utilisez la constante ligneSélectionnée.
<Déplacement relatif> : Constante de type Entier
Permet de réaliser un déplacement ou un échange sur une position relative à l'indice de la répétition à déplacer.
tdDernierDéplace la répétition en dernière position.
tdPagePrécédenteDéplace la répétition d'une page vers le haut (une page correspond aux nombre de répétitions pouvant être affichées simultanément dans le champ Zone répétée).
tdPageSuivanteDéplace la répétition d'une page vers le bas (une page correspond aux nombre de répétitions pouvant être affichées simultanément dans le champ Zone répétée).
tdPrécédentDéplace la répétition d'une position vers le haut.
tdPremierDéplace la répétition en première position.
tdSuivantDéplace la répétition d'une position vers le bas.

Si ce paramètre est invalide (par exemple utilisation de tdPrécédent sur la première répétition du champ Zone répétée), la répétition est déplacée "au plus proche" de la position demandée.
<Opération à effectuer> : Constante ou combinaison de constantes optionnelle de type Entier
Changement de position de la répétition à effectuer :
tdAfficheDestinationLa répétition modifiée est affichée. Si nécessaire, un défilement automatique des répétitions est effectué pour afficher la répétition modifiée. La répétition sélectionnée (bandeau de sélection) n'est pas modifiée.
Cette constante peut être combinée avec les constantes tdDéplace et tdEchange.
tdDéplace
(valeur par défaut)
La répétition est déplacée vers l'indice de la répétition destination.
tdEchangeLa répétition source et la répétition destination sont échangées.
Remarques

Conditions d'utilisation

La fonction <Zone répétée>.DéplaceLigne peut être utilisée indifféremment sur :
  • un champ Zone répétée fichier chargé en mémoire,
  • 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.
WINDEVEtats et RequêtesUniversal Windows 10 AppAndroidJavaCode Utilisateur (MCU)

Zone répétée multisélection

Si la fonction <Zone répétée>.DéplaceLigne est utilisée sur un champ Zone répétée multisélection :
  • lors du déplacement de répétitions/lignes (constante tdDéplace) : toutes les répétitions/lignes sélectionnées seront déplacées.
  • lors d'un échange de répétitions/lignes (constante tdEchange) : seule la première répétiton/ligne sélectionnée sera échangée.
  • la constante ligneSélectionnée ne peut pas être utilisée. Dans le cas contraire, une erreur fatale est affichée et aucune répétition ne sera déplacée.

Gestion des erreurs

Attention : La fonction <Zone répétée>.DéplaceLigne ne retourne pas de code d'erreur. Pour savoir si cette fonction a généré une erreur, utilisez la fonction ErreurInfo avec la constante errMessage.
Composante : wd300obj.dll
Version minimum requise
  • Version 23
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 16/06/2023

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