ButtonGadget()

Syntax

Ergebnis = ButtonGadget(#Gadget, x, y, Breite, Höhe, Text$ [, Flags])

Erstellt ein Schalter-Gadget innerhalb der aktuellen Gadget-Liste.

Parameter

#Gadget	Gibt eine Nummer an, um das neue Gadget zu identifizieren. #PB_Any kann verwendet werden, um diese Nummer automatisch zu generieren.
x, y, Breite, Höhe	Geben die Position und die Abmessungen des neuen Gadgets an.
Text$	Gibt den auf dem Schalter darzustellenden Text an.
Flags (optional)	Gibt optionale Flags an, um das Gadget-Verhalten zu verändern. Diese können eine Kombination (verknüpft mit dem bitweisen '|' OR-Operator) der folgenden Konstanten sein: #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

Rückgabewert

Gibt bei Erfolg einen Wert ungleich Null zurück, oder Null bei einem Fehler. Wenn #PB_Any als #Gadget Parameter verwendet wurde, dann beinhaltet der Rückgabewert bei Erfolg die automatisch generierte Gadget-Nummer.

Anmerkungen

Zu diesem Gadget kann mittels GadgetToolTip() eine 'Mini-Hilfe' hinzugefügt werden.

Die folgenden Funktionen können bei diesem Gadget 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).

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

Siehe auch

SetGadgetText(), GetGadgetText(), SetGadgetState(), GetGadgetState(), ButtonImageGadget()

Unterstützte OS

Alle