Wenn #PB_Any als '#Gadget' Parameter verwendet wird, dann wird die Nummer des neuen Gadgets als 'Ergebnis' zurückgegeben. #Gadget ist die Nummer, die (später) von der EventGadget() Funktion zurückgegeben wird.
Sobald eine ComboBox erstellt wurde, ist ihre Liste mit Einträgen leer.
'Flags' sind immer optional und können sich aus einer oder mehreren der folgenden Konstanten (verknüpft mit dem '|' OR-Operator) zusammensetzen:
#PB_ComboBox_Editable : Macht die ComboBox editierbar #PB_ComboBox_LowerCase : Der gesamte in der ComboBox eingegebene Text wird in Kleinbuchstaben konvertiert. #PB_ComboBox_UpperCase : Der gesamte in der ComboBox eingegebene Text wird in Großbuchstaben konvertiert. #PB_ComboBox_Image : Aktiviert die Unterstützung für Bilder in Einträgen (nicht unterstützt bei editierbaren ComboBoxen auf OSX).Zu diesem Gadget kann mittels GadgetToolTip() eine 'Mini-Hilfe' hinzugefügt werden.
Die folgenden Befehle können benutzt werden, um auf den Listen-Inhalt zuzugreifen:
- AddGadgetItem(): fügt einen Eintrag hinzu.
- GetGadgetItemText(): ermittelt den Text des Gadget-Eintrags.
- CountGadgetItems(): ermittelt die Anzahl der aktuellen Einträge im #Gadget.
- ClearGadgetItems(): entfernt alle Einträge.
- RemoveGadgetItem(): entfernt einen Eintrag.
- SetGadgetItemText(): ändert den Text des Gadget-Eintrags.
- GetGadgetState(): ermittelt die Index-Nummer (beginnend bei 0) des aktuellen Elements.
- GetGadgetText(): ermittelt den (Text-) Inhalt des aktuellen Elements.
- SetGadgetState(): ändert das ausgewählte Element.
- SetGadgetText(): ändert den anzuzeigenden Text. Wenn das ComboBoxGadget nicht editierbar ist, muss sich der Text in der Aufklapp-Liste befinden.
- GetGadgetItemData(): Gibt den Wert zurück, welcher mit dem Eintrag gespeichert wurde.
- SetGadgetItemData(): Speichert einen Wert mit dem Eintrag.
Beispiel:
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, "ComboBox editable...")
ComboBoxGadget(1, 10, 40, 250, 21, #PB_ComboBox_Image)
AddGadgetItem(1, -1, "ComboBox item with image", ImageID(0))
ComboBoxGadget(2, 10, 70, 250, 21)
For a = 1 To 5
AddGadgetItem(2, -1,"ComboBox item " + Str(a))
Next
SetGadgetState(0, 0)
SetGadgetState(1, 0)
SetGadgetState(2, 2) ; wir setzen (beginnend bei 0) den dritten als den aktiven Eintrag
Repeat : Until WaitWindowEvent() = #PB_Event_CloseWindow
EndIf
