|
|
|
|
|
|
|
|
|
|
- Caractéristiques des éléments de la ligne
- Position de la ligne inséré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 : Insertion de plusieurs lignes
- Champ Table/Table hiérarchique en saisie
- Insertion d'une image
TableInsèreLigne (Fonction) En anglais : TableInsertLine Insère une ligne dans : - un champ Table,
- un champ Table hiérarchique.
Remarques : - Pour ajouter des éléments à la fin d'un champ Table, utilisez la fonction TableAjouteLigne.
- Pour ajouter des lignes à l'intérieur d'une hiérarchie (champ Table hiérarchique), utilisez la fonction TableInsèreFils.
 Pour insérer une ligne avec une animation, utilisez la fonction TableInsèreLigneAvecAnimation.
TableInsèreLigne(TABLE_TableClient, 5, "Paul", "Dubois")
TableInsèreLigne(TABLE_Contact, TABLE_Contact + 1, "Nouveau contact")
TableSelectPlus(TABLE_Contact, TABLE_Contact + 1)
Syntaxe
TableInsèreLigne(<Champ Table> [, <Indice> [, <Élément colonne 1> [... [, <Élément colonne N>]]]])
<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. <Indice> : Entier optionnel Indice de la ligne dans laquelle les éléments doivent être insérés. 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 à 0 | La ligne est insérée au début du champ. | | Indice égal à -1 | La ligne est insérée avant la ligne en cours. |
<Élément colonne 1> : Type de la colonne associée (optionnel) Premiers éléments de la ligne à insérer dans le champ spécifié. Chaque élément correspond à une colonne du champ. Le type de l'élément inséré 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 prises en compte. <Élément colonne N> : Type de la colonne associée (optionnel) Nèmes éléments de la ligne à insérer dans le champ spécifié. Chaque élément correspond à une colonne du champ. Le type de l'élément inséré 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 prises en compte. Remarques La fonction TableInsèreLigne 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.
Caractéristiques des éléments de la ligne - Pour ne pas spécifier de valeur pour un des éléments, 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 :
TableInsèreLigne(TABLE_TableCalcul, 3, (53+29), (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é. Insertion d'une image Pour insérer une image dans un champ Table ou Table hiérarchique : - spécifiez directement le nom et le chemin complet de l'image à insérer.
Par exemple :
TableInsèreLigne(TABLE_MaTable, 5, "C:\MesDocuments\MonImage.BMP")
Remarque : Pour afficher correctement l'image insérée, la colonne doit être de type Image. Composante : wd300obj.dll
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|