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.
'Flags' sind immer optional und können sich aus einer oder mehreren der folgenden Konstanten (verknüpft mit dem bitweisen '|' OR-Operator) zusammensetzen:
#PB_Button_Right : rechtsbündige Darstellung des Schalter-Textes (nicht unterstützt auf Mac OSX)
#PB_Button_Left : linksbündige Darstellung des Schalter-Textes (nicht unterstützt auf Mac OSX)
#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 (nicht unterstützt auf Mac OSX)
#PB_Button_Toggle : erstellt einen 'Toggle' Schalter: ein Klick und der Schalter bleibt gedrückt, ein
weiterer Klick gibt ihn wieder frei
Zu diesem Gadget kann mittels GadgetToolTip() eine 'Mini-Hilfe' hinzugefügt werden.
Die folgenden Funktionen können zum Kontrollieren des Gadgets verwendet werden:
- SetGadgetText(): Ändert den Text des ButtonGadgets.
- GetGadgetText(): Ermittelt den Text des ButtonGadgets.
- SetGadgetState(): Verwendet mit #PB_Button_Toggle Schaltern, um den aktuellen Status zu setzen (1 = gedrückt, 0 = normal).
- GetGadgetState(): Verwendet mit #PB_Button_Toggle Schaltern, um den aktuellen Status des Schalters zu ermitteln (1 = gedrückt, 0 = normal).
Spezielles Windows-Feature:
Im 'Text$' des Schalters können Sie das spezielle '&' Zeichen verwenden, um einen bestimmten Buchstaben zu unterstreichen: "&Button" ergibt tatsächlich: Button
(Hinweis: unter Windows XP wird der unterstrichene Buchstabe nur angezeigt, wenn dieses Feature nicht in den Systemeinstellungen deaktiviert wurde.)
In Kombination mit dem AddKeyboardShortcut() Befehl kann auf diesem Weg ein Tastenkürzel für den Schalter realisiert werden.
Beispiel:
; Zeigt mögliche Flags des ButtonGadget in Aktion...
If OpenWindow(0, 0, 0, 222, 200, "ButtonGadgets", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
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
