ImageGadget()

Syntax

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

Erstellt ein Image-Gadget (Bild-Gadget) innerhalb der aktuellen Gadgetliste.

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. Das Gadget passt seine Breite und Höhe automatisch dem dargestellten Bild an. Die angegebenen Breite und Höhe werden nur verwendet, wenn kein Bild dargestellt wird.
ImageID	Das darzustellende Bild (Image). Verwenden Sie die Funktion ImageID(), um diese ID von einem Bild zu erhalten. Ist dieser Parameter gleich 0, dann wird kein Bild dargestellt.
Flags (optional)	Flags zum Verändern des Gadget-Verhaltens. Dies kann folgende Konstante sein: #PB_Image_Border: stellt einen vertieften Rand rings um das Bild dar. #PB_Image_Raised: stellt einen erhobenen Rand rings um das Bild dar.

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.

- SetGadgetState(): Ändert das aktuelle Bild des Gadgets. Eine gültige 'ImageID' kann einfach mittels ImageID() ermittelt werden. Ist die ImageID gleich 0, dann wird das Bild vom Gadget entfernt.

Die Abfrage folgender Ereignisse wird mittels EventType() unterstützt:

  #PB_EventType_LeftClick
  #PB_EventType_RightClick
  #PB_EventType_LeftDoubleClick
  #PB_EventType_RightDoubleClick
  #PB_EventType_DragStart

Nach einem #PB_EventType_DragStart Ereignis kann die Drag & Drop Library verwendet werden, um eine Drag & Drop Operation zu starten.

Wenn die Unterstützung weiterer Ereignis-Typen oder "Double-Buffering" für regelmäßig aktualisierte Bild-Inhalte benötigt wird, dann werfen Sie einen Blick auf das CanvasGadget().

Example

  If OpenWindow(0, 0, 0, 245, 105, "ImageGadget", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
    If LoadImage(0, "map.bmp")    ; ändern Sie den 2. Parameter in den Pfad/Dateiname Ihres Bildes
      ImageGadget(0,  10, 10, 100, 83, ImageID(0))                     ; Imagegadget Standard
      ImageGadget(1, 130, 10, 100, 83, ImageID(0), #PB_Image_Border)   ; Imagegadget mit Rand
    EndIf
    Repeat : Until WaitWindowEvent() = #PB_Event_CloseWindow
  EndIf

See Also

GetGadgetState(), SetGadgetState(), ButtonImageGadget(), ImageID(), CanvasGadget()

Supported OS

All