|
|
|
|
|
|
|
|
|
|
- Champ Liste supérieur à 10 000 éléments
- Visibilité / Invisibilité des éléments d'un champ Liste ou d'un champ Combo
- Champ Liste triée/Liste non triée
- Divers
ListeInsère (Fonction) En anglais : ListInsert Insère un élément dans un champ Liste par programmation (y compris Liste image) ou dans un champ Combo par programmation. Remarques : - Pour ajouter un élément à la fin d'un champ Liste (ou Combo), utilisez la fonction ListeAjoute.
- La fonction ListeInsère peut être utilisée indifféremment sur des champs Liste monosélection et multisélection.
- Pour gérer le contenu d'un champ Combo placé dans une colonne conteneur d'un champ Table, utilisez la propriété Contenu.
// Ajoute le nom "Dubois" Ã l'indice 4 dans le champ Liste "LISTE_ListeClient"
ListeInsère(LISTE_ListeClient, "Dubois", 4)
Syntaxe
<Résultat> = ListeInsère(<Champ Liste> , <Élément> [, <Image> [, <Indice de l'élément>]])
<Résultat> : Booléen - Vrai si l'élément a été inséré,
- Faux dans le cas contraire.
<Champ Liste> : Nom de champ Nom du champ Liste par programmation ou du champ Combo par programmation à manipuler. Si ce paramètre correspond à une chaîne vide (""), l'élément est inséré dans le champ Liste ou Combo auquel le traitement en cours appartient.
<Élément> : Chaîne de caractères Élément à insérer dans le champ Liste (ou Combo) par programmation spécifié.
Ce paramètre peut contenir :- des caractères Retour Chariot (RC) pour ajouter plusieurs lignes. Dans ce cas :
- si le paramètre <Indice de l'élément> n'est pas précisé, les éléments sont effectivement ajoutés.
- si le paramètre <Indice de l'élément> est précisé, seul le premier élément sera ajouté.
- des tabulations (TAB) pour obtenir un champ Liste multi-éléments (voir Notes).
<Image> : Chaîne de caractères optionnelle Nom et chemin de l'image à ajouter dans un champ Liste image. Ce paramètre est pris en compte uniquement dans le cas d'un champ Liste image, affichée en mode Liste image. Si ce paramètre n'est pas spécifié, l'image utilisée est l'image par défaut (définie dans l'onglet "Détail" de la fenêtre de description du champ).
<Indice de l'élément> : Entier optionnel Indice de l'élément à insérer.Si ce paramètre : - n'est pas précisé, l'élément est inséré :
- avant l'élément en cours dans le cas d'un champ Liste monosélection. Si aucun élément n'est en cours, l'élément est inséré à la fin du champ Liste (ou Combo) par programmation.
- à la fin du champ Liste (ou Combo) par programmation dans le cas d'un champ Liste multisélection.
- est supérieur au nombre d'éléments présents dans le champ Liste (ou Combo), l'élément est inséré à la fin du champ Liste (ou Combo) par programmation. Le nombre d'éléments présents dans un champ Liste (ou Combo) peut être obtenu avec la fonction ListeOccurrence.
- est égal à 0, l'élément est ajouté au début du champ Liste (ou Combo) par programmation.
Remarques Champ Liste supérieur à 10 000 éléments Le nombre maximum d'éléments pouvant être contenus dans un champ Liste n'est limité que par la mémoire vive disponible (maximum théorique : 2 milliards de lignes). Néanmoins, le fait de remplir un champ Liste avec un très grand nombre d'éléments (plus de 10 000) est pénalisant en termes de performance. Pour ajouter un grand nombre d'éléments dans un champ Liste, il est conseillé d'utiliser un champ Liste fichier (c'est-à -dire un champ Liste directement reliée à un fichier de données HFSQL). Divers - Pour insérer un élément dans un champ Table, utilisez la fonction TableInsère.
- La fonction ListeInsère peut être utilisée sur une colonne de type "Combo" dans un champ Table.
Composante : wd300obj.dll
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|