ToolBarImageButton

ToolBarImageButton()

Syntax

ToolBarImageButton(#Button, ImageID [, Modus [, Text$]])

Beschreibung

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

Parameter

#Button Der Bezeichner des neuen Werkzeugleisten-Schalters.

ImageID Das für den Schalter zu verwendende Bild. Dies 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.
Modus (optional)
Der Modus-Wert kann eine der folgenden Konstanten sein:
  #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
GetToolBarButtonState() und SetToolBarButtonState() können verwendet werden, um den Status eines Toggle-Schalters zu ermitteln bzw. zu ändern.
Text$ (optional) Der Text, der mit diesem Schalter angezeigt werden soll. Die Werkzeugleiste muss mit dem #PB_ToolBar_Text Flag erstellt werden, oder der Text wird nicht angezeigt.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

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

Siehe auch

CreateToolBar(), ToolBarSeparator()

Unterstützte OS

Alle

<- ToolBarID() - ToolBar Inhaltsverzeichnis - ToolBarSeparator() ->

#Button	Der Bezeichner des neuen Werkzeugleisten-Schalters.
ImageID	Das für den Schalter zu verwendende Bild. Dies 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.
Modus (optional)	Der Modus-Wert kann eine der folgenden Konstanten sein: #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 GetToolBarButtonState() und SetToolBarButtonState() können verwendet werden, um den Status eines Toggle-Schalters zu ermitteln bzw. zu ändern.
Text$ (optional)	Der Text, der mit diesem Schalter angezeigt werden soll. Die Werkzeugleiste muss mit dem #PB_ToolBar_Text Flag erstellt werden, oder der Text wird nicht angezeigt.