ImageGadget()

Syntax

Ergebnis = ImageGadget(#Gadget, x, y, Breite, Höhe, ImageID [, Flags])
Beschreibung
Erstellt ein Image-Gadget (Bild-Gadget) 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.

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.

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.

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

Beispiel

  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

Siehe auch

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

Unterstützte OS

Alle

<- IPAddressGadget() - Gadget Inhaltsverzeichnis - IsGadget() ->