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.
'Flags' sind immer optional und können sich aus einer oder mehreren der folgenden Konstanten (verknüpft mit dem '|' OR-Operator) zusammensetzen:
#PB_Button_Right : rechtsbündige Darstellung des Schalter-Textes
#PB_Button_Left : linksbündige Darstellung des Schalter-Textes
#PB_Button_Default : legt das definierte Aussehen des Schalters als Standard-Schalter für das Fenster fest
#PB_Button_MultiLine : Ist der Text zu lang, wird er über mehrere Zeilen dargestellt
#PB_Button_Toggle : erstellt einen 'Toggle' Schalter: ein Klick und der Schalter bleibt gedrückt, ein
weiterer Klick gibt ihn wieder frei
Die folgenden EventType() werden vom ButtonGadget unterstützt, wenn
AdvancedGadgetEvents() vor dem Erstellen des Gadgets aktiviert wird.
#PB_EventType_LeftClick : Klick mit linker Maustaste #PB_EventType_RightClick : Klick mit rechter Maustaste #PB_EventType_LeftDoubleClick : Doppelklick mit linker Maustaste #PB_EventType_RightDoubleClick : Doppelklick mit rechter Maustaste #PB_EventType_Focus : Schalter erhielt den Fokus für die Eingabe #PB_EventType_LostFocus : Schalter verlor den Fokus für die EingabeZu diesem Gadget kann mittels GadgetToolTip() eine 'Mini-Hilfe' hinzugefügt werden.
Beispiel:
; Zeigt mögliche Flags des ButtonGadget in Aktion...
If OpenWindow(0,0,0,222,200,#PB_Window_SystemMenu|#PB_Window_ScreenCentered,"ButtonGadgets") And CreateGadgetList(WindowID(0))
ButtonGadget(0, 10, 10, 200, 20, "Standard Button")
ButtonGadget(1, 10, 40, 200, 20, "Left Button", #PB_Button_Left)
ButtonGadget(2, 10, 70, 200, 20, "Right Button", #PB_Button_Right)
ButtonGadget(3, 10,100, 200, 60, "Multiline Button (längerer Text wird automatisch umgebrochen)", #PB_Button_MultiLine)
ButtonGadget(4, 10,170, 200, 20, "Toggle Button", #PB_Button_Toggle)
Repeat : Until WaitWindowEvent()=#PB_Event_CloseWindow
EndIf
