DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions Table
  • Caractéristiques de la ligne insérée
  • Position de la ligne insérée
  • Limites : Nombre maximum de lignes affichées
  • Divers
  • Ajout de lignes
  • Saisie en chaîne
  • 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,
  • un champ Table hiérarchique,
  • WINDEV une table affichée dans un champ Combo.
Remarques :
  • Il est conseillé d'utiliser la fonction TableInsèreLigne. La fonction TableInsèreLigne permet d'insérer :
    • des caractères TAB dans les colonnes,
    • des valeurs de n'importe quel type dans les colonnes.
  • Pour ajouter des lignes à l'intérieur d'une hiérarchie (champ Table hiérarchique), utilisez la fonction TableInsèreFils.
Exemple
// Insertion des éléments "Paul" et "Dubois"
// dans la cinquième ligne de la champ Table "TABLE_TableClient"
ResInsertion = TableInsère(TABLE_TableClient, "Paul" + TAB + "Dubois", 5)
Syntaxe
<Résultat> = TableInsère(<Champ Table> [, <Ligne> [, <Indice>]])
<Résultat> : Booléen
  • Vrai si l'élément a été inséré,
  • Faux dans le cas contraire.
<Champ Table> : Nom de champ
Nom du champ à manipuler. Ce champ peut correspondre à :
  • un champ Table.
  • un champ Table hiérarchique.
  • WINDEV un champ Combo avec table.
Si ce paramètre correspond à une chaîne vide (""), le champ manipulé sera le champ auquel appartient l'événement en cours.
<Ligne> : Chaîne de caractères optionnelle
Ligne à insérer. Cette ligne est de la forme :
<Elément de la colonne1> + TAB + <Elément de la colonne2> + TAB + ...

Si ce paramètre n'est pas spécifié, une ligne vide est inséré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.
<Indice> : Entier optionnel
Indice de la ligne à insérer. 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 champ.La 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.
Remarques
La fonction TableInsère 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.
    WEBDEV - Code ServeurPHP Rappel : La multisélection n'est pas disponible sur les champs Table en mode "Serveur".
WEBDEV - Code ServeurPHP Cette fonction est disponible pour les champs Table en mode "Serveur + AJAX", les champs Table en mode "Serveur" et les champs Table hiérarchique.
WEBDEV - Code Navigateur Cette fonction est disponible uniquement pour les champs Table en mode "Navigateur".
WEBDEV - Code Navigateur Le champ Table hiérarchique n'est pas disponible.
AndroidiPhone/iPad Les champs Table fichier ne sont pas disponibles en saisie. La fonction TableInsère ne peut pas être utilisée sur un champ Table fichier.

Caractéristiques de la ligne insérée

  • Chaque élément inséré est converti dans le type de la colonne concernée.
  • Pour ne pas spécifier de valeur pour un élément, utilisez une chaîne vide ("") ou 0 (selon le type de la colonne). Par exemple :
    TableInsère(TABLE_TableClient, "Dubois" + TAB + "Pierre" + TAB + "" + TAB + "21/06/72")
  • Si un élément correspond au résultat d'un calcul, mettez l'expression numérique entre parenthèses. Par exemple :
    TableInsère(TABLE_TableCalcul, (53+29) + TAB + (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é.

Divers

Pour ajouter des lignes à la fin d'un champ Table ou Table hiérarchique, utilisez la fonction TableAjouteLigne.
WINDEVWEBDEV - Code ServeurJavaPHP

Ajout de lignes

La propriété Nouveau permet de savoir si la ligne en cours vient d'être créée par la fonction TableInsère (propriété Nouveau = Vrai).
WINDEVWEBDEV - Code ServeurJavaPHP

Saisie en chaîne

Pour effectuer une saisie en chaîne, utilisez la fonction TableInsère dans l'événement "Sortie d'une ligne" du champ Table de la façon suivante :
SI TABLE_TableClient.Nouveau = Vrai ALORS
TableInsère(TABLE_TableClient)
FIN
WEBDEV - Code ServeurPHP Ce fonctionnement est disponible uniquement pour les champs Table en mode Ajax.
WINDEVWEBDEV - Code ServeurJavaPHP

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, il est nécessaire d'utiliser la fonction TableEnregistre après la fonction TableInsère.
Remarques :
  • L'option "Saisie en cascade (Ajout)" peut être sélectionnée dans l'onglet "Détail" de la description du champ.
  • Java La saisie en cascade n'est pas disponible sur les champs Table fichier à accès direct. Cette option est disponible uniquement sur les champs Table par programmation et sur les champs Table fichier chargé en mémoire.
  • WEBDEV - Code Serveur La saisie en cascade est disponible uniquement sur les champs Table fichier en mode "Serveur + AJAX".
WINDEVWEBDEV - Code ServeurJavaPHP

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

A chaque appel de la fonction TableInsère 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ère 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.
WEBDEV - Code ServeurPHP Ce fonctionnement est disponible uniquement pour les champs Table fichier en mode "Serveur + AJAX".
WINDEVJavaCode Utilisateur (MCU)

Champ Table/Table hiérarchique en saisie

Si la fonction TableInsère 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 :
  • WINDEV spécifiez directement le nom et le chemin complet de l'image à insérer. Par exemple :
    TableInsère(TABLE_MaTable, "C:\MesDocuments\MonImage.BMP")
  • WEBDEV - Code ServeurPHP spécifiez le chemin et le nom de l'image à insérer. Le chemin est relatif au répertoire "<Nom_Projet>_WEB". Par exemple :
    // Ajoute l'image située dans le répertoire "WB_MonAppli_WEB"
    TableInsère(TABLE_MaTable, "MonImage.BMP")
Remarque : Pour afficher correctement l'image ajoutée, la colonne doit être de type Image.
Composante : wd290obj.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 14/06/2022

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