ButtonGadget()

Syntax

Ergebnis = ButtonGadget(#Gadget, x, y, Breite, Höhe, Text$ [, Flags])
Description
Erstellt ein Schalter-Gadget innerhalb der aktuellen Gadget-Liste.

Parameters

#Gadget Eine Nummer, um das neue Gadget zu identifizieren. #PB_Any kann verwendet werden, um diese Nummer automatisch zu generieren.
x, y, Breite, Höhe Die Position und die Abmessungen des neuen Gadgets. Hinweis: Auf OS X aktiviert die Verwendung einer Höhe von 25 den Schalter-Typ mit einer festen Höhe, welcher häufig in OS X Applikationen genutzt wird. Außerdem macht dies die #PB_Button_Default Flags verfügbar.
Text$ Der auf dem Schalter darzustellende Text.
Flags (optional) Flags zum Verändern des Gadget-Verhaltens. Dies kann 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 OSX)
  #PB_Button_Left      : linksbündige Darstellung des Schalter-Textes (nicht unterstützt auf OSX)
  #PB_Button_Default   : legt das definierte Aussehen des Schalters als Standard-Schalter für das Fenster fest (auf OS X muss die Höhe des Schalters 25 sein)
  #PB_Button_MultiLine : Ist der Text zu lang, wird er über mehrere Zeilen dargestellt (nicht unterstützt auf OSX)
  #PB_Button_Toggle    : erstellt einen 'Toggle'-Schalter: Ein Klick und der Schalter bleibt gedrückt, ein
                         weiterer Klick gibt ihn wieder frei.

Return value

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.

Remarks

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).

Example

  ; 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

See Also

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

Supported OS

All

<- BindGadgetEvent() - Gadget Index - ButtonImageGadget() ->