ToolBarImageButton()

Syntax

ToolBarImageButton(#ButtonID, ImageID [, Mode])

Add an image button to the toolbar being constructed. CreateToolBar() must be called before to use this function.

The 'ImageID' can be easily obtained by using ImageID() from the Image library. It can be an image loaded with LoadImage() or created in memory with CreateImage(). To have a real transparent background, use the 'icon' (.ico) file format on Windows, or the PNG file format on Linux/MacOS X.

With the optional 'Mode' parameter can be adjusted, if the ToolBarImageButton will act as a toggle button or not. One of the following constants can be used:

  #PB_ToolBar_Normal: the button will act as standard button (default setting)
  #PB_ToolBar_Toggle: the button will act as toggle button

Later the GetToolBarButtonState() and SetToolBarButtonState() functions can be used on it.

The later checking of an event, means if the user clicked on an item of the toolbar, will done the same way like checking for a menu event with the function EventMenu().

Example:

  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

Supported OS

All