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
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 :
TableAjouteLigne ( TABLE_TableProduit , "Dubois" , "Pierre" )
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". 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é.
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 :
TableAjouteLigne ( TABLE_MaTable , "MonImage.BMP" )
Remarque : Pour afficher correctement l'image ajoutée, la colonne doit être de type Image.
Composante : wd300obj.dll
Documentation également disponible pour…