GeezerVison

The World Wide Web, restored to 800 pixels of glory.

GeezerVison is showing docs.wxpython.org — wx.BitmapButton — wxPython 4.3.2 Docs

wx.BitmapButton¶

A bitmap button is a control that contains a bitmap.

Notice that since wxWidgets 2.9.1 bitmap display is supported by the base wx.Button class itself and the only tiny advantage of using this class is that it allows specifying the bitmap in its constructor, unlike wx.Button. Please see the base class documentation for more information about images support in wx.Button.

Window Styles¶

This class supports the following styles:

wx.BU_LEFT: Left-justifies the bitmap label.
wx.BU_TOP: Aligns the bitmap label to the top of the button.
wx.BU_RIGHT: Right-justifies the bitmap label.
wx.BU_BOTTOM: Aligns the bitmap label to the bottom of the button.

Note that the wx.BU_EXACTFIT style supported by wx.Button is not used by this class as bitmap buttons don’t have any minimal standard size by default.

Events Emitted by this Class¶

Handlers bound for the following event types will receive a wx.CommandEvent parameter.

EVT_BUTTON: Process a wxEVT_BUTTON event, when the button is clicked.

Class Hierarchy¶

Inheritance diagram for class BitmapButton:

Control Appearance¶

Known Subclasses¶

wx.ContextHelpButton

Methods Summary¶

`__init__`	Default constructor.
`Create`	Button creation function for two-step creation.
`CreateCloseButton`	Creation function for two-step creation of “Close” button.
`GetClassDefaultAttributes`
`NewCloseButton`	Helper function creating a standard-looking “Close” button.

Class API¶

class wx.BitmapButton(Button)¶

Possible constructors:

BitmapButton() -> None

BitmapButton(parent, id=ID_ANY, bitmap=NullBitmap, pos=DefaultPosition,
             size=DefaultSize, style=0, validator=DefaultValidator,
             name=ButtonNameStr) -> None

A bitmap button is a control that contains a bitmap.

Methods¶

__init__(self, *args, **kw)¶

Overloaded Implementations:

__init__ (self)

Default constructor.

Return type:: None

__init__ (self, parent, id=ID_ANY, bitmap=NullBitmap, pos=DefaultPosition, size=DefaultSize, style=0, validator=DefaultValidator, name=ButtonNameStr)

Constructor, creating and showing a button.

Parameters:

parent (wx.Window) – Parent window. Must not be nullptr.
id (wx.WindowID) – Button identifier. The value wx.ID_ANY indicates a default value.
bitmap (wx.BitmapBundle) – Bitmap to be displayed.
pos (wx.Point) – Button position. If wx.DefaultPosition is specified then a default position is chosen.
size (wx.Size) – Button size. If wx.DefaultSize is specified then the button is sized appropriately for the bitmap.
style (long) – Window style. See wx.BitmapButton.
validator (wx.Validator) – Window validator.
name (string) – Window name.

Return type:

None

Note

The bitmap parameter is normally the only bitmap you need to provide, and wxWidgets will draw the button correctly in its different states. If you want more control, call any of the functions SetBitmapPressed , SetBitmapFocus , SetBitmapDisabled .