|
|
|
|
|
|
|
|
|
|
- Fonctionnement sur un champ Combo
- Champ Liste multisélection
- Gestion des erreurs
ListeDéplaceLigne (Fonction) En anglais : ListMoveLine Déplace une ligne ou échange deux lignes d'un champ Liste ou Combo. Remarques :
ListeDéplaceLigne(LISTE_Liste1, ligneSélectionnée, 5, tdEchange)
ListeDéplaceLigne(LISTE_Liste1, ligneSélectionnée, 3, tdDéplace)
ListeDéplaceLigne(LISTE_Liste1, ligneSélectionnée, tdSuivant, tdEchange)
Syntaxe
Déplacement à une position spécifique Masquer les détails
<Résultat> = ListeDéplaceLigne(<Champ Liste> , <Indice de la ligne à  déplacer> , <Indice de la ligne destination> [, <Opération à  effectuer>])
<Résultat> : Entier Nouvel indice de la ligne déplacée. <Champ Liste> : Nom de champ Nom du champ Liste ou Combo à manipuler.
Si ce paramètre correspond à une chaîne vide (""), le champ manipulé correspond au champ auquel appartient l'événement en cours. <Indice de la ligne à déplacer> : Entier Position de la ligne à déplacer. Cette position doit être comprise entre 1 et le nombre de lignes du champ Liste ou Combo (connu par exemple par la fonction ListeOccurrence ou la propriété Occurrence).Pour déplacer la ligne actuellement sélectionnée, utilisez la constante ligneSélectionnée. <Indice de la ligne destination> : Entier Nouvelle position de la ligne. Cette position doit être comprise entre 1 et le nombre de lignes du champ Liste ou Combo (connu par exemple par la fonction ListeOccurrence ou la propriété Occurrence). Si ce paramètre n'est pas valide, une erreur fatale est générée.Pour manipuler la ligne 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 ligne à effectuer : | | | tdAfficheDestination | La ligne modifiée est affichée dans le champ Liste (ou Combo). Si nécessaire, un défilement automatique des lignes est effectué pour afficher la ligne modifiée. La ligne 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 ligne est déplacée vers l'indice de la ligne destination. | | tdEchange | La ligne source et destination sont échangées. |
Déplacement relatif à la position en cours Masquer les détails
<Résultat> = ListeDéplaceLigne(<Champ Liste> , <Indice de la ligne à  déplacer> , <Déplacement relatif> [, <Opération à  effectuer>])
<Résultat> : Entier - Nouvel indice de la ligne déplacée,
- 0 en cas d'erreur.
<Champ Liste> : Nom de champ Nom du champ Liste à manipuler.
Si ce paramètre correspond à une chaîne vide (""), le champ manipulé correspond au champ auquel appartient l'événement en cours. <Indice de la ligne à déplacer> : Entier Position de la ligne à déplacer. Cette position doit être comprise entre 1 et le nombre de lignes du champ Liste (connu par exemple par la fonction ListeOccurrence ou la propriété Occurrence).Pour manipuler la ligne 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 ligne à déplacer. | | | tdDernier | Déplace la ligne en dernière position. | | tdPagePrécédente | Déplace la ligne d'une page vers le haut (une page correspond au nombre de lignes pouvant être affichées simultanément dans le champ Liste).
| | tdPageSuivante | Déplace la ligne d'une page vers le bas (une page correspond au nombre de lignes pouvant être affichées simultanément dans le champ Liste).
| | tdPrécédent | Déplace la ligne d'une position vers le haut. | | tdPremier | Déplace la ligne en première position. | | tdSuivant | Déplace la ligne d'une position vers le bas. |
Si ce paramètre est invalide (par exemple utilisation de tdPrécédent sur la première ligne du champ Liste), la ligne est déplacée "au plus proche". <Opération à effectuer> : Constante ou combinaison de constantes optionnelle de type Entier Changement de position de la ligne à effectuer : | | | tdAfficheDestination | La ligne modifiée est affichée dans le champ Liste. Si nécessaire, un défilement automatique des lignes est effectué pour afficher la ligne modifiée. La ligne 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 ligne est déplacée vers l'indice de la ligne destination. | | tdEchange | La ligne source et destination sont échangées. |
Remarques Fonctionnement sur un champ Combo Lorsque la fonction ListeDéplaceLigne est utilisée sur un champ Combo, l'élément sélectionné reste le même. L'indice de l'élément sélectionné dans la liste déroulée (c'est-à -dire la valeur renvoyée par le champ Combo) est modifié. Champ Liste multisélection Si la fonction ListeDéplaceLigne est utilisée sur un champ Liste multisélection : - lors d'un déplacement de lignes (constante tdDéplace) : toutes les lignes sélectionnées seront déplacées.
- lors d'un échange de lignes (constante tdEchange) : seule la première ligne va être é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 ligne n'est déplacée.
Gestion des erreurs Attention : La fonction ListeDé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…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|