|
|
|
|
SélecteurInsère (Fonction) En anglais : RadioButtonInsert Insère une nouvelle option dans un champ Sélecteur. // Insère une option à la position 2 SélecteurInsère(SEL_Options, 2, "Lire un livre sur une tablette")
Syntaxe
<Résultat> = SélecteurInsère(<Champ Sélecteur> , <Indice de l'élément> , <Libellé> [, <Sous-libellé> [, <Image>]])
<Résultat> : Entier - Indice de l‘option insérée.
- -1 en cas d'erreur. Pour plus de détails sur l'erreur, utilisez la fonction ErreurInfo.
<Champ Sélecteur> : Nom de champ Nom du champ Sélecteur dans lequel l'option doit être insérée. <Indice de l'élément> : Entier Indice de l'élément à insérer. Si ce paramètre : - est supérieur au nombre d'options présentes dans le sélecteur, l'option est ajoutée après la dernière option du champ Sélecteur.
- est égal à 1 ou 0, l'élément est ajouté avant la première option du champ Sélecteur.
<Libellé> : Chaîne de caractères Libellé de l'option à ajouter. <Sous-libellé> : Chaîne de caractères optionnelle Sous libellé de l'option à ajouter. Si ce paramètre n'est pas spécifié, l'option ajoutée n'a pas de sous-libellé. Si ce paramètre est spécifié, le sous-libellé sera affiché même si le sélecteur utilise un mode d'affichage sans sous-libellé.
<Image> : Chaîne de caractères optionnelle Image associée à l'option à ajouter. Si ce paramètre n'est pas spécifié, l'option ajoutée n'a pas d'image. Si ce paramètre est spécifié, l'image sera affichée uniquement si le sélecteur utilise un mode d'affichage "Style Vista" (avec image).
Remarques - Les caractéristiques de l'option ajoutée peuvent également être modifiées grâce aux propriétés suivantes utilisées sur l'option :
- Lors de l'insertion d'options dans un champ Sélecteur, la taille du champ n'est pas modifiée. Si le champ n'est pas suffisamment grand, les options ajoutées pourront ne pas être visibles. Il est possible d'augmenter la taille du champ avec les propriétés Largeur et Hauteur.
- Pour ajouter une option à la suite des options existantes, utilisez la fonction SélecteurAjoute.
- Lors de l'insertion d'une option :
- l'option insérée a pour indice <Indice de l'élément>.
- si le sélecteur utilise la numérotation des options, les indices des options suivant l'option insérée sont automatiquement renumérotées.
- Utilisation des valeurs renvoyées : Si le sélecteur utilise les valeurs renvoyées, il est possible de définir la valeur renvoyée par l'option insérée grâce à la propriété ValeurRenvoyée.
Par exemple :
nIndice est un entier nIndice = SélecteurInsère(SEL_Option, 2, "Lire un livre sur une tablette") SEL_Option[nIndice].ValeurRenvoyée = "Tablette" // Sélection de la nouvelle option SEL_Option = "Tablette"
Composante : wd290obj.dll
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|