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