ToolBarImageButton()

Syntax

ToolBarImageButton(#ButtonID, ImageID [, Modus])

Fügt einen Image-Schalter (Bild-Schalter) zur konstruierten Werkzeugleiste hinzu. CreateToolBar() muss vor Benutzung dieses Befehls aufgerufen werden.

Die 'ImageID' kann einfach mittels ImageID() aus der Image Library ermittelt werden. Dabei handelt es sich entweder um ein mittels LoadImage() geladenes oder mittels CreateImage() im Speicher erstelltes Bild ("Image"). Um einen tatsächlich transparenten Hintergrund zu haben, verwenden Sie das 'Icon' (.ico) Dateiformat auf Windows bzw. das PNG-Dateiformat auf Linux/MacOS X.

Mit dem optionalen Parameter 'Modus' kann eingestellt werden, ob der Bild-Schalter gedrückt ("toggled") oder nicht gedrückt dargestellt wird. Dafür kann eine der folgenden Konstanten verwendet werden:

  #PB_ToolBar_Normal : der Schalter verhält sich als Standard-Schalter (Standard-Einstellung)
  #PB_ToolBar_Toggle : der Schalter verhält sich als Toggle-Schalter, d.h. bleibt nach dem Anklicken gedrückt/nicht gedrückt

Später können die GetToolBarButtonState() und SetToolBarButtonState() Befehle darauf verwendet werden.

Die spätere Abfrage eines Ereignisses, d.h. ob ein Eintrag der ToolBar angeklickt wurde, erfolgt analog der Abfrage eines Menü-Eintrages mit dem Befehl EventMenu().

Beispiel:

  If OpenWindow(0, 0, 0, 150, 25, "ToolBar", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
    CreateImage(0,16,16)
    StartDrawing(ImageOutput(0))
      Box(0,0,16,16,RGB(255,255,255))
      Box(4,4,8,8,RGB(255,0,0))
    StopDrawing()
    CreateImage(1,16,16)
    StartDrawing(ImageOutput(1))
      Box(0,0,16,16,RGB(255,0,0))
      Box(4,4,8,8,RGB(255,255,255))
    StopDrawing()
    If CreateToolBar(0, WindowID(0))
      ToolBarImageButton(0,ImageID(0))
      ToolBarImageButton(1,ImageID(1))
    EndIf
    Repeat
    Until WaitWindowEvent() = #PB_Event_CloseWindow 
  EndIf

Unterstützte OS

Alle