SButton

This is the main implementation of ShapedButton.

Inheritance Diagram

Inheritance diagram for: SButton

Known Subclasses

• shapedbutton.SBitmapButton
• shapedbutton.SToggleButton

Methods Summary

__init__	Default class constructor.
AcceptsFocus	Can this window be given focus by mouse click? ..
ConvertPILToWX	Converts a PIL image into a wx.Image.
ConvertWXToPIL	Converts a wx.Image into a PIL image.
DoGetBestSize	Overridden base class virtual.
DrawFocusIndicator	Draws the focus indicator.
DrawLabel	Draws the label on the button.
DrawMainButton	Draws the main button, in whichever state it is.
Enable	Enables/disables the button.
GetAngleOfRotation	Returns angle of button label rotation, in degrees.
GetButtonColour	Returns the button colour.
GetEllipseAxis	Returns the ellipse axes.
GetLabel	Returns the button label.
GetLabelColour	Returns the button label colour.
GetUseFocusIndicator	Returns focus indicator flag.
InitColours	Calculates a new set of focus indicator colour and indicator pen
IsEnabled	Returns wheter the button is enabled or not.
IsOutside	Checks if a mouse events occurred inside the circle/ellipse or not.
MakePalette	Creates a palette to be applied on an image based on input colour.
Notify	Notifies an event and let it be processed.
OnGainFocus	Handles the wx.EVT_SET_FOCUS event for SButton.
OnKeyDown	Handles the wx.EVT_KEY_DOWN event for SButton.
OnKeyUp	Handles the wx.EVT_KEY_UP event for SButton.
OnLeftDown	Handles the wx.EVT_LEFT_DOWN event for SButton.
OnLeftUp	Handles the wx.EVT_LEFT_UP event for SButton.
OnLoseFocus	Handles the wx.EVT_KILL_FOCUS event for SButton.
OnMotion	Handles the wx.EVT_MOTION event for SButton.
OnPaint	Handles the wx.EVT_PAINT event for SButton.
OnSize	Handles the wx.EVT_SIZE event for SButton.
SetAngleOfRotation	Sets angle of button label rotation.
SetBestSize	Given the current font settings, calculate and set a good size.
SetButtonColour	Sets the button colour, for all button states.
SetDefault	Sets the button as default item.
SetEllipseAxis	Sets the ellipse axis.
SetLabel	Sets the button label.
SetLabelColour	Sets the button label colour.
SetUseFocusIndicator	Specifies if a focus indicator (dotted line) should be used.
ShouldInheritColours	Overridden base class virtual.
_GetLabelSize	Used internally

Class API

class SButton(wx.Window)

This is the main implementation of ShapedButton.

---

__init__(parent, id=wx.ID_ANY, label="", pos=wx.DefaultPosition, size=wx.DefaultSize)

Default class constructor.

Parameters:

• parent – the SButton parent. Must not be None;
• id – window identifier. A value of -1 indicates a default value;
• label – the button text label;
• pos – the control position. A value of (-1, -1) indicates a default position, chosen by either the windowing system or wxPython, depending on platform;
• size – the control size. A value of (-1, -1) indicates a default size, chosen by either the windowing system or wxPython, depending on platform.

---

AcceptsFocus()

Can this window be given focus by mouse click?

Note

Overridden from wx.Window.

---

ConvertPILToWX(pil, alpha=True)

Converts a PIL image into a wx.Image.

Parameters:

• pil – a PIL image;
• alpha – True if the image contains alpha transparency, False otherwise.

---

ConvertWXToPIL(bmp)

Converts a wx.Image into a PIL image.

Parameters:bmp – an instance of wx.Image.

---

DoGetBestSize()

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

Note

Overridden from wx.Window.

---

DrawFocusIndicator(dc, width, height)

Draws the focus indicator. This is a circle/ellipse inside the button drawn with a dotted-style pen, to let the user know which button has the focus.

Parameters:

• dc – an instance of wx.DC;
• width – the button width;
• height – the button height.

---

DrawLabel(dc, width, height, dw=0, dh=0)

Draws the label on the button.

Parameters:

• dc – an instance of wx.DC;

• width – the button width;
• height – the button height;
• dw – width differential, to show a 3D effect;
• dh – height differential, to show a 3D effect.

---

DrawMainButton(dc, width, height)

Draws the main button, in whichever state it is.

Parameters:

• dc – an instance of wx.DC;

• width – the button width;
• height – the button height.

---

Enable(enable=True)

Enables/disables the button.

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

Note

Overridden from wx.Window.

---

GetAngleOfRotation()

Returns angle of button label rotation, in degrees.

---

GetButtonColour()

Returns the button colour.

---

GetEllipseAxis()

Returns the ellipse axes.

---

GetLabel()

Returns the button label.

---

GetLabelColour()

Returns the button label colour.

---

GetUseFocusIndicator()

Returns focus indicator flag.

---

InitColours()

Calculates a new set of focus indicator colour and indicator pen based on button colour and label colour.

---

IsEnabled()

Returns wheter the button is enabled or not.

---

IsOutside(x, y)

Checks if a mouse events occurred inside the circle/ellipse or not.

Parameters:

• x – the mouse x position;
• y – the mouse y position.

---

MakePalette(tr, tg, tb)

Creates a palette to be applied on an image based on input colour.

Parameters:

• tr – the red intensity of the input colour;
• tg – the green intensity of the input colour;
• tb – the blue intensity of the input colour.

---

Notify()

Notifies an event and let it be processed.

---

OnGainFocus(event)

Handles the wx.EVT_SET_FOCUS event for SButton.

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

---

OnKeyDown(event)

Handles the wx.EVT_KEY_DOWN event for SButton.

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

---

OnKeyUp(event)

Handles the wx.EVT_KEY_UP event for SButton.

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

---

OnLeftDown(event)

Handles the wx.EVT_LEFT_DOWN event for SButton.

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

---

OnLeftUp(event)

Handles the wx.EVT_LEFT_UP event for SButton.

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

---

OnLoseFocus(event)

Handles the wx.EVT_KILL_FOCUS event for SButton.

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

---

OnMotion(event)

Handles the wx.EVT_MOTION event for SButton.

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

---

OnPaint(event)

Handles the wx.EVT_PAINT event for SButton.

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

---

OnSize(event)

Handles the wx.EVT_SIZE event for SButton.

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

---

SetAngleOfRotation(angle=None)

Sets angle of button label rotation.

Parameters:angle – the label rotation, in degrees.

---

SetBestSize(size=None)

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

Parameters:size – if not None, an instance of wx.Size to pass to SetInitialSize.

---

SetButtonColour(colour=None)

Sets the button colour, for all button states.

Parameters:colour – an instance of wx.Colour.

Note

The original button images are greyscale with a lot of pixels with different colours. Changing smoothly the button colour in order to give the same 3D effect can be efficiently done only with PIL.

---

SetDefault()

Sets the button as default item.

---

SetEllipseAxis(main=None, secondary=None)

Sets the ellipse axis. What it is important is not their absolute values but their ratio.

Parameters:

• main – a floating point number representing the absolute dimension of the main ellipse axis;
• secondary – a floating point number representing the absolute dimension of the secondary ellipse axis.

---

SetLabel(label=None)

Sets the button label.

Parameters:label – the new button label.

---

SetLabelColour(colour=None)

Sets the button label colour.

Parameters:colour – an instance of wx.Colour.

---

SetUseFocusIndicator(flag)

Specifies if a focus indicator (dotted line) should be used.

Parameters:flag – True to use the focus indicator, False otherwise.

---

ShouldInheritColours()

Overridden base class virtual. Buttons usually do not inherit parent’s colours.

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