Result = ButtonImageGadget(#Gadget, x, y, Width, Height, ImageID [, Flags])
Create a button gadget with an image in the current GadgetList.


#Gadget A number to identify the new gadget. #PB_Any can be used to auto-generate this number.
x, y, Width, Height The position and dimensions of the new gadget.
ImageID The image for the gadget. Use the ImageID() function to get this ID from an image. This parameter can be zero to create a button without an image. The SetGadgetAttribute() function can be used to change the image later.
Flags (optional) This parameter can be #PB_Button_Toggle to create a toggle-button (one which has an on/off state). A push-button is created by default.

Return value

Returns nonzero on success and zero on failure. If #PB_Any was used as the #Gadget parameter then the return-value is the auto-generated gadget number on success.


A 'mini help' can be added to this gadget using GadgetToolTip().

The following functions can be used to control the gadget:

- GetGadgetState() can be used to get the toggle state of the gadget.
- SetGadgetState() can be used to set the toggle state of the gadget.
- GetGadgetAttribute() with the following values:
  #PB_Button_Image       : Get the displayed image ID, e.g. ImageID(#MyImage).
  #PB_Button_PressedImage: Get the displayed image ID when the button is pressed, e.g. ImageID(#MyImagePressed).
- SetGadgetAttribute() with the following values:
  #PB_Button_Image       : Set the displayed image.
  #PB_Button_PressedImage: Set the image displayed when the button is pressed.


  If OpenWindow(0, 0, 0, 200, 60, "ButtonImageGadget", #PB_Window_SystemMenu | #PB_Window_ScreenCentered) 
    If LoadImage(0,  #PB_Compiler_Home + "/Examples/Sources/Data/PureBasic.bmp")    ; change 2nd parameter to the path/filename of your image
      ButtonImageGadget(0, 10, 10, 180, 40, ImageID(0))
    Repeat : Until WaitWindowEvent() = #PB_Event_CloseWindow

See Also

GetGadgetState(), SetGadgetState(), GetGadgetAttribute(), SetGadgetAttribute(), ButtonGadget(), ImageID(), EventGadget()

Supported OS


<- ButtonGadget() - Gadget Index - CalendarGadget() ->