DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions Sélecteur
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Insère une nouvelle option dans un champ Sélecteur.
Exemple
// 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é.
Android Ce paramètre n'est pas disponible.
<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).
Android Ce paramètre n'est pas disponible.
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
Version minimum requise
  • Version 18
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale