|
|
|
|
|
|
|
|
|
|
- Conditions d'utilisation
- Zone répétée multisélection
- Gestion des erreurs
<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.
ZR_ZoneRépétée1.DéplaceLigne(ligneSélectionnée, 5, tdEchange)
ZR_ZoneRépétée1.DéplaceLigne(ligneSélectionnée, 3, tdDéplace)
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 : | | | tdAfficheDestination | La 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. | | tdEchange | La 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. | | | tdDernier | Déplace la répétition en dernière position. | | tdPagePrécédente | Dé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). | | tdPageSuivante | Dé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édent | Déplace la répétition d'une position vers le haut. | | tdPremier | Déplace la répétition en première position. | | tdSuivant | Dé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 : | | | tdAfficheDestination | La 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. | | tdEchange | La 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.
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
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|