PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE


  • Conditions d'utilisation
  • Champ Table multisélection
  • Champ Table horizontale
  • Gestion des erreurs
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Déplace une ligne ou échange deux lignes dans un champ Table. Pour déplacer les colonnes dans un champ Table, utilisez la fonction TableDéplaceColonne.
Versions 16 et supérieures
WINDEVLinux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
Nouveauté 16
WINDEVLinux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
WINDEVLinux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
Versions 19 et supérieures
WEBDEV - Code Navigateur Cette fonction est désormais disponible en code Navigateur pour les champs Table en mode navigateur.
Nouveauté 19
WEBDEV - Code Navigateur Cette fonction est désormais disponible en code Navigateur pour les champs Table en mode navigateur.
WEBDEV - Code Navigateur Cette fonction est désormais disponible en code Navigateur pour les champs Table en mode navigateur.
Versions 20 et supérieures
Android Cette fonction est désormais disponible pour les applications Android.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Nouveauté 20
Android Cette fonction est désormais disponible pour les applications Android.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Android Cette fonction est désormais disponible pour les applications Android.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Exemple
// Echange la ligne en cours et la ligne 5
TableDéplaceLigne(TABLE_Table1, ligneSélectionnée, 5, tdEchange)
// Déplace la ligne en cours à la ligne 3
TableDéplaceLigne(TABLE_Table1, ligneSélectionnée, 3, tdDéplace)
// Echange la ligne en cours avec la ligne suivante
TableDéplaceLigne(TABLE_Table1, ligneSélectionnée, tdSuivant, tdEchange)
Syntaxe

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

<Résultat> = TableDéplaceLigne(<Champ Table> , <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 Table> : Nom de champ
Nom du champ Table à manipuler.
Si ce paramètre correspond à une chaîne vide (""), le champ Table manipulé est le 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 Table (connu par exemple par la fonction TableOccurrence 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 Table (connu par exemple par la fonction TableOccurrence 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 :
tdAfficheDestinationLa ligne modifiée est affichée dans le champ Table. Si nécessaire, un défilement automatique des lignes est effectué pour afficher la ligne modifiée dans le champ Table. 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.
WEBDEV - Code ServeurPHP Table en mode Ajax : La ligne modifiée sera toujours affichée en haut du champ Table.
tdDéplace
(valeur par défaut)
La ligne est déplacée vers l'indice de la ligne destination.
tdEchangeLes lignes source et destination sont échangées.
WINDEVWEBDEV - Code ServeurAndroidiPhone/iPadWindows MobileJavaPHPAjaxCode Utilisateur (MCU)

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

<Résultat> = TableDéplaceLigne(<Champ Table> , <Indice de la ligne à déplacer> , <Déplacement relatif> [, <Opération à effectuer>])
<Résultat> : Entier
Nouvel indice de la ligne déplacée.
<Champ Table> : Nom de champ
Nom du champ Table à manipuler.
Si ce paramètre correspond à une chaîne vide (""), le champ Table manipulé est le 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 Table (connu par exemple par la fonction TableOccurrence 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.
tdDernierDéplace la ligne en dernière position.
tdPagePrécédenteDé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 Table).
tdPageSuivanteDé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 Table).
tdPrécédentDéplace la ligne d'une position vers le haut.
tdPremierDéplace la ligne en première position.
tdSuivantDéplace la ligne d'une position vers le bas.

Si ce paramètre est invalide (par exemple utilisation de la constante tdPrécédent sur la première ligne du champ Table), la ligne 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 ligne à effectuer :
tdAfficheDestinationLa ligne modifiée est affichée dans le champ Table. Si nécessaire, un défilement automatique des lignes est effectué pour afficher la ligne modifiée dans le champ Table. 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.
WEBDEV - Code ServeurPHP Table en mode Ajax : La ligne modifiée sera toujours affichée en haut du champ Table.
tdDéplace
(valeur par défaut)
La ligne est déplacée vers l'indice de la ligne destination.
tdEchangeLes lignes source et destination sont échangées.
Remarques

Conditions d'utilisation

La fonction TableDéplaceLigne peut être utilisée sur :
  • un champ Table mémoire.
  • un champ Table fichier chargé en mémoire.
  • WINDEVEtats et RequêtesWindows MobileJavaCode Utilisateur (MCU) un champ Table horizontale.
  • WEBDEV - Code ServeurPHP un champ Table en mode Ajax ou un champ Table en mode classique.
  • WEBDEV - Code Navigateur un champ Table en mode navigateur.
Cette fonction ne peut pas être utilisée sur les champs Table hiérarchique, ni sur les champs Table fichier (accès direct).
Remarques : Déplacement d'une ligne selon le type de champ :
  • Versions 18 et supérieures
    Pour déplacer une ligne d'un champ Table hiérarchique, utilisez la fonction TableDéplaceBranche.
    Nouveauté 18
    Pour déplacer une ligne d'un champ Table hiérarchique, utilisez la fonction TableDéplaceBranche.
    Pour déplacer une ligne d'un champ Table hiérarchique, utilisez la fonction TableDéplaceBranche.
  • Pour déplacer une ligne d'un champ Liste ou Combo, utilisez la fonction ListeDéplaceLigne.
  • Pour déplacer une répétition d'un champ Zone répétée, utilisez la fonction ZoneRépétéeDéplaceLigne.

Champ Table multisélection

Si la fonction TableDéplaceLigne est utilisée sur un champ Table multisélection :
  • lors d'un déplacement de ligne (constante tdDéplace) : seule la première ligne sélectionnée est déplacée.
  • 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.
WINDEVEtats et RequêtesWindows MobileJavaCode Utilisateur (MCU)

Champ Table horizontale

Si la fonction TableDéplaceLigne est utilisée sur un champ Table horizontale, les éléments déplacés seront les colonnes.
Pour déplacer les lignes d'un champ Table horizontale, utilisez la fonction TableDéplaceColonne.

Gestion des erreurs

Attention : La fonction TableDé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.
WEBDEV - Code Navigateur La fonction ErreurInfo n'est pas disponible.
Composante : wd240obj.dll
Version minimum requise
  • Version 14
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire