|
|
|
|
|
|
|
|
|
|
- Conditions d'utilisation
- Caractéristiques d'une ligne
- Position de la ligne ajoutée
- Limites : Nombre maximum de lignes affichées
- Divers
- Ajout d'image
- Gestion de l'Unicode
TableAjoute (Fonction) En anglais : TableAdd Ajoute une ligne dans : - un champ Table,
- un champ Table hiérarchique,
- des caractères TAB dans les colonnes,
- des valeurs de n'importe quel type dans les colonnes,
- des données UNICODE automatiquement et sans conversion.
// Ajout de "Dubois", "Pierre" et "21/06/72"
// Ã la fin du champ "TABLE_TableClient"
ResAjout = TableAjoute(TABLE_TableClient, "Dubois" + TAB + "Pierre" + TAB + "21/06/72")
Syntaxe
<Résultat> = TableAjoute(<Champ Table> [, <Ligne>])
<Résultat> : Booléen - Vrai si l'élément a été ajouté,
- 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.
Si ce paramètre correspond à une chaîne vide (""), le champ manipulé sera le champ auquel appartient l'événement en cours d'exécution. <Ligne> : Chaîne de caractères optionnelle Ligne à ajouter. Cette ligne est de la forme :
<Elément de la colonne 1> + TAB + <Elément de la colonne 2> + TAB + ...
Si ce paramètre n'est pas 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 TableAjoute 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 d'une ligne - Chaque élément ajouté 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 :
TableAjoute(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 :
TableAjoute(TABLE_TableCalcul, (53+29) + TAB + (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é. Divers - Pour ajouter une ligne dans un champ Table ou Table hiérarchique à une position spécifique, utilisez la fonction TableInsèreLigne.
- Si la ligne ajoutée est la première ligne du champ, la ligne ajoutée devient la ligne en cours.
Ajout d'image Pour ajouter une image dans un champ Table ou Table hiérarchique : Remarque : Pour afficher correctement l'image ajoutée, la colonne doit être de type Image. Gestion de l'Unicode La gestion de l'Unicode peut être définie au niveau de la configuration de projet (onglet "Unicode" de la fenêtre de description de la configuration) : - Si l'option "Utiliser des chaînes ANSI en exécution" est sélectionnée : les données sont converties en utilisant l'alphabet courant.
Rappel : La fonction ChangeAlphabet permet de modifier l'alphabet courant. - Si l'option "Utiliser des chaînes UNICODE en exécution" est sélectionnée, les données sont insérées sans transformation.
Composante : wd300obj.dll
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|