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 insérée
  • Limites : Nombre maximum de colonnes affichées
  • Champ Table fichier : Modifications dans le fichier de données lié
  • Champ Table fichier : Insertion de plusieurs colonnes
  • Insertion 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
TableInsèreColonne (Fonction)
En anglais : TableInsertColumn
Insère des éléments sous forme de colonne dans un champ Table horizontale.
Attention : Cette fonction ne permet pas d'insérer des colonnes dans un champ Table standard. Pour ajouter dynamiquement des colonnes dans un champ Table standard, utilisez la fonction ChampClone.
Syntaxe
TableInsèreColonne(<Champ Table> [, <Indice> [, <Élément colonne 1> [... [, <Élément colonne N>]]]])
<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 Table auquel appartient l'événement en cours.
<Indice> : Entier optionnel
Indice de la colonne dans laquelle les éléments doivent être insérés. La première colonne a pour indice 1.
Indice non préciséLa colonne est insérée avant la colonne en cours. Si aucune colonne n'est sélectionnée, la colonne est insérée à la fin du champ Table.
Indice supérieur au nombre de colonnes du champ TableLa colonne est insérée à la fin du champ Table.
Indice égal à 0La colonne est insérée au début du champ Table.
Indice égal à -1La colonne est insérée avant la colonne en cours.
<Élément colonne 1> : Type de la colonne associée (optionnel)
Premier élément de la colonne à insérer dans le champ Table spécifié. Chaque élément correspond à une ligne du champ Table. Le type de l'élément inséré 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 lié sont prises en compte.
<Élément colonne N> : Type de la colonne associée (optionnel)
Nième élément de la colonne à insérer dans le champ Table spécifié. Chaque élément correspond à une ligne du champ Table. Le type de l'élément inséré 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 lié sont prises en compte.
Remarques

Caractéristiques des éléments de la colonne

  • Pour ne pas spécifier de valeur pour un des éléments, 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 :
    TableInsèreColonne(TABLE_TableCalcul, 3, (53+29), (83-21))

Position de la colonne insérée

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

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 importants 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 l'enregistrement dans le fichier de données, exécutez la fonction TableEnregistre après la fonction TableInsèreColonne.
Rappel : L'option "saisie en cascade" peut être sélectionnée :
  • Lors de la création d'un champ Table.
  • Dans l'onglet "Détail" de la fenêtre de description du champ Table sous l'éditeur de fenêtres.

Champ Table fichier : Insertion de plusieurs colonnes

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

Insertion d'une image

Pour insérer une image dans un champ Table, spécifiez directement le nom et le chemin complet de l'image à insérer.
Par exemple :
TableInsèreColonne(TABLE_MaTable, 5, "C:\MesDocuments\MonImage.BMP")
Remarque : Pour afficher correctement l'image insérée, la ligne doit être de type Image.

Champ Table en saisie

Si la fonction TableInsèreColonne est appelée :
  • Dans un événement du champ, le curseur est automatiquement positionné sur la première ligne à saisir dans la colonne 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.
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