DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions Table
  • Conditions d'utilisation
  • Caractéristiques des éléments de la ligne
  • Position de la ligne insérée
  • Limites : Nombre maximum de lignes affichées
  • Champ Table/Table hiérarchique fichier : Modifications dans le fichier de données lié
  • Champ Table/Table hiérarchique fichier : Insertion de plusieurs lignes
  • Champ Table/Table hiérarchique en saisie
  • Insertion d'image
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
Insère une ligne dans un champ Table ou un champ Table hiérarchique avec une animation. La durée de cette animation est paramétrable :
  • dans l'onglet "Style" de la fenêtre de description du champ Table :
    • Dans l'onglet "Style", sélectionnez l'élément "Animation de champ".
    • Dans la liste des animations, sélectionnez "Modification par TableXXXAvecAnimation()" et cliquez sur le bouton "Paramètres".
  • dans la fenêtre de description du projet :
    • Dans l'onglet "Avancé", cliquez sur le bouton "Animations des champs".
    • Dans la zone "Champ table et zone répétée", sélectionnez "Modification par TableXXXAvecAnimation()" et cliquez sur le bouton "Paramètres".
Remarques :
Exemple
// Insertion des éléments "Paul" et "Dubois" dans la cinquième
// ligne du champ Table "TABLE_TableClient"
TableInsèreLigneAvecAnimation(TABLE_TableClient, 5, "Paul", "Dubois")
Syntaxe
TableInsèreLigneAvecAnimation(<Champ Table> [, <Indice> [, <Élément colonne 1> [... [, <Élément colonne N>]]]])
<Champ Table> : Nom de champ
Nom du champ à manipuler. Ce champ peut correspondre à :
  • un champ Table.
  • un champ Table hiérarchique.
Si ce paramètre correspond à une chaîne vide (""), le champ manipulé sera le champ auquel appartient l'événement en cours.
<Indice> : Entier optionnel
Indice de la ligne dans laquelle les éléments doivent être insérés. La première ligne a pour indice 1.
Indice non préciséLa ligne est insérée avant la ligne en cours. Si aucune ligne n'est sélectionnée, la ligne est insérée à la fin du champ.
Indice supérieur au nombre de lignes du champLa ligne est insérée à la fin du champ.
Indice égal à 0La ligne est insérée au début du champ.
Indice égal à -1La ligne est insérée avant la ligne en cours.
<Élément colonne 1> : Type de la colonne associée (optionnel)
Premiers éléments de la ligne à insérer dans le champ spécifié. Chaque élément correspond à une colonne du champ. Le type de l'élément inséré doit être compatible avec le type de la colonne concernée.
Si aucun de ces paramètres n'est spécifié, une ligne vide est ajoutée dans le champ. Pour un champ fichier, les valeurs par défaut définies dans le fichier de données lié sont prises en compte.
<Élément colonne N> : Type de la colonne associée (optionnel)
Nèmes éléments de la ligne à insérer dans le champ spécifié. Chaque élément correspond à une colonne du champ. Le type de l'élément inséré doit être compatible avec le type de la colonne concernée.
Si aucun de ces paramètres n'est spécifié, une ligne vide est ajoutée dans le champ. Pour un champ fichier, les valeurs par défaut définies dans le fichier de données lié sont prises en compte.
Remarques

Conditions d'utilisation

La fonction TableInsèreLigneAvecAnimation peut être utilisée indifféremment sur :
  • un champ Table ou Table hiérarchique fichier.
  • un champ Table ou Table hiérarchique par programmation.
  • un champ monosélection ou multisélection.
L'animation n'est pas jouée dans les cas suivants :
  • si les animations sont désactivées (fonction AnimationActive).
  • si la fonction est utilisée dans les traitements suivants de la fenêtre : "Déclarations globales", "Fin d'initialisation" ou "Fermeture".
  • si l'application est en mode TSE.
  • si l'insertion est effectué en dehors de la zone visible (en-dessous ou au-dessus). Dans ce cas, l'insertion est réalisée et la fonction rend la main immédiatement.
La fonction ne rend la main qu'à la fin de l'animation.

Caractéristiques des éléments de la ligne

  • Pour ne pas spécifier de valeur pour un des éléments, utilisez une chaîne vide ("") ou 0 (selon le type de la colonne).
  • Si un élément correspond au résultat d'un calcul, mettez l'expression numérique entre parenthèses. Par exemple :
    TableInsèreLigneAvecAnimation(TABLE_TableCalcul, 3, (53+29), (83-21))

Position de la ligne insérée

Par défaut, la ligne est insérée à la position indiquée.
Cas particuliers :
  • Si le champ est trié avec la fonction TableTrie, la ligne insérée est positionnée dans le champ en fonction du tri en cours et non de l'indice spécifié.
  • Si le champ est trié par l'utilisateur, le tri n'est pas pris en compte lors de l'insertion de la ligne. La ligne est insérée à la position indiquée.

Limites : Nombre maximum de lignes affichées

Le nombre maximum de lignes pouvant être affichées dans un champ Table ou Table hiérarchique est limité uniquement par la mémoire vive disponible (maximum théorique : 2 milliards de lignes).
Il est cependant déconseillé d'utiliser des champs Table ou Table hiérarchique avec un nombre de lignes important pour des raisons de performance (temps nécessaire pour remplir le champ par exemple) et d'utilisabilité.

Champ Table/Table hiérarchique fichier : Modifications dans le fichier de données lié

  • Si la saisie en cascade est activée, le contenu du fichier de données lié au champ est automatiquement modifié lorsque l'utilisateur passe à la ligne suivante.
  • Si la saisie en cascade n'est pas activée, le contenu du fichier de données lié au champ n'est pas modifié. Pour écrire le contenu de la ligne insérée dans le fichier de données lié, il est nécessaire d'utiliser la fonction TableEnregistre après la fonction TableInsèreLigneAvecAnimation.
Remarque : L'option "Saisie en cascade (Ajout)" peut être sélectionnée dans l'onglet "Détail" de la description du champ.

Champ Table/Table hiérarchique fichier : Insertion de plusieurs lignes

A chaque appel de la fonction TableInsèreLigneAvecAnimation dans un champ Table ou Table hiérarchique fichier, une ligne virtuelle est créée dans le champ. Les informations ne seront enregistrées dans le fichier de données que lors de l'appel de la fonction TableEnregistre.
Si la fonction TableInsèreLigneAvecAnimation est appelée successivement dans le même traitement sans être suivie de la fonction TableEnregistre, seul le PREMIER appel est effectif (les appels suivants sont ignorés). Une seule ligne est ajoutée dans le champ Table/Table hiérarchique fichier.

Champ Table/Table hiérarchique en saisie

Si la fonction TableInsèreLigneAvecAnimation est appelée :
  • Dans un événement du champ, le curseur est automatiquement positionné sur la première colonne à saisir dans la ligne insérée.
  • Dans un événement n'appartenant pas au champ (ou dans un autre traitement), utilisez la fonction DonneFocusEtRetourUtilisateur pour reprendre la saisie dans le champ Table ou Table hiérarchique.

Insertion d'image

Pour insérer une image dans un champ Table ou Table hiérarchique, spécifiez directement le nom et le chemin complet de l'image à insérer.
Par exemple :
TableInsèreLigneAvecAnimation(TABLE_MaTable, 5, "C:\MesDocuments\MonImage.BMP")
Remarque : Pour afficher correctement l'image insérée, la colonne doit être de type Image.
Classification Métier / UI : Code UI
Composante : wd290obj.dll
Version minimum requise
  • Version 22
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

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