ComboBoxGadget()

Syntaxe

Resultat = ComboBoxGadget(#Gadget, x, y, Largeur, Hauteur [, Options])
Description
Crée un gadget ComboBox (Liste déroulante) dans la GadgetList en cours. Si #PB_Any est utilisé pour le paramètre '#Gadget', le numéro du nouveau gadget sera renvoyé dans 'Resultat'. #Gadget sera le numéro retourné par la fonction EventGadget(). Lorsqu'une liste déroulante est créée, elle est vide.

GadgetToolTip() permet d'ajouter une 'mini aide' à ce gadget.

Les commandes suivantes peuvent être utilisées pour agir sur le contenu de la liste :

- AddGadgetItem(): Ajoute un élément
- GetGadgetItemText(): Renvoie le texte de l'élément spécifié
- CountGadgetItems(): Renvoie le nombre d'éléments que contient le ComboBox.
- ClearGadgetItems(): Supprime tous les éléments
- RemoveGadgetItem(): Supprime un élément
- SetGadgetItemText(): Change le texte de l'élément spécifié

- SetGadgetState(): Change l'élément sélectionné.
- GetGadgetState(): Récupère l'index de l'élément sélectionné.
- SetGadgetText(): Change le texte affiché. Si le ComboBoxGadget n'est pas éditable, le texte doit être dans la liste déroulante.
- GetGadgetText(): Renvoie le contenu texte de la zone visible de la ComboBox.
- SetGadgetItemData(): Associe une valeur personnalisée à cet élément.
- GetGadgetItemData(): Renvoie la valeur personnalisée associée à cet élément.

Le paramètre facultatif 'Options' peut être une combinaison des constantes suivantes:
  #PB_ComboBox_Editable : Rend la liste déroulante éditable
  #PB_ComboBox_LowerCase: Tous les textes entrés dans la combobox sont convertis en minuscules
  #PB_ComboBox_UpperCase: Tous les textes entrés dans la combobox sont convertis en majuscules
  #PB_ComboBox_Image    : Active le support des images dans les éléments (pas supporté pour les ComboBox éditables sous MacOS X)


ComboBoxGadget() supports the following events reported by EventType():
  #PB_EventType_Change   : The current selection of the text in the edit field changed.
  #PB_EventType_Focus    : The edit field received the keyboard focus (editable ComboBox only).
  #PB_EventType_LostFocus: The edit field lost the keyboard focus (editable ComboBox only).

Exemple

  UsePNGImageDecoder()
  LoadImage(0, #PB_Compiler_Home + "examples/sources/Data/world.png")
  
  If OpenWindow(0, 0, 0, 270, 180, "ComboBoxGadget", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
    ComboBoxGadget(0, 10, 10, 250, 21, #PB_ComboBox_Editable)
      AddGadgetItem(0, -1, "Liste déroulante éditable...")

    ComboBoxGadget(1, 10, 40, 250, 21, #PB_ComboBox_Image)
      AddGadgetItem(1, -1, "Liste déroulante avec une image", ImageID(0))

    ComboBoxGadget(2, 10, 70, 250, 21)
      For a = 1 To 5
        AddGadgetItem(2, -1,"Elément de liste déroulante " + Str(a))
      Next

    SetGadgetState(0, 0)
    SetGadgetState(1, 0)
    SetGadgetState(2, 2) ; Sélectionne le troisième élément (la numérotation commence à 0)
    
    Repeat : Until WaitWindowEvent() = #PB_Event_CloseWindow
  EndIf

OS Supportés

Tous

<- CloseGadgetList() - Gadget Index - ContainerGadget() ->