|
|
|
|
|
- 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
TableInsère (Fonction) En anglais : TableInsert Insère une ligne dans : - un champ Table,
- un champ Table hiérarchique,
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.
// 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.
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 à 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. |
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 Serveur WEBDEV - Code Serveur](https://doc.pcsoft.fr/ext/images/fr/WBS.png?-1123132264) Rappel : La multisélection n'est pas disponible sur les champs Table en mode "Serveur".
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. Insertion d'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ère(TABLE_MaTable, "C:\MesDocuments\MonImage.BMP")
![WEBDEV - Code Serveur WEBDEV - Code Serveur](https://doc.pcsoft.fr/ext/images/fr/WBS.png?-1123132264) 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 : wd300obj.dll
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|