AquaButton

This is the main class implementation of AquaButton.

Inheritance Diagram

Inheritance diagram for: AquaButton

Known Subclasses

• aquabutton.AquaToggleButton

Control Appearance

AquaButton

Methods Summary

__init__	Default class constructor.
AcceptsFocus	Can this window be given focus by mouse click? ..
DoGetBestSize	Overridden base class virtual.
Enable	Enables/disables the button.
GetBackgroundColour	Returns the button colour when the mouse is not hovering on the button.
GetDefaultAttributes	Overridden base class virtual.
GetDisabledColor	Returns the button colour when it is disabled.
GetDisabledColour	Returns the button colour when it is disabled.
GetForegroundColour	Returns the text colour for AquaButton.
GetHoverColor	Returns the button colour when the mouse is hovering on the button.
GetHoverColour	Returns the button colour when the mouse is hovering on the button.
GetPath	Returns a rounded wx.GraphicsPath rectangle.
GetPulseOnFocus	Returns whether the pulsing effect is active.
Invalidate	Invalidate the saved bitmap and refresh the button.
LightColour	Return light contrast of colour.
Notify	Actually sends a wx.EVT_BUTTON event to the listener (if any).
OnGainFocus	Handles the wx.EVT_SET_FOCUS event for AquaButton.
OnKeyDown	Handles the wx.EVT_KEY_DOWN event for AquaButton.
OnKeyUp	Handles the wx.EVT_KEY_UP event for AquaButton.
OnLeftDown	Handles the wx.EVT_LEFT_DOWN event for AquaButton.
OnLeftUp	Handles the wx.EVT_LEFT_UP event for AquaButton.
OnLoseFocus	Handles the wx.EVT_KILL_FOCUS event for AquaButton.
OnMouseEnter	Handles the wx.EVT_ENTER_WINDOW event for AquaButton.
OnMouseLeave	Handles the wx.EVT_LEAVE_WINDOW event for AquaButton.
OnPaint	Handles the wx.EVT_PAINT event for AquaButton.
OnPulseTimer	Handles the wx.EVT_TIMER event for AquaButton.
OnSize	Handles the wx.EVT_SIZE event for AquaButton.
SetBackgroundColor	Sets the AquaButton background colour.
SetBackgroundColour	Sets the AquaButton background colour.
SetBestSize	Given the current font and bezel width settings, calculate and set a good size.
SetBitmapLabel	Sets the bitmap label for the button.
SetDefault	This sets the AquaButton to be the default item for the panel or dialog box.
SetDisabledColor	Sets the button colour when it is disabled.
SetDisabledColour	Sets the button colour when it is disabled.
SetForegroundColour	Sets the AquaButton foreground (text) colour.
SetHoverColor	Sets the button colour when the mouse is hovering on the button.
SetHoverColour	Sets the button colour when the mouse is hovering on the button.
SetInitialSize	Given the current font and bezel width settings, calculate and set a good size.
SetPulseOnFocus	Sets whether to enable the pulsing effect on gaining focus or not.
ShouldInheritColours	Overridden base class virtual.

Class API

class AquaButton(wx.PyControl)

This is the main class implementation of AquaButton.

---

__init__(parent, id=wx.ID_ANY, bitmap=None, label="", pos=wx.DefaultPosition, size=wx.DefaultSize, style=wx.NO_BORDER, validator=wx.DefaultValidator, name="aquabutton")

Default class constructor.

Parameters:

• parent (wx.Window) – parent window. Must not be None;
• id (integer) – window identifier. A value of -1 indicates a default value;
• bitmap (wx.Bitmap) – the button bitmap (if any);
• label (string) – the button text label;
• pos (tuple or wx.Point) – the control position. A value of (-1, -1) indicates a default position, chosen by either the windowing system or wxPython, depending on platform;
• size (tuple or wx.Size) – the control size. A value of (-1, -1) indicates a default size, chosen by either the windowing system or wxPython, depending on platform;
• style (integer) – the button style (unused);
• validator (wx.Validator) – the validator associated to the button;
• name (string) – the button name.

---

AcceptsFocus()

Can this window be given focus by mouse click?

Note

Overridden from wx.PyControl.

---

DoGetBestSize()

Overridden base class virtual. Determines the best size of the button based on the label and bezel size.

Returns:An instance of wx.Size.

Note

Overridden from wx.PyControl.

---

Enable(enable=True)

Enables/disables the button.

Parameters:enable (bool) – True to enable the button, False to disable it.

Note

Overridden from wx.PyControl.

---

GetBackgroundColour()

Returns the button colour when the mouse is not hovering on the button.

Returns:An instance of wx.Colour.

Note

Overridden from wx.PyControl.

---

GetDefaultAttributes()

Overridden base class virtual. By default we should use the same font/colour attributes as the native wx.Button.

Returns:an instance of wx.VisualAttributes.

Note

Overridden from wx.PyControl.

---

GetDisabledColor()

Returns the button colour when it is disabled.

Returns:An instance of wx.Colour.

---

GetDisabledColour()

Returns the button colour when it is disabled.

Returns:An instance of wx.Colour.

---

GetForegroundColour()

Returns the text colour for AquaButton.

Returns:An instance of wx.Colour.

Note

Overridden from wx.PyControl.

---

GetHoverColor()

Returns the button colour when the mouse is hovering on the button.

Returns:An instance of wx.Colour.

---

GetHoverColour()

Returns the button colour when the mouse is hovering on the button.

Returns:An instance of wx.Colour.

---

GetPath(gc, rc, r)

Returns a rounded wx.GraphicsPath rectangle.

Parameters:

• gc – an instance of wx.GraphicsContext;
• rc (wx.Rect) – a client rectangle;
• r (float) – the radius of the rounded part of the rectangle.

Returns:

A rounded rectangle, an instance of wx.GraphicsPath.

---

GetPulseOnFocus()

Returns whether the pulsing effect is active.

Returns:True if the pulsing effect is active, False otherwise.

---

Invalidate()

Invalidate the saved bitmap and refresh the button.

---

LightColour(colour, percent)

Return light contrast of colour. The colour returned is from the scale of colour ==> white.

Parameters:

• colour – the input colour to be brightened, a valid instance of wx.Colour;

• percent (integer) – determines how light the colour will be. percent = 100 returns white, percent = 0 returns colour.

Returns:

A light contrast of the input colour, an instance of wx.Colour.

---

Notify()

Actually sends a wx.EVT_BUTTON event to the listener (if any).

---

OnGainFocus(event)

Handles the wx.EVT_SET_FOCUS event for AquaButton.

Parameters:event – a wx.FocusEvent event to be processed.

---

OnKeyDown(event)

Handles the wx.EVT_KEY_DOWN event for AquaButton.

Parameters:event – a wx.KeyEvent event to be processed.

---

OnKeyUp(event)

Handles the wx.EVT_KEY_UP event for AquaButton.

Parameters:event – a wx.KeyEvent event to be processed.

---

OnLeftDown(event)

Handles the wx.EVT_LEFT_DOWN event for AquaButton.

Parameters:event – a wx.MouseEvent event to be processed.

---

OnLeftUp(event)

Handles the wx.EVT_LEFT_UP event for AquaButton.

Parameters:event – a wx.MouseEvent event to be processed.

---

OnLoseFocus(event)

Handles the wx.EVT_KILL_FOCUS event for AquaButton.

Parameters:event – a wx.FocusEvent event to be processed.

---

OnMouseEnter(event)

Handles the wx.EVT_ENTER_WINDOW event for AquaButton.

Parameters:event – a wx.MouseEvent event to be processed.

---

OnMouseLeave(event)

Handles the wx.EVT_LEAVE_WINDOW event for AquaButton.

Parameters:event – a wx.MouseEvent event to be processed.

---

OnPaint(event)

Handles the wx.EVT_PAINT event for AquaButton.

Parameters:event – a wx.PaintEvent event to be processed.

---

OnPulseTimer(event)

Handles the wx.EVT_TIMER event for AquaButton.

Parameters:event – a wx.TimerEvent event to be processed.

Note

This method is only invoked when pulseOnFocus is True.

---

OnSize(event)

Handles the wx.EVT_SIZE event for AquaButton.

Parameters:event – a wx.SizeEvent event to be processed.

---

SetBackgroundColor(colour)

Sets the AquaButton background colour.

Parameters:colour – a valid wx.Colour object.

Note

Overridden from wx.PyControl.

---

SetBackgroundColour(colour)

Sets the AquaButton background colour.

Parameters:colour – a valid wx.Colour object.

Note

Overridden from wx.PyControl.

---

SetBestSize(size=None)

Given the current font and bezel width settings, calculate and set a good size.

Parameters:size – an instance of wx.Size or None, in which case the wxWidgets wx.DefaultSize is used instead.

---

SetBitmapLabel(bitmap)

Sets the bitmap label for the button.

Parameters:bitmap – the bitmap label to set, an instance of wx.Bitmap.

---

SetDefault()

This sets the AquaButton to be the default item for the panel or dialog box.

Note

Under Windows, only dialog box buttons respond to this function. As normal under Windows and Motif, pressing return causes the default button to be depressed when the return key is pressed. See also wx.Window.SetFocus which sets the keyboard focus for windows and text panel items, and wx.TopLevelWindow.SetDefaultItem.

Note

Note that under Motif, calling this function immediately after creation of a button and before the creation of other buttons will cause misalignment of the row of buttons, since default buttons are larger. To get around this, call SetDefault after you have created a row of buttons: wxPython will then set the size of all buttons currently on the panel to the same size.

---

SetDisabledColor(colour)

Sets the button colour when it is disabled.

Parameters:colour – a valid wx.Colour object.

---

SetDisabledColour(colour)

Sets the button colour when it is disabled.

Parameters:colour – a valid wx.Colour object.

---

SetForegroundColour(colour)

Sets the AquaButton foreground (text) colour.

Parameters:colour – a valid wx.Colour object.

Note

Overridden from wx.PyControl.

---

SetHoverColor(colour)

Sets the button colour when the mouse is hovering on the button.

Parameters:colour – a valid wx.Colour object.

---

SetHoverColour(colour)

Sets the button colour when the mouse is hovering on the button.

Parameters:colour – a valid wx.Colour object.

---

SetInitialSize(size=None)

Given the current font and bezel width settings, calculate and set a good size.

Parameters:size – an instance of wx.Size or None, in which case the wxWidgets wx.DefaultSize is used instead.

---

SetPulseOnFocus(pulse)

Sets whether to enable the pulsing effect on gaining focus or not.

Parameters:pulse (bool) – True to enable pulsing when the AquaButton gains focus, False to disable this effect.

---

ShouldInheritColours()

Overridden base class virtual. Buttons usually don’t inherit the parent’s colours.

Note

Overridden from wx.PyControl.

AGW

• advancedsplash
• aquabutton
• artmanager
• aui
• balloontip
• buttonpanel
• cubecolourdialog
• customtreectrl
• flatmenu
• flatnotebook
• floatspin
• fmcustomizedlg
• foldpanelbar
• fourwaysplitter
• genericmessagedialog
• gradientbutton
• hyperlink
• hypertreelist
• infobar
• knobctrl
• labelbook
• multidirdialog
• peakmeter
• persist
• piectrl
• pybusyinfo
• pycollapsiblepane
• pygauge
• pyprogress
• ribbon
• rulerctrl
• shapedbutton
• shortcuteditor
• speedmeter
• supertooltip
• thumbnailctrl
• toasterbox
• ultimatelistctrl
• xlsgrid
• zoombar

Tree