Wenn #PB_Any als '#Gadget' Parameter verwendet wird, dann wird der Identifier des neuen Gadgets als 'Ergebnis' zurückgegeben. #Gadget ist die Nummer, die (später) von der EventGadgetID() Funktion zurückgegeben wird.
Sobald eine ComboBox erstellt wurde, ist ihre Liste mit Einträgen leer.
Der Parameter 'Höhe' sollte ein größerer Wert als das eigentliche Maß das ComboBox-Gadgets sein, da er die Höhe des ComboBox-Gadgets im aufgeklappten Zustand angibt.
'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.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.
- ClearGadgetItemList(): 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(): kann zum Ändern des aktuellen Elements benutzt werden.
- SetGadgetText(): ändert den anzuzeigenden Text. Wenn das ComboBoxGadget nicht editierbar ist, muss sich der Text in der Aufklapp-Liste befinden.
Beispiel:
If OpenWindow(0,0,0,270,140,#PB_Window_SystemMenu|#PB_Window_ScreenCentered,"ComboBoxGadget") And CreateGadgetList(WindowID(0))
ComboBoxGadget(0,10,10,250,100,#PB_ComboBox_editable)
AddGadgetItem(0,-1,"ComboBox editable...")
ComboBoxGadget(1,10,40,250,100)
For a=1 To 5 : AddGadgetItem(1,-1,"ComboBox item "+Str(a)) : Next
SetGadgetState(1,2) ; wir setzen (beginnend bei 0) den dritten Eintrag als aktiven
Repeat : Until WaitWindowEvent()=#PB_Event_CloseWindow
EndIf
