ButtonImageGadget()

Syntax

Ergebnis = ButtonImageGadget(#Gadget, x, y, Breite, Höhe, ImageID [, Flags])

Erstellt ein Schalter-Gadget mit einem Bild innerhalb der aktuellen Gadgetliste.

Parameter

#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.
ImageID	Das für das Gadget zu verwendende Bild. Verwenden Sie die Funktion ImageID(), um diese ID von einem Bild zu erhalten. Dieser Parameter kann auch Null sein, um einen Schalter ohne Bild zu erstellen. Die Funktion SetGadgetAttribute() kann verwendet werden, um das Bild später zu ändern.
Flags (optional)	Dieser Parameter kann #PB_Button_Toggle lauten, um einen Toggle-Schalter (einen, der einen Ein-/Aus-Status besitzt) zu erstellen. Ein "Push-Button" (Schalter zum Drücken) wird standardmäßig erstellt.

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:

- GetGadgetState() kann verwendet werden, um den Toggle-Status des Gadgets zu ermitteln.
- SetGadgetState() kann verwendet werden, um den Toggle-Status des Gadgets festzulegen.
- GetGadgetAttribute() mit den folgenden Werten:

  #PB_Button_Image       : Ermittelt das dargestellte Bild (ImageID).
  #PB_Button_PressedImage: Ermittelt das Bild (ImageID), welches beim Drücken des Schalters dargestellt wird.

- SetGadgetAttribute() mit den folgenden Werten:

  #PB_Button_Image       : Ändert das dargestellte Bild (gültige ImageID via ImageID() ermitteln) bzw. löscht es (ImageID = 0).
  #PB_Button_PressedImage: Ändert das Bild, welches beim Drücken des Schalters dargestellt wird (gültige ImageID via ImageID() ermitteln) bzw. löscht es (ImageID = 0).

Beispiel

  If OpenWindow(0, 0, 0, 120, 100, "ButtonImage", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
    If LoadImage(0, "map.bmp")    ; ändern Sie den 2. Parameter in den Pfad/Dateinamen Ihres Bildes
      ButtonImageGadget(0, 10, 10, 100, 83, ImageID(0))
    EndIf
    Repeat
    Until WaitWindowEvent() = #PB_Event_CloseWindow
  EndIf

Siehe auch

GetGadgetState(), SetGadgetState(), GetGadgetAttribute(), SetGadgetAttribute(), ButtonGadget(), ImageID(), EventGadget()

Unterstützte OS

Alle