ZoomBar

ZoomBar is a class that appoximatively mimics the behaviour of the Mac Dock, inside a wx.Panel.

This is the main class implementation.

Inheritance Diagram

Inheritance diagram for: ZoomBar

Control Appearance

ZoomBar

Methods Summary

__init__	Default class constructor.
AddButton	Adds a button to ZoomBar.
AddSeparator	Adds a separator to ZoomBar.
DoGetBestSize	Gets the size which best suits the window: for a control, it would be the
DoLayout	Common method to re-layout ZoomBar.
DrawButtons	Draws all the main button bitmaps on the ZoomBar client window.
DrawLabels	Draws all the button labels on the ZoomBar client window.
DrawReflections	Draws all the reflection button bitmaps on the ZoomBar client window.
EnableButton	Enables/disables the button at position index.
GetBarColour	Returns the background button bar colour.
GetButtonSize	Returns the original (not zoomed) button size, in pixels.
GetCenterZoom	Returns True if buttons zoom upwards.
GetShowLabels	Returns True if button labels are currently shown.
GetShowReflections	Returns True if reflections bitmap are currently shown.
GetZoomFactor	Returns the current zoom factor.
HitTest	HitTest method for ZoomBar.
InitialReposition	Sets up the initial buttons and sizes them from the center.
IsButtonEnabled	Returns True if the button at position index is enabled, False
OnEraseBackground	Handles the wx.EVT_ERASE_BACKGROUND event for ZoomBar.
OnLeaveWindow	Handles the wx.EVT_LEAVE_WINDOW event for ZoomBar.
OnLeftDown	Handles the wx.EVT_LEFT_DOWN and wx.EVT_LEFT_DCLICK events for ZoomBar.
OnLeftUp	Handles the wx.EVT_LEFT_UP event for ZoomBar.
OnMotion	Handles the wx.EVT_MOTION event for ZoomBar.
OnPaint	Handles the wx.EVT_PAINT event for ZoomBar.
OnSize	Handles the wx.EVT_SIZE event for ZoomBar.
Reposition	Repositions all the buttons inside the ZoomBar.
ResetSize	Resets all the button sizes and positions, recalculating the optimal ZoomBar
SetBarColour	Sets the background button bar colour.
SetButtonSize	Sets the original button size.
SetCenterZoom	Sets to zoom from the center.
SetShowLabels	Sets whether to show button labels or not.
SetShowReflections	Sets whether to show reflections or not.
SetZoomFactor	Sets the zoom factor for all the buttons.
SnapToBottom	Snaps the background button bar bitmap and all the buttons to the bottom

Class API

class ZoomBar(wx.PyControl)

ZoomBar is a class that appoximatively mimics the behaviour of the Mac Dock, inside a wx.Panel.

This is the main class implementation.

---

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

Default class constructor.

Parameters:

• parent – the ZoomBar parent. Must not be None;
• id – window identifier. A value of -1 indicates a default value;
• 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;
• name – the window name.

---

AddButton(normalBmp, reflectionBmp=wx.NullBitmap, label="", disabledBmp=wx.NullBitmap, disabledReflectionBmp=wx.NullBitmap)

Adds a button to ZoomBar.

Parameters:

• normalBmp – the button main bitmap, an instance of wx.Bitmap;
• reflectionBmp – a bitmap representing a reflection of the main bitmap, an instance of wx.Bitmap;

• label – the button label;
• disabledBmp – the button main bitmap when the button is in a disabled state, an instance of wx.Bitmap;

• disabledReflectionBmp – a bitmap representing a reflection of the main bitmap, when the button is in a disabled state, an instance of wx.Bitmap.

---

AddSeparator(normalBmp, reflectionBmp=wx.NullBitmap)

Adds a separator to ZoomBar.

Parameters:

• normalBmp – the separator main bitmap, an instance of wx.Bitmap;

• reflectionBmp – a bitmap representing a reflection of the main bitmap, an instance of wx.Bitmap.

---

DoGetBestSize()

Gets the size which best suits the window: for a control, it would be the minimal size which doesn’t truncate the control, for a panel - the same size as it would have after a call to Fit().

Note

Overridden from wx.PyControl.

---

DoLayout()

Common method to re-layout ZoomBar.

---

DrawButtons(dc)

Draws all the main button bitmaps on the ZoomBar client window.

Parameters:dc – an instance of wx.DC.

---

DrawLabels(dc)

Draws all the button labels on the ZoomBar client window.

Parameters:dc – an instance of wx.DC.

---

DrawReflections(dc)

Draws all the reflection button bitmaps on the ZoomBar client window.

Parameters:dc – an instance of wx.DC.

---

EnableButton(index, enable=True)

Enables/disables the button at position index.

Parameters:

• index – the index of the button to enable/disable;
• enable – True to enable the button, False to disable it.

---

GetBarColour()

Returns the background button bar colour.

---

GetButtonSize()

Returns the original (not zoomed) button size, in pixels.

---

GetCenterZoom()

Returns True if buttons zoom upwards.

---

GetShowLabels()

Returns True if button labels are currently shown.

---

GetShowReflections()

Returns True if reflections bitmap are currently shown.

---

GetZoomFactor()

Returns the current zoom factor.

---

HitTest(pos)

HitTest method for ZoomBar.

Parameters:pos – the current mouse position. Returns:an index representing the button on which the mouse is hovering, or wx.NOT_FOUND if no button has been hit.

---

InitialReposition()

Sets up the initial buttons and sizes them from the center.

---

IsButtonEnabled(index)

Returns True if the button at position index is enabled, False otherwise.

Parameters:index – the index of the button to check.

---

OnEraseBackground(event)

Handles the wx.EVT_ERASE_BACKGROUND event for ZoomBar.

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

Note

This method is intentionally empty to avoid flicker.

---

OnLeaveWindow(event)

Handles the wx.EVT_LEAVE_WINDOW event for ZoomBar.

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

---

OnLeftDown(event)

Handles the wx.EVT_LEFT_DOWN and wx.EVT_LEFT_DCLICK events for ZoomBar.

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

---

OnLeftUp(event)

Handles the wx.EVT_LEFT_UP event for ZoomBar.

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

---

OnMotion(event)

Handles the wx.EVT_MOTION event for ZoomBar.

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

---

OnPaint(event)

Handles the wx.EVT_PAINT event for ZoomBar.

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

---

OnSize(event)

Handles the wx.EVT_SIZE event for ZoomBar.

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

---

Reposition(toButton)

Repositions all the buttons inside the ZoomBar.

Parameters:toButton – the button currently hovered by the mouse (and hence zoomed).

---

ResetSize()

Resets all the button sizes and positions, recalculating the optimal ZoomBar size.

---

SetBarColour(colour)

Sets the background button bar colour.

Parameters:colour – an instance of wx.Colour;

---

SetButtonSize(size)

Sets the original button size.

Parameters:size – the new (not-zoomed) button size, in pixels.

---

SetCenterZoom(center=True)

Sets to zoom from the center.

Parameters:center – if True button zooms upwards.

---

SetShowLabels(show)

Sets whether to show button labels or not.

Parameters:show – True to show button labels, False otherwise.

---

SetShowReflections(show)

Sets whether to show reflections or not.

Parameters:show – True to show reflections, False otherwise.

---

SetZoomFactor(zoom)

Sets the zoom factor for all the buttons. Larger number gives a greater zoom effect.

Parameters:zoom – a floating point number, greater than or equal to 1.0.

---

SnapToBottom(size)

Snaps the background button bar bitmap and all the buttons to the bottom of ZoomBar.

Parameters:size – the current ZoomBar size.

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