DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions Table
  • Caractéristiques des éléments de la colonne
  • Position de la colonne ajoutée
  • Limites : Nombre maximum de colonnes affichées
  • Champ Table fichier : Modifications dans le fichier de données lié
  • Champ Table fichier : Ajout de plusieurs colonnes
  • Ajout dans un champ Table fichier et Trigger
  • Ajout d'une image
  • Champ Table en saisie
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
Ajoute des éléments à droite d'un champ Table horizontale.
Attention : Cette fonction ne permet pas d'ajouter des colonnes dans un champ Table standard (champ Table verticale). Pour ajouter dynamiquement des colonnes dans un champ Table standard, utilisez la fonction ChampClone.
Syntaxe
<Résultat> = TableAjouteColonne(<Champ Table> [, <Élément ligne 1> [... [, <Élément ligne N>]]])
<Résultat> : Entier
  • Indice de la colonne ajoutée,
  • -1 en cas d'erreur.
<Champ Table> : Nom de champ
Nom du champ Table horizontale à manipuler.
Si ce paramètre correspond à une chaîne vide (""), le champ Table manipulé est le champ auquel le traitement en cours appartient.
<Élément ligne 1> : Type de la ligne associée (optionnel)
Éléments de la colonne à ajouter dans le champ Table spécifié. Chaque élément correspond à une ligne. Le type de l'élément ajouté doit être compatible avec le type de la ligne concernée.
Si aucun de ces paramètres n'est spécifié, une colonne vide est ajoutée dans le champ Table. Pour un champ Table fichier, les valeurs par défaut définies dans le fichier de données lié sont prises en compte.
<Élément ligne N> : Type de la colonne associée (optionnel)
Éléments de la colonne à ajouter dans le champ Table spécifié. Chaque élément correspond à une ligne. Le type de l'élément ajouté doit être compatible avec le type de la ligne concernée.
Si aucun de ces paramètres n'est spécifié, une colonne vide est ajoutée dans le champ Table. Pour un champ Table fichier, les valeurs par défaut définies dans le fichier de données lié sont prises en compte.
Remarques

Caractéristiques des éléments de la colonne

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

Position de la colonne ajoutée

Par défaut, la colonne est ajoutée à la fin du champ Table.
  • Si le champ Table est trié avec la fonction TableTrie, la colonne ajoutée est positionnée dans le champ en fonction du tri en cours.
  • Si le champ Table est trié par l'utilisateur, le tri n'est pas pris en compte lors de l'ajout de la colonne. La colonne est ajoutée à la fin du champ.

Limites : Nombre maximum de colonnes affichées

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

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

Si la saisie en cascade est activée, le fichier de données lié au champ Table fichier est automatiquement modifié lorsque l'utilisateur passe à la colonne suivante.
Si la saisie en cascade n'est pas activée, le fichier de données lié au champ Table fichier n'est pas modifié. Pour écrire le contenu de la colonne ajoutée dans le fichier de données lié, il est nécessaire d'utiliser la fonction TableEnregistre après la fonction TableAjouteColonne.
Rappel : L'option "Saisie en cascade (Ajout)" peut être sélectionnée :
  • Lors de la création d'un champ Table.
  • Dans l'onglet "Détail" de la description du champ.

Champ Table fichier : Ajout de plusieurs colonnes

A chaque appel de la fonction TableAjouteColonne dans un champ Table fichier, une colonne virtuelle est créée dans le champ. Les informations seront enregistrées dans le fichier de données uniquement lors de l'appel de la fonction TableEnregistre.
Si la fonction TableAjouteColonne 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 colonne est ajoutée dans le champ Table fichier.

Ajout dans un champ Table fichier et Trigger

Il est possible de déclencher un trigger lors de l'ajout d'un enregistrement dans un champ Table fichier. Pour plus de détails, consultez la documentation de HDécritTrigger.

Ajout d'une image

Pour ajouter une image dans un champ Table, spécifiez directement le nom et le chemin complet de l'image à ajouter.
Par exemple :
TableAjouteColonne(TABLE_MaTable, "C:\MesDocuments\MonImage.BMP")

Remarque : Pour afficher correctement l'image ajoutée, la ligne doit être de type Image.

Champ Table en saisie

Si la fonction TableAjouteColonne est appelée :
  • Dans un événement du champ Table, le curseur est automatiquement positionné sur la première ligne à saisir dans la colonne ajoutée.
  • Dans un événement n'appartenant pas au champ Table (ou dans un traitement personnalisé), utilisez la fonction DonneFocusEtRetourUtilisateur pour reprendre la saisie dans le champ Table.
Composante : wd290obj.dll
Version minimum requise
  • Version 12
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