TableAjouteLigne (Fonction)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français (historique)

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 ajouté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 : Ajout de plusieurs lignes
Ajout dans un champ Table fichier et déclenchement d'un trigger
Champ Table/Table hiérarchique fichier en saisie
Ajout d'image

WINDEV

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

TableAjouteLigne (Fonction)

En anglais : TableAddLine

Ajoute une ligne dans :

un champ Table,
un champ Table hiérarchique.

Si la ligne ajoutée est la première ligne du champ, la ligne ajoutée devient la ligne en cours.

Remarques :

Pour ajouter une ligne à une position spécifique, utilisez la fonction TableInsèreLigne.
Pour ajouter une ligne avec une animation, utilisez la fonction TableAjouteLigneAvecAnimation.

Exemple

// Ajout des éléments "Dubois" et "Pierre"
// dans la dernière ligne du champ "TABLE_TableProduit"
TableAjouteLigne(TABLE_TableProduit, "Dubois", "Pierre")

// Exemple de champ Table
// avec une colonne "Liste de valeurs" (WEBDEV) ou "Combo" (WINDEV).
// Cette colonne peut être remplie directement dans sa description
// ou par programmation.
// L'exemple ci-dessous traite le cas par programmation.

// 1 - Ajout des valeurs possibles dans la colonne "liste de valeurs" / Combo
ListeAjoute(TABLE_MaTable.COL_Valeur, "Val 1")
ListeAjoute(TABLE_MaTable.COL_Valeur, "Val 2")
ListeAjoute(TABLE_MaTable.COL_Valeur, "Val 3")
ListeAjoute(TABLE_MaTable.COL_Valeur, "Val 4")

// 2 - Ajout de lignes avec des éléments sélectionnés 
// dans la colonne "liste de valeurs" ou Combo
// ici la seconde colonne correspond à la liste de valeurs / combo.
// Seul l'indice à sélectionner dans la liste de valeurs ou combo est précisé.
TableAjouteLigne(TABLE_MaTable, "ligne 1", 1) // Où 1 correspond à "Val 1"
TableAjouteLigne(TABLE_MaTable, "ligne 2", 4) // Où 4 correspond à "Val 4"

Syntaxe

<Résultat> = TableAjouteLigne(<Champ Table> [, <Élément colonne 1> [... [, <Élément colonne N>]]])

<Résultat> : Entier

Indice de la ligne ajoutée,
-1 en cas d'erreur.

<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é est le champ auquel appartient l'événement en cours.

<Élément colonne 1> : Type de la colonne associée (optionnel)

Éléments de la ligne à ajouter dans le champ spécifié. Chaque élément correspond à une colonne du champ. Le type de l'élément ajouté 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 alors prises en compte.

<Élément colonne N> : Type de la colonne associée (optionnel)

Éléments de la ligne à ajouter dans le champ spécifié. Chaque élément correspond à une colonne du champ. Le type de l'élément ajouté 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 alors prises en compte.

Remarques

Conditions d'utilisation

La fonction TableAjouteLigne 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.
Rappel : La multisélection n'est pas disponible sur les champs Table en mode "Serveur".

Cette fonction est disponible pour les champs Table en mode "Serveur + AJAX", les champs Table en mode "Serveur" et les champs Table hiérarchique.

Cette fonction est disponible uniquement pour les champs Table en mode "Navigateur".

Le champ Table hiérarchique n'est pas disponible.

Les champs Table fichier ne sont pas disponibles en saisie. La fonction TableAjouteLigne ne peut pas être utilisée sur un champ Table fichier.

Caractéristiques des éléments de la ligne

Pour ne pas spécifier de valeur pour un élément, 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 :
```
TableAjouteLigne(TABLE_TableCalcul, (53+29), (83-21))
```

Position de la ligne ajoutée

Par défaut, la ligne est ajoutée à la fin des lignes affichées par le champ.

Cas particulier :

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

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 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 fichier de données lié au champ n'est pas modifié. Pour écrire le contenu de la ligne ajoutée dans le fichier de données lié, il est nécessaire d'utiliser la fonction TableEnregistre après la fonction TableAjouteLigne.

Remarques :

L'option "Saisie en cascade (Ajout)" peut être sélectionnée dans l'onglet "Détail" de la description du champ.
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.
La saisie en cascade est disponible uniquement sur les champs Table fichier en mode "Serveur + AJAX".

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

A chaque appel de la fonction TableAjouteLigne dans un champ Table ou Table hiérarchique fichier, une ligne virtuelle est créée dans le champ. Les informations seront enregistrées dans le fichier de données lié uniquement que lors de l'appel de la fonction TableEnregistre.

Si la fonction TableAjouteLigne 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.

Ce fonctionnement est disponible uniquement pour les champs Table fichier "Serveur + AJAX".

Ajout dans un champ Table fichier et déclenchement d'un 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.

Ce fonctionnement est disponible uniquement pour les champs Table fichier "Serveur + AJAX".

Champ Table/Table hiérarchique fichier en saisie

Si la fonction TableAjouteLigne est appelée :

Dans un événement du champ, le curseur est automatiquement positionné sur la première colonne à saisir dans la ligne ajouté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.

Ajout d'image

Pour ajouter une image dans un champ Table ou Table hiérarchique :

spécifiez directement le nom et le chemin complet de l'image à ajouter. Par exemple :
TableAjouteLigne(TABLE_MaTable, "C:\MesDocuments\MonImage.BMP")
spécifiez le chemin et le nom de l'image à ajouter. Le chemin est relatif au répertoire "<Nom_Projet>_WEB". Par exemple :
// Ajoute l'image située dans le répertoire "WB_MonAppli_WEB" TableAjouteLigne(TABLE_MaTable, "MonImage.BMP")

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

Composante : wd300obj.dll

Voir Aussi

Version minimum requise

Version 9

Documentation également disponible pour…

Commentaires

Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 13/09/2024

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