PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • Conditions d'utilisation
  • Gestion des erreurs
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
<Zone répétée>.DéplaceLigne (Fonction)
En anglais : <Looper>.MoveLine
Déplace une répétition ou échange deux répétitions d'un champ Zone répétée.
Versions 16 et supérieures
Linux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
Nouveauté 16
Linux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
Linux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
Versions 17 et supérieures
WEBDEV - Code Navigateur Cette fonction est désormais disponible en code Navigateur.
Nouveauté 17
WEBDEV - Code Navigateur Cette fonction est désormais disponible en code Navigateur.
WEBDEV - Code Navigateur Cette fonction est désormais disponible en code Navigateur.
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 ou un champ Zone répétée mémoire.
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.

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 : wd250obj.dll
Version minimum requise
  • Version 23
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire