--- /dev/null
+"""
+auibar contains an implementation of L{AuiToolBar}, which is a completely owner-drawn
+toolbar perfectly integrated with the AUI layout system. This allows drag and drop of
+toolbars, docking/floating behaviour and the possibility to define "overflow" items
+in the toolbar itself.
+
+The default theme that is used is L{AuiDefaultToolBarArt}, which provides a modern,
+glossy look and feel. The theme can be changed by calling L{AuiToolBar.SetArtProvider}.
+"""
+
+__author__ = "Andrea Gavana <andrea.gavana@gmail.com>"
+__date__ = "31 March 2009"
+
+
+import wx
+import types
+
+from aui_utilities import BitmapFromBits, StepColour, GetLabelSize
+from aui_utilities import GetBaseColour, MakeDisabledBitmap
+
+import framemanager
+from aui_constants import *
+
+# wxPython version string
+_VERSION_STRING = wx.VERSION_STRING
+
+# AuiToolBar events
+wxEVT_COMMAND_AUITOOLBAR_TOOL_DROPDOWN = wx.NewEventType()
+wxEVT_COMMAND_AUITOOLBAR_OVERFLOW_CLICK = wx.NewEventType()
+wxEVT_COMMAND_AUITOOLBAR_RIGHT_CLICK = wx.NewEventType()
+wxEVT_COMMAND_AUITOOLBAR_MIDDLE_CLICK = wx.NewEventType()
+wxEVT_COMMAND_AUITOOLBAR_BEGIN_DRAG = wx.NewEventType()
+
+EVT_AUITOOLBAR_TOOL_DROPDOWN = wx.PyEventBinder(wxEVT_COMMAND_AUITOOLBAR_TOOL_DROPDOWN, 1)
+""" A dropdown `AuiToolBarItem` is being shown. """
+EVT_AUITOOLBAR_OVERFLOW_CLICK = wx.PyEventBinder(wxEVT_COMMAND_AUITOOLBAR_OVERFLOW_CLICK, 1)
+""" The user left-clicked on the overflow button in `AuiToolBar`. """
+EVT_AUITOOLBAR_RIGHT_CLICK = wx.PyEventBinder(wxEVT_COMMAND_AUITOOLBAR_RIGHT_CLICK, 1)
+""" Fires an event when the user right-clicks on a `AuiToolBarItem`. """
+EVT_AUITOOLBAR_MIDDLE_CLICK = wx.PyEventBinder(wxEVT_COMMAND_AUITOOLBAR_MIDDLE_CLICK, 1)
+""" Fires an event when the user middle-clicks on a `AuiToolBarItem`. """
+EVT_AUITOOLBAR_BEGIN_DRAG = wx.PyEventBinder(wxEVT_COMMAND_AUITOOLBAR_BEGIN_DRAG, 1)
+""" A drag operation involving a toolbar item has started. """
+
+# ----------------------------------------------------------------------
+
+class CommandToolBarEvent(wx.PyCommandEvent):
+ """ A specialized command event class for events sent by L{AuiToolBar}. """
+
+ def __init__(self, command_type, win_id):
+ """
+ Default class constructor.
+
+ :param `command_type`: the event kind or an instance of `wx.PyCommandEvent`.
+ :param `win_id`: the window identification number.
+ """
+
+ if type(command_type) == types.IntType:
+ wx.PyCommandEvent.__init__(self, command_type, win_id)
+ else:
+ wx.PyCommandEvent.__init__(self, command_type.GetEventType(), command_type.GetId())
+
+ self.is_dropdown_clicked = False
+ self.click_pt = wx.Point(-1, -1)
+ self.rect = wx.Rect(-1, -1, 0, 0)
+ self.tool_id = -1
+
+
+ def IsDropDownClicked(self):
+ """ Returns whether the drop down menu has been clicked. """
+
+ return self.is_dropdown_clicked
+
+
+ def SetDropDownClicked(self, c):
+ """
+ Sets whether the drop down menu has been clicked.
+
+ :param `c`: ``True`` to set the drop down as clicked, ``False`` otherwise.
+ """
+
+ self.is_dropdown_clicked = c
+
+
+ def GetClickPoint(self):
+ """ Returns the point where the user clicked with the mouse. """
+
+ return self.click_pt
+
+
+ def SetClickPoint(self, p):
+ """
+ Sets the clicking point.
+
+ :param `p`: a `wx.Point` object.
+ """
+
+ self.click_pt = p
+
+
+ def GetItemRect(self):
+ """ Returns the L{AuiToolBarItem} rectangle. """
+
+ return self.rect
+
+
+ def SetItemRect(self, r):
+ """
+ Sets the L{AuiToolBarItem} rectangle.
+
+ :param `r`: an instance of `wx.Rect`.
+ """
+
+ self.rect = r
+
+
+ def GetToolId(self):
+ """ Returns the L{AuiToolBarItem} identifier. """
+
+ return self.tool_id
+
+
+ def SetToolId(self, id):
+ """
+ Sets the L{AuiToolBarItem} identifier.
+
+ :param `id`: the toolbar item identifier.
+ """
+
+ self.tool_id = id
+
+
+# ----------------------------------------------------------------------
+
+class AuiToolBarEvent(CommandToolBarEvent):
+ """ A specialized command event class for events sent by L{AuiToolBar}. """
+
+ def __init__(self, command_type=None, win_id=0):
+ """
+ Default class constructor.
+
+ :param `command_type`: the event kind or an instance of `wx.PyCommandEvent`.
+ :param `win_id`: the window identification number.
+ """
+
+ CommandToolBarEvent.__init__(self, command_type, win_id)
+
+ if type(command_type) == types.IntType:
+ self.notify = wx.NotifyEvent(command_type, win_id)
+ else:
+ self.notify = wx.NotifyEvent(command_type.GetEventType(), command_type.GetId())
+
+
+ def GetNotifyEvent(self):
+ """ Returns the actual `wx.NotifyEvent`. """
+
+ return self.notify
+
+
+ def IsAllowed(self):
+ """ Returns whether the event is allowed or not. """
+
+ return self.notify.IsAllowed()
+
+
+ def Veto(self):
+ """
+ Prevents the change announced by this event from happening.
+
+ It is in general a good idea to notify the user about the reasons for
+ vetoing the change because otherwise the applications behaviour (which
+ just refuses to do what the user wants) might be quite surprising.
+ """
+
+ self.notify.Veto()
+
+
+ def Allow(self):
+ """
+ This is the opposite of L{Veto}: it explicitly allows the event to be
+ processed. For most events it is not necessary to call this method as the
+ events are allowed anyhow but some are forbidden by default (this will
+ be mentioned in the corresponding event description).
+ """
+
+ self.notify.Allow()
+
+
+# ----------------------------------------------------------------------
+
+class ToolbarCommandCapture(wx.PyEvtHandler):
+ """ A class to handle the dropdown window menu. """
+
+ def __init__(self):
+ """ Default class constructor. """
+
+ wx.PyEvtHandler.__init__(self)
+ self._last_id = 0
+
+
+ def GetCommandId(self):
+ """ Returns the event command identifier. """
+
+ return self._last_id
+
+
+ def ProcessEvent(self, event):
+ """
+ Processes an event, searching event tables and calling zero or more suitable
+ event handler function(s).
+
+ :param `event`: the event to process.
+
+ :note: Normally, your application would not call this function: it is called
+ in the wxPython implementation to dispatch incoming user interface events
+ to the framework (and application).
+ However, you might need to call it if implementing new functionality (such as
+ a new control) where you define new event types, as opposed to allowing the
+ user to override functions.
+
+ An instance where you might actually override the L{ProcessEvent} function is where
+ you want to direct event processing to event handlers not normally noticed by
+ wxPython. For example, in the document/view architecture, documents and views
+ are potential event handlers. When an event reaches a frame, L{ProcessEvent} will
+ need to be called on the associated document and view in case event handler
+ functions are associated with these objects.
+
+ The normal order of event table searching is as follows:
+
+ 1. If the object is disabled (via a call to `SetEvtHandlerEnabled`) the function
+ skips to step (6).
+ 2. If the object is a `wx.Window`, L{ProcessEvent} is recursively called on the window's
+ `wx.Validator`. If this returns ``True``, the function exits.
+ 3. wxWidgets `SearchEventTable` is called for this event handler. If this fails, the
+ base class table is tried, and so on until no more tables exist or an appropriate
+ function was found, in which case the function exits.
+ 4. The search is applied down the entire chain of event handlers (usually the chain
+ has a length of one). If this succeeds, the function exits.
+ 5. If the object is a `wx.Window` and the event is a `wx.CommandEvent`, L{ProcessEvent} is
+ recursively applied to the parent window's event handler. If this returns ``True``,
+ the function exits.
+ 6. Finally, L{ProcessEvent} is called on the `wx.App` object.
+ """
+
+ if event.GetEventType() == wx.wxEVT_COMMAND_MENU_SELECTED:
+ self._last_id = event.GetId()
+ return True
+
+ if self.GetNextHandler():
+ return self.GetNextHandler().ProcessEvent(event)
+
+ return False
+
+
+# ----------------------------------------------------------------------
+
+class AuiToolBarItem(object):
+ """
+ AuiToolBarItem is a toolbar element.
+
+ It has a unique id (except for the separators which always have id = -1), the
+ style (telling whether it is a normal button, separator or a control), the
+ state (toggled or not, enabled or not) and short and long help strings. The
+ default implementations use the short help string for the tooltip text which
+ is popped up when the mouse pointer enters the tool and the long help string
+ for the applications status bar.
+ """
+
+ def __init__(self, item=None):
+ """
+ Default class constructor.
+
+ :param `item`: another instance of L{AuiToolBarItem}.
+ """
+
+ if item:
+ self.Assign(item)
+ return
+
+ self.window = None
+ self.clockwisebmp = wx.NullBitmap
+ self.counterclockwisebmp = wx.NullBitmap
+ self.clockwisedisbmp = wx.NullBitmap
+ self.counterclockwisedisbmp = wx.NullBitmap
+ self.sizer_item = None
+ self.spacer_pixels = 0
+ self.id = 0
+ self.kind = ITEM_NORMAL
+ self.state = 0 # normal, enabled
+ self.proportion = 0
+ self.active = True
+ self.dropdown = True
+ self.sticky = True
+ self.user_data = 0
+
+ self.label = ""
+ self.bitmap = wx.NullBitmap
+ self.disabled_bitmap = wx.NullBitmap
+ self.hover_bitmap = wx.NullBitmap
+ self.short_help = ""
+ self.long_help = ""
+ self.min_size = wx.Size(-1, -1)
+ self.alignment = wx.ALIGN_CENTER
+ self.orientation = AUI_TBTOOL_HORIZONTAL
+
+
+ def Assign(self, c):
+ """
+ Assigns the properties of the L{AuiToolBarItem} `c` to `self`.
+
+ :param `c`: another instance of L{AuiToolBarItem}.
+ """
+
+ self.window = c.window
+ self.label = c.label
+ self.bitmap = c.bitmap
+ self.disabled_bitmap = c.disabled_bitmap
+ self.hover_bitmap = c.hover_bitmap
+ self.short_help = c.short_help
+ self.long_help = c.long_help
+ self.sizer_item = c.sizer_item
+ self.min_size = c.min_size
+ self.spacer_pixels = c.spacer_pixels
+ self.id = c.id
+ self.kind = c.kind
+ self.state = c.state
+ self.proportion = c.proportion
+ self.active = c.active
+ self.dropdown = c.dropdown
+ self.sticky = c.sticky
+ self.user_data = c.user_data
+ self.alignment = c.alignment
+ self.orientation = c.orientation
+
+
+ def SetWindow(self, w):
+ """
+ Assigns a window to the toolbar item.
+
+ :param `w`: an instance of `wx.Window`.
+ """
+
+ self.window = w
+
+
+ def GetWindow(self):
+ """ Returns window associated to the toolbar item. """
+
+ return self.window
+
+
+ def SetId(self, new_id):
+ """
+ Sets the toolbar item identifier.
+
+ :param `new_id`: the new tool id.
+ """
+
+ self.id = new_id
+
+
+ def GetId(self):
+ """ Returns the toolbar item identifier. """
+
+ return self.id
+
+
+ def SetKind(self, new_kind):
+ """
+ Sets the L{AuiToolBarItem} kind.
+
+ :param `new_kind`: can be one of the following items:
+
+ ======================== =============================
+ Item Kind Description
+ ======================== =============================
+ ``ITEM_CONTROL`` The item in the `AuiToolBar` is a control
+ ``ITEM_LABEL`` The item in the `AuiToolBar` is a text label
+ ``ITEM_SPACER`` The item in the `AuiToolBar` is a spacer
+ ``ITEM_SEPARATOR`` The item in the `AuiToolBar` is a separator
+ ``ITEM_CHECK`` The item in the `AuiToolBar` is a toolbar check item
+ ``ITEM_NORMAL`` The item in the `AuiToolBar` is a standard toolbar item
+ ``ITEM_RADIO`` The item in the `AuiToolBar` is a toolbar radio item
+ ======================== =============================
+ """
+
+ self.kind = new_kind
+
+
+ def GetKind(self):
+ """ Returns the toolbar item kind. See L{SetKind} for more details. """
+
+ return self.kind
+
+
+ def SetState(self, new_state):
+ """
+ Sets the toolbar item state.
+
+ :param `new_state`: can be one of the following states:
+
+ ============================================ ======================================
+ Button State Constant Description
+ ============================================ ======================================
+ ``AUI_BUTTON_STATE_NORMAL`` Normal button state
+ ``AUI_BUTTON_STATE_HOVER`` Hovered button state
+ ``AUI_BUTTON_STATE_PRESSED`` Pressed button state
+ ``AUI_BUTTON_STATE_DISABLED`` Disabled button state
+ ``AUI_BUTTON_STATE_HIDDEN`` Hidden button state
+ ``AUI_BUTTON_STATE_CHECKED`` Checked button state
+ ============================================ ======================================
+
+ """
+
+ self.state = new_state
+
+
+ def GetState(self):
+ """
+ Returns the toolbar item state. See L{SetState} for more details.
+
+ :see: L{SetState}
+ """
+
+ return self.state
+
+
+ def SetSizerItem(self, s):
+ """
+ Associates a sizer item to this toolbar item.
+
+ :param `s`: an instance of `wx.SizerItem`.
+ """
+
+ self.sizer_item = s
+
+
+ def GetSizerItem(self):
+ """ Returns the associated sizer item. """
+
+ return self.sizer_item
+
+
+ def SetLabel(self, s):
+ """
+ Sets the toolbar item label.
+
+ :param `s`: a string specifying the toolbar item label.
+ """
+
+ self.label = s
+
+
+ def GetLabel(self):
+ """ Returns the toolbar item label. """
+
+ return self.label
+
+
+ def SetBitmap(self, bmp):
+ """
+ Sets the toolbar item bitmap.
+
+ :param `bmp`: an instance of `wx.Bitmap`.
+ """
+
+ self.bitmap = bmp
+
+
+ def GetBitmap(self):
+ """ Returns the toolbar item bitmap. """
+
+ return self.GetRotatedBitmap(False)
+
+
+ def SetDisabledBitmap(self, bmp):
+ """
+ Sets the toolbar item disabled bitmap.
+
+ :param `bmp`: an instance of `wx.Bitmap`.
+ """
+
+ self.disabled_bitmap = bmp
+
+
+ def GetDisabledBitmap(self):
+ """ Returns the toolbar item disabled bitmap. """
+
+ return self.GetRotatedBitmap(True)
+
+
+ def SetHoverBitmap(self, bmp):
+ """
+ Sets the toolbar item hover bitmap.
+
+ :param `bmp`: an instance of `wx.Bitmap`.
+ """
+
+ self.hover_bitmap = bmp
+
+
+ def SetOrientation(self, a):
+ """
+ Sets the toolbar tool orientation.
+
+ :param `a`: one of ``AUI_TBTOOL_HORIZONTAL``, ``AUI_TBTOOL_VERT_CLOCKWISE`` or
+ ``AUI_TBTOOL_VERT_COUNTERCLOCKWISE``.
+ """
+
+ self.orientation = a
+
+
+ def GetOrientation(self):
+ """ Returns the toolbar tool orientation. """
+
+ return self.orientation
+
+
+ def GetHoverBitmap(self):
+ """ Returns the toolbar item hover bitmap. """
+
+ return self.hover_bitmap
+
+
+ def GetRotatedBitmap(self, disabled):
+ """
+ Returns the correct bitmap depending on the tool orientation.
+
+ :param `disabled`: whether to return the disabled bitmap or not.
+ """
+
+ bitmap_to_rotate = (disabled and [self.disabled_bitmap] or [self.bitmap])[0]
+ if not bitmap_to_rotate.IsOk() or self.orientation == AUI_TBTOOL_HORIZONTAL:
+ return bitmap_to_rotate
+
+ rotated_bitmap = wx.NullBitmap
+ clockwise = True
+ if self.orientation == AUI_TBTOOL_VERT_CLOCKWISE:
+ rotated_bitmap = (disabled and [self.clockwisedisbmp] or [self.clockwisebmp])[0]
+
+ elif self.orientation == AUI_TBTOOL_VERT_COUNTERCLOCKWISE:
+ rotated_bitmap = (disabled and [self.counterclockwisedisbmp] or [self.counterclockwisebmp])[0]
+ clockwise = False
+
+ if not rotated_bitmap.IsOk():
+ rotated_bitmap = wx.BitmapFromImage(bitmap_to_rotate.ConvertToImage().Rotate90(clockwise))
+
+ return rotated_bitmap
+
+
+ def SetShortHelp(self, s):
+ """
+ Sets the short help string for the L{AuiToolBarItem}, to be displayed in a
+ `wx.ToolTip` when the mouse hover over the toolbar item.
+
+ :param `s`: the tool short help string.
+ """
+
+ self.short_help = s
+
+
+ def GetShortHelp(self):
+ """ Returns the short help string for the L{AuiToolBarItem}. """
+
+ return self.short_help
+
+
+ def SetLongHelp(self, s):
+ """
+ Sets the long help string for the toolbar item. This string is shown in the
+ statusbar (if any) of the parent frame when the mouse pointer is inside the
+ tool.
+
+ :param `s`: the tool long help string.
+ """
+
+ self.long_help = s
+
+
+ def GetLongHelp(self):
+ """ Returns the long help string for the L{AuiToolBarItem}. """
+
+ return self.long_help
+
+
+ def SetMinSize(self, s):
+ """
+ Sets the toolbar item minimum size.
+
+ :param `s`: an instance of `wx.Size`.
+ """
+
+ self.min_size = wx.Size(*s)
+
+
+ def GetMinSize(self):
+ """ Returns the toolbar item minimum size. """
+
+ return self.min_size
+
+
+ def SetSpacerPixels(self, s):
+ """
+ Sets the number of pixels for a toolbar item with kind = ``ITEM_SEPARATOR``.
+
+ :param `s`: number of pixels.
+ """
+
+ self.spacer_pixels = s
+
+
+ def GetSpacerPixels(self):
+ """ Returns the number of pixels for a toolbar item with kind = ``ITEM_SEPARATOR``. """
+
+ return self.spacer_pixels
+
+
+ def SetProportion(self, p):
+ """
+ Sets the L{AuiToolBarItem} proportion in the toolbar.
+
+ :param `p`: the item proportion.
+ """
+
+ self.proportion = p
+
+
+ def GetProportion(self):
+ """ Returns the L{AuiToolBarItem} proportion in the toolbar. """
+
+ return self.proportion
+
+
+ def SetActive(self, b):
+ """
+ Activates/deactivates the toolbar item.
+
+ :param `b`: ``True`` to activate the item, ``False`` to deactivate it.
+ """
+
+ self.active = b
+
+
+ def IsActive(self):
+ """ Returns whether the toolbar item is active or not. """
+
+ return self.active
+
+
+ def SetHasDropDown(self, b):
+ """
+ Sets whether the toolbar item has an associated dropdown menu.
+
+ :param `b`: ``True`` to set a dropdown menu, ``False`` otherwise.
+ """
+
+ self.dropdown = b
+
+
+ def HasDropDown(self):
+ """ Returns whether the toolbar item has an associated dropdown menu or not. """
+
+ return self.dropdown
+
+
+ def SetSticky(self, b):
+ """
+ Sets whether the toolbar item is sticky (permanent highlight after mouse enter)
+ or not.
+
+ :param `b`: ``True`` to set the item as sticky, ``False`` otherwise.
+ """
+
+ self.sticky = b
+
+
+ def IsSticky(self):
+ """ Returns whether the toolbar item has a sticky behaviour or not. """
+
+ return self.sticky
+
+
+ def SetUserData(self, l):
+ """
+ Associates some kind of user data to the toolbar item.
+
+ :param `l`: a Python object.
+
+ :note: The user data can be any Python object.
+ """
+
+ self.user_data = l
+
+
+ def GetUserData(self):
+ """ Returns the associated user data. """
+
+ return self.user_data
+
+
+ def SetAlignment(self, l):
+ """
+ Sets the toolbar item alignment.
+
+ :param `l`: the item alignment, which can be one of the available `wx.Sizer`
+ alignments.
+ """
+
+ self.alignment = l
+
+
+ def GetAlignment(self):
+ """ Returns the toolbar item alignment. """
+
+ return self.alignment
+
+
+# ----------------------------------------------------------------------
+
+class AuiDefaultToolBarArt(object):
+ """
+ Toolbar art provider code - a tab provider provides all drawing functionality to
+ the L{AuiToolBar}. This allows the L{AuiToolBar} to have a plugable look-and-feel.
+
+ By default, a L{AuiToolBar} uses an instance of this class called L{AuiDefaultToolBarArt}
+ which provides bitmap art and a colour scheme that is adapted to the major platforms'
+ look. You can either derive from that class to alter its behaviour or write a
+ completely new tab art class. Call L{AuiToolBar.SetArtProvider} to make use this
+ new tab art.
+ """
+
+ def __init__(self):
+ """ Default class constructor. """
+
+ self._base_colour = GetBaseColour()
+
+ self._agwFlags = 0
+ self._text_orientation = AUI_TBTOOL_TEXT_BOTTOM
+ self._highlight_colour = wx.SystemSettings.GetColour(wx.SYS_COLOUR_HIGHLIGHT)
+
+ self._separator_size = 7
+ self._orientation = AUI_TBTOOL_HORIZONTAL
+ self._gripper_size = 7
+ self._overflow_size = 16
+
+ darker1_colour = StepColour(self._base_colour, 85)
+ darker2_colour = StepColour(self._base_colour, 75)
+ darker3_colour = StepColour(self._base_colour, 60)
+ darker4_colour = StepColour(self._base_colour, 50)
+ darker5_colour = StepColour(self._base_colour, 40)
+
+ self._gripper_pen1 = wx.Pen(darker5_colour)
+ self._gripper_pen2 = wx.Pen(darker3_colour)
+ self._gripper_pen3 = wx.WHITE_PEN
+
+ button_dropdown_bits = "\xe0\xf1\xfb"
+ overflow_bits = "\x80\xff\x80\xc1\xe3\xf7"
+
+ self._button_dropdown_bmp = BitmapFromBits(button_dropdown_bits, 5, 3, wx.BLACK)
+ self._disabled_button_dropdown_bmp = BitmapFromBits(button_dropdown_bits, 5, 3,
+ wx.Colour(128, 128, 128))
+ self._overflow_bmp = BitmapFromBits(overflow_bits, 7, 6, wx.BLACK)
+ self._disabled_overflow_bmp = BitmapFromBits(overflow_bits, 7, 6, wx.Colour(128, 128, 128))
+
+ self._font = wx.SystemSettings.GetFont(wx.SYS_DEFAULT_GUI_FONT)
+
+
+ def Clone(self):
+ """ Clones the L{AuiToolBar} art. """
+
+ return AuiDefaultToolBarArt()
+
+
+ def SetAGWFlags(self, agwFlags):
+ """
+ Sets the toolbar art flags.
+
+ :param `agwFlags`: a combination of the following values:
+
+ ==================================== ==================================
+ Flag name Description
+ ==================================== ==================================
+ ``AUI_TB_TEXT`` Shows the text in the toolbar buttons; by default only icons are shown
+ ``AUI_TB_NO_TOOLTIPS`` Don't show tooltips on `AuiToolBar` items
+ ``AUI_TB_NO_AUTORESIZE`` Do not auto-resize the `AuiToolBar`
+ ``AUI_TB_GRIPPER`` Shows a gripper on the `AuiToolBar`
+ ``AUI_TB_OVERFLOW`` The `AuiToolBar` can contain overflow items
+ ``AUI_TB_VERTICAL`` The `AuiToolBar` is vertical
+ ``AUI_TB_HORZ_LAYOUT`` Shows the text and the icons alongside, not vertically stacked. This style must be used with ``AUI_TB_TEXT``
+ ``AUI_TB_PLAIN_BACKGROUND`` Don't draw a gradient background on the toolbar
+ ``AUI_TB_HORZ_TEXT`` Combination of ``AUI_TB_HORZ_LAYOUT`` and ``AUI_TB_TEXT``
+ ==================================== ==================================
+
+ """
+
+ self._agwFlags = agwFlags
+
+
+ def GetAGWFlags(self):
+ """
+ Returns the L{AuiDefaultToolBarArt} flags. See L{SetAGWFlags} for more
+ details.
+
+ :see: L{SetAGWFlags}
+ """
+
+ return self._agwFlags
+
+
+ def SetFont(self, font):
+ """
+ Sets the L{AuiDefaultToolBarArt} font.
+
+ :param `font`: a `wx.Font` object.
+ """
+
+ self._font = font
+
+
+ def SetTextOrientation(self, orientation):
+ """
+ Sets the text orientation.
+
+ :param `orientation`: can be one of the following constants:
+
+ ==================================== ==================================
+ Orientation Switches Description
+ ==================================== ==================================
+ ``AUI_TBTOOL_TEXT_LEFT`` Text in `AuiToolBar` items is aligned left
+ ``AUI_TBTOOL_TEXT_RIGHT`` Text in `AuiToolBar` items is aligned right
+ ``AUI_TBTOOL_TEXT_TOP`` Text in `AuiToolBar` items is aligned top
+ ``AUI_TBTOOL_TEXT_BOTTOM`` Text in `AuiToolBar` items is aligned bottom
+ ==================================== ==================================
+
+ """
+
+ self._text_orientation = orientation
+
+
+ def GetFont(self):
+ """ Returns the L{AuiDefaultToolBarArt} font. """
+
+ return self._font
+
+
+ def GetTextOrientation(self):
+ """
+ Returns the L{AuiDefaultToolBarArt} text orientation. See
+ L{SetTextOrientation} for more details.
+
+ :see: L{SetTextOrientation}
+ """
+
+ return self._text_orientation
+
+
+ def SetOrientation(self, orientation):
+ """
+ Sets the toolbar tool orientation.
+
+ :param `orientation`: one of ``AUI_TBTOOL_HORIZONTAL``, ``AUI_TBTOOL_VERT_CLOCKWISE`` or
+ ``AUI_TBTOOL_VERT_COUNTERCLOCKWISE``.
+ """
+
+ self._orientation = orientation
+
+
+ def GetOrientation(self):
+ """ Returns the toolbar orientation. """
+
+ return self._orientation
+
+
+ def DrawBackground(self, dc, wnd, _rect, horizontal=True):
+ """
+ Draws a toolbar background with a gradient shading.
+
+ :param `dc`: a `wx.DC` device context;
+ :param `wnd`: a `wx.Window` derived window;
+ :param `_rect`: the L{AuiToolBar} rectangle;
+ :param `horizontal`: ``True`` if the toolbar is horizontal, ``False`` if it is vertical.
+ """
+
+ rect = wx.Rect(*_rect)
+
+ start_colour = StepColour(self._base_colour, 180)
+ end_colour = StepColour(self._base_colour, 85)
+ reflex_colour = StepColour(self._base_colour, 95)
+
+ dc.GradientFillLinear(rect, start_colour, end_colour,
+ (horizontal and [wx.SOUTH] or [wx.EAST])[0])
+
+ left = rect.GetLeft()
+ right = rect.GetRight()
+ top = rect.GetTop()
+ bottom = rect.GetBottom()
+
+ dc.SetPen(wx.Pen(reflex_colour))
+ if horizontal:
+ dc.DrawLine(left, bottom, right+1, bottom)
+ else:
+ dc.DrawLine(right, top, right, bottom+1)
+
+
+ def DrawPlainBackground(self, dc, wnd, _rect):
+ """
+ Draws a toolbar background with a plain colour.
+
+ This method contrasts with the default behaviour of the L{AuiToolBar} that
+ draws a background gradient and this break the window design when putting
+ it within a control that has margin between the borders and the toolbar
+ (example: put L{AuiToolBar} within a `wx.StaticBoxSizer` that has a plain background).
+
+ :param `dc`: a `wx.DC` device context;
+ :param `wnd`: a `wx.Window` derived window;
+ :param `_rect`: the L{AuiToolBar} rectangle.
+ """
+
+ rect = wx.Rect(*_rect)
+ rect.height += 1
+
+ dc.SetBrush(wx.Brush(wx.SystemSettings.GetColour(wx.SYS_COLOUR_3DFACE)))
+ dc.DrawRectangle(rect.x - 1, rect.y - 1, rect.width + 2, rect.height + 1)
+
+
+ def DrawLabel(self, dc, wnd, item, rect):
+ """
+ Draws a toolbar item label.
+
+ :param `dc`: a `wx.DC` device context;
+ :param `wnd`: a `wx.Window` derived window;
+ :param `item`: an instance of L{AuiToolBarItem};
+ :param `rect`: the L{AuiToolBarItem} rectangle.
+ """
+
+ dc.SetFont(self._font)
+ dc.SetTextForeground(wx.BLACK)
+ orient = item.GetOrientation()
+
+ horizontal = orient == AUI_TBTOOL_HORIZONTAL
+ # we only care about the text height here since the text
+ # will get cropped based on the width of the item
+ label_size = GetLabelSize(dc, item.GetLabel(), not horizontal)
+ text_width = label_size.GetWidth()
+ text_height = label_size.GetHeight()
+
+ if orient == AUI_TBTOOL_HORIZONTAL:
+ text_x = rect.x
+ text_y = rect.y + (rect.height-text_height)/2
+ dc.DrawText(item.GetLabel(), text_x, text_y)
+
+ elif orient == AUI_TBTOOL_VERT_CLOCKWISE:
+ text_x = rect.x + (rect.width+text_width)/2
+ text_y = rect.y
+ dc.DrawRotatedText(item.GetLabel(), text_x, text_y, 270)
+
+ elif AUI_TBTOOL_VERT_COUNTERCLOCKWISE:
+ text_x = rect.x + (rect.width-text_width)/2
+ text_y = rect.y + text_height
+ dc.DrawRotatedText(item.GetLabel(), text_x, text_y, 90)
+
+
+ def DrawButton(self, dc, wnd, item, rect):
+ """
+ Draws a toolbar item button.
+
+ :param `dc`: a `wx.DC` device context;
+ :param `wnd`: a `wx.Window` derived window;
+ :param `item`: an instance of L{AuiToolBarItem};
+ :param `rect`: the L{AuiToolBarItem} rectangle.
+ """
+
+ bmp_rect, text_rect = self.GetToolsPosition(dc, item, rect)
+
+ if not item.GetState() & AUI_BUTTON_STATE_DISABLED:
+
+ if item.GetState() & AUI_BUTTON_STATE_PRESSED:
+
+ dc.SetPen(wx.Pen(self._highlight_colour))
+ dc.SetBrush(wx.Brush(StepColour(self._highlight_colour, 150)))
+ dc.DrawRectangleRect(rect)
+
+ elif item.GetState() & AUI_BUTTON_STATE_HOVER or item.IsSticky():
+
+ dc.SetPen(wx.Pen(self._highlight_colour))
+ dc.SetBrush(wx.Brush(StepColour(self._highlight_colour, 170)))
+
+ # draw an even lighter background for checked item hovers (since
+ # the hover background is the same colour as the check background)
+ if item.GetState() & AUI_BUTTON_STATE_CHECKED:
+ dc.SetBrush(wx.Brush(StepColour(self._highlight_colour, 180)))
+
+ dc.DrawRectangleRect(rect)
+
+ elif item.GetState() & AUI_BUTTON_STATE_CHECKED:
+
+ # it's important to put this code in an else statment after the
+ # hover, otherwise hovers won't draw properly for checked items
+ dc.SetPen(wx.Pen(self._highlight_colour))
+ dc.SetBrush(wx.Brush(StepColour(self._highlight_colour, 170)))
+ dc.DrawRectangleRect(rect)
+
+ if item.GetState() & AUI_BUTTON_STATE_DISABLED:
+ bmp = item.GetDisabledBitmap()
+ else:
+ bmp = item.GetBitmap()
+
+ if bmp.IsOk():
+ dc.DrawBitmap(bmp, bmp_rect.x, bmp_rect.y, True)
+
+ # set the item's text colour based on if it is disabled
+ dc.SetTextForeground(wx.BLACK)
+ if item.GetState() & AUI_BUTTON_STATE_DISABLED:
+ dc.SetTextForeground(DISABLED_TEXT_COLOUR)
+
+ if self._agwFlags & AUI_TB_TEXT and item.GetLabel() != "":
+ self.DrawLabel(dc, wnd, item, text_rect)
+
+
+ def DrawDropDownButton(self, dc, wnd, item, rect):
+ """
+ Draws a toolbar dropdown button.
+
+ :param `dc`: a `wx.DC` device context;
+ :param `wnd`: a `wx.Window` derived window;
+ :param `item`: an instance of L{AuiToolBarItem};
+ :param `rect`: the L{AuiToolBarItem} rectangle.
+ """
+
+ dropbmp_x = dropbmp_y = 0
+
+ button_rect = wx.Rect(rect.x, rect.y, rect.width-BUTTON_DROPDOWN_WIDTH, rect.height)
+ dropdown_rect = wx.Rect(rect.x+rect.width-BUTTON_DROPDOWN_WIDTH-1, rect.y, BUTTON_DROPDOWN_WIDTH+1, rect.height)
+
+ horizontal = item.GetOrientation() == AUI_TBTOOL_HORIZONTAL
+
+ if horizontal:
+ button_rect = wx.Rect(rect.x, rect.y, rect.width-BUTTON_DROPDOWN_WIDTH, rect.height)
+ dropdown_rect = wx.Rect(rect.x+rect.width-BUTTON_DROPDOWN_WIDTH-1, rect.y, BUTTON_DROPDOWN_WIDTH+1, rect.height)
+ else:
+ button_rect = wx.Rect(rect.x, rect.y, rect.width, rect.height-BUTTON_DROPDOWN_WIDTH)
+ dropdown_rect = wx.Rect(rect.x, rect.y+rect.height-BUTTON_DROPDOWN_WIDTH-1, rect.width, BUTTON_DROPDOWN_WIDTH+1)
+
+ dropbmp_width = self._button_dropdown_bmp.GetWidth()
+ dropbmp_height = self._button_dropdown_bmp.GetHeight()
+ if not horizontal:
+ tmp = dropbmp_width
+ dropbmp_width = dropbmp_height
+ dropbmp_height = tmp
+
+ dropbmp_x = dropdown_rect.x + (dropdown_rect.width/2) - dropbmp_width/2
+ dropbmp_y = dropdown_rect.y + (dropdown_rect.height/2) - dropbmp_height/2
+
+ bmp_rect, text_rect = self.GetToolsPosition(dc, item, button_rect)
+
+ if item.GetState() & AUI_BUTTON_STATE_PRESSED:
+
+ dc.SetPen(wx.Pen(self._highlight_colour))
+ dc.SetBrush(wx.Brush(StepColour(self._highlight_colour, 140)))
+ dc.DrawRectangleRect(button_rect)
+ dc.DrawRectangleRect(dropdown_rect)
+
+ elif item.GetState() & AUI_BUTTON_STATE_HOVER or item.IsSticky():
+
+ dc.SetPen(wx.Pen(self._highlight_colour))
+ dc.SetBrush(wx.Brush(StepColour(self._highlight_colour, 170)))
+ dc.DrawRectangleRect(button_rect)
+ dc.DrawRectangleRect(dropdown_rect)
+
+ elif item.GetState() & AUI_BUTTON_STATE_CHECKED:
+ # it's important to put this code in an else statment after the
+ # hover, otherwise hovers won't draw properly for checked items
+ dc.SetPen(wx.Pen(self._highlight_colour))
+ dc.SetBrush(wx.Brush(StepColour(self._highlight_colour, 170)))
+ dc.DrawRectangle(button_rect)
+ dc.DrawRectangle(dropdown_rect)
+
+ if item.GetState() & AUI_BUTTON_STATE_DISABLED:
+
+ bmp = item.GetDisabledBitmap()
+ dropbmp = self._disabled_button_dropdown_bmp
+
+ else:
+
+ bmp = item.GetBitmap()
+ dropbmp = self._button_dropdown_bmp
+
+ if not bmp.IsOk():
+ return
+
+ dc.DrawBitmap(bmp, bmp_rect.x, bmp_rect.y, True)
+ if horizontal:
+ dc.DrawBitmap(dropbmp, dropbmp_x, dropbmp_y, True)
+ else:
+ dc.DrawBitmap(wx.BitmapFromImage(dropbmp.ConvertToImage().Rotate90(item.GetOrientation() == AUI_TBTOOL_VERT_CLOCKWISE)),
+ dropbmp_x, dropbmp_y, True)
+
+ # set the item's text colour based on if it is disabled
+ dc.SetTextForeground(wx.BLACK)
+ if item.GetState() & AUI_BUTTON_STATE_DISABLED:
+ dc.SetTextForeground(DISABLED_TEXT_COLOUR)
+
+ if self._agwFlags & AUI_TB_TEXT and item.GetLabel() != "":
+ self.DrawLabel(dc, wnd, item, text_rect)
+
+
+ def DrawControlLabel(self, dc, wnd, item, rect):
+ """
+ Draws a label for a toolbar control.
+
+ :param `dc`: a `wx.DC` device context;
+ :param `wnd`: a `wx.Window` derived window;
+ :param `item`: an instance of L{AuiToolBarItem};
+ :param `rect`: the L{AuiToolBarItem} rectangle.
+ """
+
+ label_size = GetLabelSize(dc, item.GetLabel(), item.GetOrientation() != AUI_TBTOOL_HORIZONTAL)
+ text_height = label_size.GetHeight()
+ text_width = label_size.GetWidth()
+
+ dc.SetFont(self._font)
+
+ if self._agwFlags & AUI_TB_TEXT:
+
+ tx, text_height = dc.GetTextExtent("ABCDHgj")
+
+ text_width, ty = dc.GetTextExtent(item.GetLabel())
+
+ # don't draw the label if it is wider than the item width
+ if text_width > rect.width:
+ return
+
+ # set the label's text colour
+ dc.SetTextForeground(wx.BLACK)
+
+ text_x = rect.x + (rect.width/2) - (text_width/2) + 1
+ text_y = rect.y + rect.height - text_height - 1
+
+ if self._agwFlags & AUI_TB_TEXT and item.GetLabel() != "":
+ dc.DrawText(item.GetLabel(), text_x, text_y)
+
+
+ def GetLabelSize(self, dc, wnd, item):
+ """
+ Returns the label size for a toolbar item.
+
+ :param `dc`: a `wx.DC` device context;
+ :param `wnd`: a `wx.Window` derived window;
+ :param `item`: an instance of L{AuiToolBarItem}.
+ """
+
+ dc.SetFont(self._font)
+ label_size = GetLabelSize(dc, item.GetLabel(), self._orientation != AUI_TBTOOL_HORIZONTAL)
+
+ return wx.Size(item.GetMinSize().GetWidth(), label_size.GetHeight())
+
+
+ def GetToolSize(self, dc, wnd, item):
+ """
+ Returns the toolbar item size.
+
+ :param `dc`: a `wx.DC` device context;
+ :param `wnd`: a `wx.Window` derived window;
+ :param `item`: an instance of L{AuiToolBarItem}.
+ """
+
+ if not item.GetBitmap().IsOk() and not self._agwFlags & AUI_TB_TEXT:
+ return wx.Size(16, 16)
+
+ width = item.GetBitmap().GetWidth()
+ height = item.GetBitmap().GetHeight()
+
+ if self._agwFlags & AUI_TB_TEXT:
+
+ dc.SetFont(self._font)
+ label_size = GetLabelSize(dc, item.GetLabel(), self.GetOrientation() != AUI_TBTOOL_HORIZONTAL)
+ padding = 6
+
+ if self._text_orientation == AUI_TBTOOL_TEXT_BOTTOM:
+
+ if self.GetOrientation() != AUI_TBTOOL_HORIZONTAL:
+ height += 3 # space between top border and bitmap
+ height += 3 # space between bitmap and text
+ padding = 0
+
+ height += label_size.GetHeight()
+
+ if item.GetLabel() != "":
+ width = max(width, label_size.GetWidth()+padding)
+
+ elif self._text_orientation == AUI_TBTOOL_TEXT_RIGHT and item.GetLabel() != "":
+
+ if self.GetOrientation() == AUI_TBTOOL_HORIZONTAL:
+
+ width += 3 # space between left border and bitmap
+ width += 3 # space between bitmap and text
+ padding = 0
+
+ width += label_size.GetWidth()
+ height = max(height, label_size.GetHeight()+padding)
+
+ # if the tool has a dropdown button, add it to the width
+ if item.HasDropDown():
+ if item.GetOrientation() == AUI_TBTOOL_HORIZONTAL:
+ width += BUTTON_DROPDOWN_WIDTH+4
+ else:
+ height += BUTTON_DROPDOWN_WIDTH+4
+
+ return wx.Size(width, height)
+
+
+ def DrawSeparator(self, dc, wnd, _rect):
+ """
+ Draws a toolbar separator.
+
+ :param `dc`: a `wx.DC` device context;
+ :param `wnd`: a `wx.Window` derived window;
+ :param `_rect`: the L{AuiToolBarItem} rectangle.
+ """
+
+ horizontal = True
+ if self._agwFlags & AUI_TB_VERTICAL:
+ horizontal = False
+
+ rect = wx.Rect(*_rect)
+
+ if horizontal:
+
+ rect.x += (rect.width/2)
+ rect.width = 1
+ new_height = (rect.height*3)/4
+ rect.y += (rect.height/2) - (new_height/2)
+ rect.height = new_height
+
+ else:
+
+ rect.y += (rect.height/2)
+ rect.height = 1
+ new_width = (rect.width*3)/4
+ rect.x += (rect.width/2) - (new_width/2)
+ rect.width = new_width
+
+ start_colour = StepColour(self._base_colour, 80)
+ end_colour = StepColour(self._base_colour, 80)
+ dc.GradientFillLinear(rect, start_colour, end_colour, (horizontal and [wx.SOUTH] or [wx.EAST])[0])
+
+
+ def DrawGripper(self, dc, wnd, rect):
+ """
+ Draws the toolbar gripper.
+
+ :param `dc`: a `wx.DC` device context;
+ :param `wnd`: a `wx.Window` derived window;
+ :param `rect`: the L{AuiToolBar} rectangle.
+ """
+
+ i = 0
+ while 1:
+
+ if self._agwFlags & AUI_TB_VERTICAL:
+
+ x = rect.x + (i*4) + 4
+ y = rect.y + 3
+ if x > rect.GetWidth() - 4:
+ break
+
+ else:
+
+ x = rect.x + 3
+ y = rect.y + (i*4) + 4
+ if y > rect.GetHeight() - 4:
+ break
+
+ dc.SetPen(self._gripper_pen1)
+ dc.DrawPoint(x, y)
+ dc.SetPen(self._gripper_pen2)
+ dc.DrawPoint(x, y+1)
+ dc.DrawPoint(x+1, y)
+ dc.SetPen(self._gripper_pen3)
+ dc.DrawPoint(x+2, y+1)
+ dc.DrawPoint(x+2, y+2)
+ dc.DrawPoint(x+1, y+2)
+
+ i += 1
+
+
+ def DrawOverflowButton(self, dc, wnd, rect, state):
+ """
+ Draws the overflow button for the L{AuiToolBar}.
+
+ :param `dc`: a `wx.DC` device context;
+ :param `wnd`: a `wx.Window` derived window;
+ :param `rect`: the L{AuiToolBar} rectangle;
+ :param `state`: the overflow button state.
+ """
+
+ if state & AUI_BUTTON_STATE_HOVER or state & AUI_BUTTON_STATE_PRESSED:
+
+ cli_rect = wnd.GetClientRect()
+ light_gray_bg = StepColour(self._highlight_colour, 170)
+
+ if self._agwFlags & AUI_TB_VERTICAL:
+
+ dc.SetPen(wx.Pen(self._highlight_colour))
+ dc.DrawLine(rect.x, rect.y, rect.x+rect.width, rect.y)
+ dc.SetPen(wx.Pen(light_gray_bg))
+ dc.SetBrush(wx.Brush(light_gray_bg))
+ dc.DrawRectangle(rect.x, rect.y+1, rect.width, rect.height)
+
+ else:
+
+ dc.SetPen(wx.Pen(self._highlight_colour))
+ dc.DrawLine(rect.x, rect.y, rect.x, rect.y+rect.height)
+ dc.SetPen(wx.Pen(light_gray_bg))
+ dc.SetBrush(wx.Brush(light_gray_bg))
+ dc.DrawRectangle(rect.x+1, rect.y, rect.width, rect.height)
+
+ x = rect.x + 1 + (rect.width-self._overflow_bmp.GetWidth())/2
+ y = rect.y + 1 + (rect.height-self._overflow_bmp.GetHeight())/2
+ dc.DrawBitmap(self._overflow_bmp, x, y, True)
+
+
+ def GetElementSize(self, element_id):
+ """
+ Returns the size of a UI element in the L{AuiToolBar}.
+
+ :param `element_id`: can be one of the following:
+
+ ==================================== ==================================
+ Element Identifier Description
+ ==================================== ==================================
+ ``AUI_TBART_SEPARATOR_SIZE`` Separator size in `AuiToolBar`
+ ``AUI_TBART_GRIPPER_SIZE`` Gripper size in `AuiToolBar`
+ ``AUI_TBART_OVERFLOW_SIZE`` Overflow button size in `AuiToolBar`
+ ==================================== ==================================
+ """
+
+ if element_id == AUI_TBART_SEPARATOR_SIZE:
+ return self._separator_size
+ elif element_id == AUI_TBART_GRIPPER_SIZE:
+ return self._gripper_size
+ elif element_id == AUI_TBART_OVERFLOW_SIZE:
+ return self._overflow_size
+
+ return 0
+
+
+ def SetElementSize(self, element_id, size):
+ """
+ Sets the size of a UI element in the L{AuiToolBar}.
+
+ :param `element_id`: can be one of the following:
+
+ ==================================== ==================================
+ Element Identifier Description
+ ==================================== ==================================
+ ``AUI_TBART_SEPARATOR_SIZE`` Separator size in `AuiToolBar`
+ ``AUI_TBART_GRIPPER_SIZE`` Gripper size in `AuiToolBar`
+ ``AUI_TBART_OVERFLOW_SIZE`` Overflow button size in `AuiToolBar`
+ ==================================== ==================================
+
+ :param `size`: the new size of the UI element.
+ """
+
+ if element_id == AUI_TBART_SEPARATOR_SIZE:
+ self._separator_size = size
+ elif element_id == AUI_TBART_GRIPPER_SIZE:
+ self._gripper_size = size
+ elif element_id == AUI_TBART_OVERFLOW_SIZE:
+ self._overflow_size = size
+
+
+ def ShowDropDown(self, wnd, items):
+ """
+ Shows the drop down window menu for overflow items.
+
+ :param `wnd`: an instance of `wx.Window`;
+ :param `items`: the overflow toolbar items (a Python list).
+ """
+
+ menuPopup = wx.Menu()
+ items_added = 0
+
+ for item in items:
+
+ if item.GetKind() not in [ITEM_SEPARATOR, ITEM_SPACER, ITEM_CONTROL]:
+
+ text = item.GetShortHelp()
+ if text == "":
+ text = item.GetLabel()
+ if text == "":
+ text = " "
+
+ kind = item.GetKind()
+ m = wx.MenuItem(menuPopup, item.GetId(), text, item.GetShortHelp(), kind)
+ orientation = item.GetOrientation()
+ item.SetOrientation(AUI_TBTOOL_HORIZONTAL)
+
+ if kind not in [ITEM_CHECK, ITEM_RADIO]:
+ m.SetBitmap(item.GetBitmap())
+
+ item.SetOrientation(orientation)
+
+ menuPopup.AppendItem(m)
+ if kind in [ITEM_CHECK, ITEM_RADIO]:
+ state = (item.state & AUI_BUTTON_STATE_CHECKED and [True] or [False])[0]
+ m.Check(state)
+
+ items_added += 1
+
+ else:
+
+ if items_added > 0 and item.GetKind() == ITEM_SEPARATOR:
+ menuPopup.AppendSeparator()
+
+ # find out where to put the popup menu of window items
+ pt = wx.GetMousePosition()
+ pt = wnd.ScreenToClient(pt)
+
+ # find out the screen coordinate at the bottom of the tab ctrl
+ cli_rect = wnd.GetClientRect()
+ pt.y = cli_rect.y + cli_rect.height
+
+ cc = ToolbarCommandCapture()
+ wnd.PushEventHandler(cc)
+
+ # Adjustments to get slightly better menu placement
+ if wx.Platform == "__WXMAC__":
+ pt.y += 5
+ pt.x -= 5
+
+ wnd.PopupMenu(menuPopup, pt)
+ command = cc.GetCommandId()
+ wnd.PopEventHandler(True)
+
+ return command
+
+
+ def GetToolsPosition(self, dc, item, rect):
+ """
+ Returns the bitmap and text rectangles for a toolbar item.
+
+ :param `dc`: a `wx.DC` device context;
+ :param `item`: an instance of L{AuiToolBarItem};
+ :param `rect`: the tool rect.
+ """
+
+ text_width = text_height = 0
+ horizontal = self._orientation == AUI_TBTOOL_HORIZONTAL
+ text_bottom = self._text_orientation == AUI_TBTOOL_TEXT_BOTTOM
+ text_right = self._text_orientation == AUI_TBTOOL_TEXT_RIGHT
+ bmp_width = item.GetBitmap().GetWidth()
+ bmp_height = item.GetBitmap().GetHeight()
+
+ if self._agwFlags & AUI_TB_TEXT:
+ dc.SetFont(self._font)
+ label_size = GetLabelSize(dc, item.GetLabel(), not horizontal)
+ text_height = label_size.GetHeight()
+ text_width = label_size.GetWidth()
+
+ bmp_x = bmp_y = text_x = text_y = 0
+
+ if horizontal and text_bottom:
+ bmp_x = rect.x + (rect.width/2) - (bmp_width/2)
+ bmp_y = rect.y + 3
+ text_x = rect.x + (rect.width/2) - (text_width/2)
+ text_y = rect.y + ((bmp_y - rect.y) * 2) + bmp_height
+
+ elif horizontal and text_right:
+ bmp_x = rect.x + 3
+ bmp_y = rect.y + (rect.height/2) - (bmp_height / 2)
+ text_x = rect.x + ((bmp_x - rect.x) * 2) + bmp_width
+ text_y = rect.y + (rect.height/2) - (text_height/2)
+
+ elif not horizontal and text_bottom:
+ bmp_x = rect.x + (rect.width / 2) - (bmp_width / 2)
+ bmp_y = rect.y + 3
+ text_x = rect.x + (rect.width / 2) - (text_width / 2)
+ text_y = rect.y + ((bmp_y - rect.y) * 2) + bmp_height
+
+ bmp_rect = wx.Rect(bmp_x, bmp_y, bmp_width, bmp_height)
+ text_rect = wx.Rect(text_x, text_y, text_width, text_height)
+
+ return bmp_rect, text_rect
+
+
+class AuiToolBar(wx.PyControl):
+ """
+ AuiToolBar is a completely owner-drawn toolbar perfectly integrated with the
+ AUI layout system. This allows drag and drop of toolbars, docking/floating
+ behaviour and the possibility to define "overflow" items in the toolbar itself.
+
+ The default theme that is used is L{AuiDefaultToolBarArt}, which provides a modern,
+ glossy look and feel. The theme can be changed by calling L{AuiToolBar.SetArtProvider}.
+ """
+
+ def __init__(self, parent, id=wx.ID_ANY, pos=wx.DefaultPosition,
+ size=wx.DefaultSize, style=0, agwStyle=AUI_TB_DEFAULT_STYLE):
+ """
+ Default class constructor.
+
+ :param `parent`: the L{AuiToolBar} parent;
+ :param `id`: an identifier for the control: a value of -1 is taken to mean a default;
+ :param `pos`: the control position. A value of (-1, -1) indicates a default position,
+ chosen by either the windowing system or wxPython, depending on platform;
+ :param `size`: the control size. A value of (-1, -1) indicates a default size,
+ chosen by either the windowing system or wxPython, depending on platform;
+ :param `style`: the control window style;
+ :param `agwStyle`: the AGW-specific window style. This can be a combination of the
+ following bits:
+
+ ==================================== ==================================
+ Flag name Description
+ ==================================== ==================================
+ ``AUI_TB_TEXT`` Shows the text in the toolbar buttons; by default only icons are shown
+ ``AUI_TB_NO_TOOLTIPS`` Don't show tooltips on `AuiToolBar` items
+ ``AUI_TB_NO_AUTORESIZE`` Do not auto-resize the `AuiToolBar`
+ ``AUI_TB_GRIPPER`` Shows a gripper on the `AuiToolBar`
+ ``AUI_TB_OVERFLOW`` The `AuiToolBar` can contain overflow items
+ ``AUI_TB_VERTICAL`` The `AuiToolBar` is vertical
+ ``AUI_TB_HORZ_LAYOUT`` Shows the text and the icons alongside, not vertically stacked. This style must be used with ``AUI_TB_TEXT``
+ ``AUI_TB_PLAIN_BACKGROUND`` Don't draw a gradient background on the toolbar
+ ``AUI_TB_HORZ_TEXT`` Combination of ``AUI_TB_HORZ_LAYOUT`` and ``AUI_TB_TEXT``
+ ==================================== ==================================
+
+ The default value for `agwStyle` is: ``AUI_TB_DEFAULT_STYLE`` = 0
+
+ """
+
+ wx.PyControl.__init__(self, parent, id, pos, size, style|wx.BORDER_NONE)
+
+ self._sizer = wx.BoxSizer(wx.HORIZONTAL)
+ self.SetSizer(self._sizer)
+ self._button_width = -1
+ self._button_height = -1
+ self._sizer_element_count = 0
+ self._action_pos = wx.Point(-1, -1)
+ self._action_item = None
+ self._tip_item = None
+ self._art = AuiDefaultToolBarArt()
+ self._tool_packing = 2
+ self._tool_border_padding = 3
+ self._tool_text_orientation = AUI_TBTOOL_TEXT_BOTTOM
+ self._tool_orientation = AUI_TBTOOL_HORIZONTAL
+ self._tool_alignment = wx.EXPAND
+ self._gripper_sizer_item = None
+ self._overflow_sizer_item = None
+ self._dragging = False
+
+ self._agwStyle = self._originalStyle = agwStyle
+
+ self._gripper_visible = (self._agwStyle & AUI_TB_GRIPPER and [True] or [False])[0]
+ self._overflow_visible = (self._agwStyle & AUI_TB_OVERFLOW and [True] or [False])[0]
+ self._overflow_state = 0
+ self._custom_overflow_prepend = []
+ self._custom_overflow_append = []
+
+ self._items = []
+
+ self.SetMargins(5, 5, 2, 2)
+ self.SetFont(wx.NORMAL_FONT)
+ self._art.SetAGWFlags(self._agwStyle)
+ self.SetExtraStyle(wx.WS_EX_PROCESS_IDLE)
+
+ if agwStyle & AUI_TB_HORZ_LAYOUT:
+ self.SetToolTextOrientation(AUI_TBTOOL_TEXT_RIGHT)
+ elif agwStyle & AUI_TB_VERTICAL:
+ if agwStyle & AUI_TB_CLOCKWISE:
+ self.SetToolOrientation(AUI_TBTOOL_VERT_CLOCKWISE)
+ elif agwStyle & AUI_TB_COUNTERCLOCKWISE:
+ self.SetToolOrientation(AUI_TBTOOL_VERT_COUNTERCLOCKWISE)
+
+ self.SetBackgroundStyle(wx.BG_STYLE_CUSTOM)
+
+ self.Bind(wx.EVT_SIZE, self.OnSize)
+ self.Bind(wx.EVT_IDLE, self.OnIdle)
+ self.Bind(wx.EVT_ERASE_BACKGROUND, self.OnEraseBackground)
+ self.Bind(wx.EVT_PAINT, self.OnPaint)
+ self.Bind(wx.EVT_LEFT_DOWN, self.OnLeftDown)
+ self.Bind(wx.EVT_LEFT_DCLICK, self.OnLeftDown)
+ self.Bind(wx.EVT_LEFT_UP, self.OnLeftUp)
+ self.Bind(wx.EVT_RIGHT_DOWN, self.OnRightDown)
+ self.Bind(wx.EVT_RIGHT_DCLICK, self.OnRightDown)
+ self.Bind(wx.EVT_RIGHT_UP, self.OnRightUp)
+ self.Bind(wx.EVT_MIDDLE_DOWN, self.OnMiddleDown)
+ self.Bind(wx.EVT_MIDDLE_DCLICK, self.OnMiddleDown)
+ self.Bind(wx.EVT_MIDDLE_UP, self.OnMiddleUp)
+ self.Bind(wx.EVT_MOTION, self.OnMotion)
+ self.Bind(wx.EVT_LEAVE_WINDOW, self.OnLeaveWindow)
+ self.Bind(wx.EVT_SET_CURSOR, self.OnSetCursor)
+
+
+ def SetWindowStyleFlag(self, style):
+ """
+ Sets the style of the window.
+
+ :param `style`: the new window style.
+
+ :note: Please note that some styles cannot be changed after the window
+ creation and that `Refresh` might need to be be called after changing the
+ others for the change to take place immediately.
+
+ :note: Overridden from `wx.PyControl`.
+ """
+
+ wx.PyControl.SetWindowStyleFlag(self, style|wx.BORDER_NONE)
+
+
+ def SetAGWWindowStyleFlag(self, agwStyle):
+ """
+ Sets the AGW-specific style of the window.
+
+ :param `agwStyle`: the new window style. This can be a combination of the
+ following bits:
+
+ ==================================== ==================================
+ Flag name Description
+ ==================================== ==================================
+ ``AUI_TB_TEXT`` Shows the text in the toolbar buttons; by default only icons are shown
+ ``AUI_TB_NO_TOOLTIPS`` Don't show tooltips on `AuiToolBar` items
+ ``AUI_TB_NO_AUTORESIZE`` Do not auto-resize the `AuiToolBar`
+ ``AUI_TB_GRIPPER`` Shows a gripper on the `AuiToolBar`
+ ``AUI_TB_OVERFLOW`` The `AuiToolBar` can contain overflow items
+ ``AUI_TB_VERTICAL`` The `AuiToolBar` is vertical
+ ``AUI_TB_HORZ_LAYOUT`` Shows the text and the icons alongside, not vertically stacked. This style must be used with ``AUI_TB_TEXT``
+ ``AUI_TB_PLAIN_BACKGROUND`` Don't draw a gradient background on the toolbar
+ ``AUI_TB_HORZ_TEXT`` Combination of ``AUI_TB_HORZ_LAYOUT`` and ``AUI_TB_TEXT``
+ ==================================== ==================================
+
+ :note: Please note that some styles cannot be changed after the window
+ creation and that `Refresh` might need to be be called after changing the
+ others for the change to take place immediately.
+ """
+
+ self._agwStyle = self._originalStyle = agwStyle
+
+ if self._art:
+ self._art.SetAGWFlags(self._agwStyle)
+
+ if agwStyle & AUI_TB_GRIPPER:
+ self._gripper_visible = True
+ else:
+ self._gripper_visible = False
+
+ if agwStyle & AUI_TB_OVERFLOW:
+ self._overflow_visible = True
+ else:
+ self._overflow_visible = False
+
+ if agwStyle & AUI_TB_HORZ_LAYOUT:
+ self.SetToolTextOrientation(AUI_TBTOOL_TEXT_RIGHT)
+ else:
+ self.SetToolTextOrientation(AUI_TBTOOL_TEXT_BOTTOM)
+
+ if agwStyle & AUI_TB_VERTICAL:
+ if agwStyle & AUI_TB_CLOCKWISE:
+ self.SetToolOrientation(AUI_TBTOOL_VERT_CLOCKWISE)
+ elif agwStyle & AUI_TB_COUNTERCLOCKWISE:
+ self.SetToolOrientation(AUI_TBTOOL_VERT_COUNTERCLOCKWISE)
+
+
+ def GetAGWWindowStyleFlag(self):
+ """
+ Returns the AGW-specific window style flag.
+
+ :see: L{SetAGWWindowStyleFlag} for an explanation of various AGW-specific style.
+ """
+
+ return self._agwStyle
+
+
+ def SetArtProvider(self, art):
+ """
+ Instructs L{AuiToolBar} to use art provider specified by parameter `art`
+ for all drawing calls. This allows plugable look-and-feel features.
+
+ :param `art`: an art provider.
+
+ :note: The previous art provider object, if any, will be deleted by L{AuiToolBar}.
+ """
+
+ del self._art
+ self._art = art
+
+ if self._art:
+ self._art.SetAGWFlags(self._agwStyle)
+ self._art.SetTextOrientation(self._tool_text_orientation)
+ self._art.SetOrientation(self._tool_orientation)
+
+
+ def GetArtProvider(self):
+ """ Returns the current art provider being used. """
+
+ return self._art
+
+
+ def AddSimpleTool(self, tool_id, label, bitmap, short_help_string="", kind=ITEM_NORMAL):
+ """
+ Adds a tool to the toolbar. This is the simplest method you can use to
+ ass an item to the L{AuiToolBar}.
+
+ :param `tool_id`: an integer by which the tool may be identified in subsequent operations;
+ :param `label`: the toolbar tool label;
+ :param `bitmap`: the primary tool bitmap;
+ :param `short_help_string`: this string is used for the tools tooltip;
+ :param `kind`: the item kind. Can be one of the following:
+
+ ======================== =============================
+ Item Kind Description
+ ======================== =============================
+ ``ITEM_CONTROL`` The item in the `AuiToolBar` is a control
+ ``ITEM_LABEL`` The item in the `AuiToolBar` is a text label
+ ``ITEM_SPACER`` The item in the `AuiToolBar` is a spacer
+ ``ITEM_SEPARATOR`` The item in the `AuiToolBar` is a separator
+ ``ITEM_CHECK`` The item in the `AuiToolBar` is a toolbar check item
+ ``ITEM_NORMAL`` The item in the `AuiToolBar` is a standard toolbar item
+ ``ITEM_RADIO`` The item in the `AuiToolBar` is a toolbar radio item
+ ======================== =============================
+ """
+
+ return self.AddTool(tool_id, label, bitmap, wx.NullBitmap, kind, short_help_string, "", None)
+
+
+ def AddToggleTool(self, tool_id, bitmap, disabled_bitmap, toggle=False, client_data=None, short_help_string="", long_help_string=""):
+ """
+ Adds a toggle tool to the toolbar.
+
+ :param `tool_id`: an integer by which the tool may be identified in subsequent operations;
+ :param `bitmap`: the primary tool bitmap;
+ :param `disabled_bitmap`: the bitmap to use when the tool is disabled. If it is equal to
+ `wx.NullBitmap`, the disabled bitmap is automatically generated by greing the normal one;
+ :param `client_data`: whatever Python object to associate with the toolbar item;
+ :param `short_help_string`: this string is used for the tools tooltip;
+ :param `long_help_string`: this string is shown in the statusbar (if any) of the parent
+ frame when the mouse pointer is inside the tool.
+ """
+
+ kind = (toggle and [ITEM_CHECK] or [ITEM_NORMAL])[0]
+ return self.AddTool(tool_id, "", bitmap, disabled_bitmap, kind, short_help_string, long_help_string, client_data)
+
+
+ def AddTool(self, tool_id, label, bitmap, disabled_bitmap, kind, short_help_string, long_help_string, client_data):
+ """
+ Adds a tool to the toolbar. This is the full feature version of L{AddTool}.
+
+ :param `tool_id`: an integer by which the tool may be identified in subsequent operations;
+ :param `label`: the toolbar tool label;
+ :param `bitmap`: the primary tool bitmap;
+ :param `disabled_bitmap`: the bitmap to use when the tool is disabled. If it is equal to
+ `wx.NullBitmap`, the disabled bitmap is automatically generated by greing the normal one;
+ :param `kind`: the item kind. Can be one of the following:
+
+ ======================== =============================
+ Item Kind Description
+ ======================== =============================
+ ``ITEM_CONTROL`` The item in the `AuiToolBar` is a control
+ ``ITEM_LABEL`` The item in the `AuiToolBar` is a text label
+ ``ITEM_SPACER`` The item in the `AuiToolBar` is a spacer
+ ``ITEM_SEPARATOR`` The item in the `AuiToolBar` is a separator
+ ``ITEM_CHECK`` The item in the `AuiToolBar` is a toolbar check item
+ ``ITEM_NORMAL`` The item in the `AuiToolBar` is a standard toolbar item
+ ``ITEM_RADIO`` The item in the `AuiToolBar` is a toolbar radio item
+ ======================== =============================
+
+ :param `short_help_string`: this string is used for the tools tooltip;
+ :param `long_help_string`: this string is shown in the statusbar (if any) of the parent
+ frame when the mouse pointer is inside the tool.
+ :param `client_data`: whatever Python object to associate with the toolbar item.
+ """
+
+ item = AuiToolBarItem()
+ item.window = None
+ item.label = label
+ item.bitmap = bitmap
+ item.disabled_bitmap = disabled_bitmap
+ item.short_help = short_help_string
+ item.long_help = long_help_string
+ item.active = True
+ item.dropdown = False
+ item.spacer_pixels = 0
+
+ if tool_id == wx.ID_ANY:
+ tool_id = wx.NewId()
+
+ item.id = tool_id
+ item.state = 0
+ item.proportion = 0
+ item.kind = kind
+ item.sizer_item = None
+ item.min_size = wx.Size(-1, -1)
+ item.user_data = 0
+ item.sticky = False
+ item.orientation = self._tool_orientation
+
+ if not item.disabled_bitmap.IsOk():
+ # no disabled bitmap specified, we need to make one
+ if item.bitmap.IsOk():
+ item.disabled_bitmap = MakeDisabledBitmap(item.bitmap)
+
+ self._items.append(item)
+ return self._items[-1]
+
+
+ def AddCheckTool(self, tool_id, label, bitmap, disabled_bitmap, short_help_string="", long_help_string="", client_data=None):
+ """
+ Adds a new check (or toggle) tool to the L{AuiToolBar}.
+
+ :see: L{AddTool}.
+ """
+
+ return self.AddTool(tool_id, label, bitmap, disabled_bitmap, ITEM_CHECK, short_help_string, long_help_string, client_data)
+
+
+ def AddRadioTool(self, tool_id, label, bitmap, disabled_bitmap, short_help_string="", long_help_string="", client_data=None):
+ """
+ Adds a new radio tool to the toolbar.
+
+ Consecutive radio tools form a radio group such that exactly one button
+ in the group is pressed at any moment, in other words whenever a button
+ in the group is pressed the previously pressed button is automatically
+ released. You should avoid having the radio groups of only one element
+ as it would be impossible for the user to use such button.
+
+ :note: By default, the first button in the radio group is initially pressed,
+ the others are not.
+
+ :see: L{AddTool}.
+ """
+
+ return self.AddTool(tool_id, label, bitmap, disabled_bitmap, ITEM_RADIO, short_help_string, long_help_string, client_data)
+
+
+ def AddControl(self, control, label=""):
+ """
+ Adds any control to the toolbar, typically e.g. a combobox.
+
+ :param `control`: the control to be added;
+ :param `label`: the label which appears if the control goes into the
+ overflow items in the toolbar.
+ """
+
+ item = AuiToolBarItem()
+ item.window = control
+ item.label = label
+ item.bitmap = wx.NullBitmap
+ item.disabled_bitmap = wx.NullBitmap
+ item.active = True
+ item.dropdown = False
+ item.spacer_pixels = 0
+ item.id = control.GetId()
+ item.state = 0
+ item.proportion = 0
+ item.kind = ITEM_CONTROL
+ item.sizer_item = None
+ item.min_size = control.GetEffectiveMinSize()
+ item.user_data = 0
+ item.sticky = False
+ item.orientation = self._tool_orientation
+
+ self._items.append(item)
+ return self._items[-1]
+
+
+ def AddLabel(self, tool_id, label="", width=0):
+ """
+ Adds a label tool to the L{AuiToolBar}.
+
+ :param `tool_id`: an integer by which the tool may be identified in subsequent operations;
+ :param `label`: the toolbar tool label;
+ :param `width`: the tool width.
+ """
+
+ min_size = wx.Size(-1, -1)
+
+ if width != -1:
+ min_size.x = width
+
+ item = AuiToolBarItem()
+ item.window = None
+ item.label = label
+ item.bitmap = wx.NullBitmap
+ item.disabled_bitmap = wx.NullBitmap
+ item.active = True
+ item.dropdown = False
+ item.spacer_pixels = 0
+
+ if tool_id == wx.ID_ANY:
+ tool_id = wx.NewId()
+
+ item.id = tool_id
+ item.state = 0
+ item.proportion = 0
+ item.kind = ITEM_LABEL
+ item.sizer_item = None
+ item.min_size = min_size
+ item.user_data = 0
+ item.sticky = False
+ item.orientation = self._tool_orientation
+
+ self._items.append(item)
+ return self._items[-1]
+
+
+ def AddSeparator(self):
+ """ Adds a separator for spacing groups of tools. """
+
+ item = AuiToolBarItem()
+ item.window = None
+ item.label = ""
+ item.bitmap = wx.NullBitmap
+ item.disabled_bitmap = wx.NullBitmap
+ item.active = True
+ item.dropdown = False
+ item.id = -1
+ item.state = 0
+ item.proportion = 0
+ item.kind = ITEM_SEPARATOR
+ item.sizer_item = None
+ item.min_size = wx.Size(-1, -1)
+ item.user_data = 0
+ item.sticky = False
+ item.orientation = self._tool_orientation
+
+ self._items.append(item)
+ return self._items[-1]
+
+
+ def AddSpacer(self, pixels):
+ """
+ Adds a spacer for spacing groups of tools.
+
+ :param `pixels`: the width of the spacer.
+ """
+
+ item = AuiToolBarItem()
+ item.window = None
+ item.label = ""
+ item.bitmap = wx.NullBitmap
+ item.disabled_bitmap = wx.NullBitmap
+ item.active = True
+ item.dropdown = False
+ item.spacer_pixels = pixels
+ item.id = -1
+ item.state = 0
+ item.proportion = 0
+ item.kind = ITEM_SPACER
+ item.sizer_item = None
+ item.min_size = wx.Size(-1, -1)
+ item.user_data = 0
+ item.sticky = False
+ item.orientation = self._tool_orientation
+
+ self._items.append(item)
+ return self._items[-1]
+
+
+ def AddStretchSpacer(self, proportion=1):
+ """
+ Adds a stretchable spacer for spacing groups of tools.
+
+ :param `proportion`: the stretchable spacer proportion.
+ """
+
+ item = AuiToolBarItem()
+ item.window = None
+ item.label = ""
+ item.bitmap = wx.NullBitmap
+ item.disabled_bitmap = wx.NullBitmap
+ item.active = True
+ item.dropdown = False
+ item.spacer_pixels = 0
+ item.id = -1
+ item.state = 0
+ item.proportion = proportion
+ item.kind = ITEM_SPACER
+ item.sizer_item = None
+ item.min_size = wx.Size(-1, -1)
+ item.user_data = 0
+ item.sticky = False
+ item.orientation = self._tool_orientation
+
+ self._items.append(item)
+ return self._items[-1]
+
+
+ def Clear(self):
+ """ Deletes all the tools in the L{AuiToolBar}. """
+
+ self._items = []
+ self._sizer_element_count = 0
+
+
+ def ClearTools(self):
+ """ Deletes all the tools in the L{AuiToolBar}. """
+
+ self.Clear()
+
+
+ def DeleteTool(self, tool_id):
+ """
+ Removes the specified tool from the toolbar and deletes it.
+
+ :param `tool_id`: the L{AuiToolBarItem} identifier.
+
+ :returns: ``True`` if the tool was deleted, ``False`` otherwise.
+
+ :note: Note that it is unnecessary to call L{Realize} for the change to
+ take place, it will happen immediately.
+ """
+
+ idx = self.GetToolIndex(tool_id)
+
+ if idx >= 0 and idx < len(self._items):
+ self._items.pop(idx)
+ self.Realize()
+ return True
+
+ return False
+
+
+ def DeleteToolByPos(self, pos):
+ """
+ This function behaves like L{DeleteTool} but it deletes the tool at the
+ specified position and not the one with the given id.
+
+ :param `pos`: the tool position.
+
+ :see: L{DeleteTool}
+ """
+
+ if pos >= 0 and pos < len(self._items):
+
+ self._items.pop(pos)
+ self.Realize()
+ return True
+
+ return False
+
+
+ def FindControl(self, id):
+ """
+ Returns a pointer to the control identified by `id` or ``None`` if no corresponding
+ control is found.
+
+ :param `id`: the control identifier.
+ """
+
+ wnd = self.FindWindow(id)
+ return wnd
+
+
+ def FindTool(self, tool_id):
+ """
+ Finds a tool for the given tool id.
+
+ :param `tool_id`: the L{AuiToolBarItem} identifier.
+ """
+
+ for item in self._items:
+ if item.id == tool_id:
+ return item
+
+ return None
+
+
+ def FindToolForPosition(self, x, y):
+ """
+ Finds a tool for the given mouse position.
+
+ :param `x`: mouse `x` position;
+ :param `y`: mouse `y` position.
+
+ :returns: a pointer to a L{AuiToolBarItem} if a tool is found, or ``None`` otherwise.
+ """
+
+ for i, item in enumerate(self._items):
+ if not item.sizer_item:
+ continue
+
+ rect = item.sizer_item.GetRect()
+ if rect.Contains((x,y)):
+
+ # if the item doesn't fit on the toolbar, return None
+ if not self.GetToolFitsByIndex(i):
+ return None
+
+ return item
+
+ return None
+
+
+ def FindToolForPositionWithPacking(self, x, y):
+ """
+ Finds a tool for the given mouse position, taking into account also the
+ tool packing.
+
+ :param `x`: mouse `x` position;
+ :param `y`: mouse `y` position.
+
+ :returns: a pointer to a L{AuiToolBarItem} if a tool is found, or ``None`` otherwise.
+ """
+
+ count = len(self._items)
+
+ for i, item in enumerate(self._items):
+ if not item.sizer_item:
+ continue
+
+ rect = item.sizer_item.GetRect()
+
+ # apply tool packing
+ if i+1 < count:
+ rect.width += self._tool_packing
+
+ if rect.Contains((x,y)):
+
+ # if the item doesn't fit on the toolbar, return None
+ if not self.GetToolFitsByIndex(i):
+ return None
+
+ return item
+
+ return None
+
+
+ def FindToolByIndex(self, pos):
+ """
+ Finds a tool for the given tool position in the L{AuiToolBar}.
+
+ :param `pos`: the tool position in the toolbar.
+
+ :returns: a pointer to a L{AuiToolBarItem} if a tool is found, or ``None`` otherwise.
+ """
+
+ if pos < 0 or pos >= len(self._items):
+ return None
+
+ return self._items[pos]
+
+
+ def SetToolBitmapSize(self, size):
+ """
+ Sets the default size of each tool bitmap. The default bitmap size is
+ 16 by 15 pixels.
+
+ :param `size`: the size of the bitmaps in the toolbar.
+
+ :note: This should be called to tell the toolbar what the tool bitmap
+ size is. Call it before you add tools.
+
+ :note: Note that this is the size of the bitmap you pass to L{AddTool},
+ and not the eventual size of the tool button.
+
+ :todo: Add `wx.ToolBar` compatibility, actually implementing this method.
+ """
+
+ # TODO: wx.ToolBar compatibility
+ pass
+
+
+ def GetToolBitmapSize(self):
+ """
+ Returns the size of bitmap that the toolbar expects to have. The default
+ bitmap size is 16 by 15 pixels.
+
+ :note: Note that this is the size of the bitmap you pass to L{AddTool},
+ and not the eventual size of the tool button.
+
+ :todo: Add `wx.ToolBar` compatibility, actually implementing this method.
+ """
+
+ # TODO: wx.ToolBar compatibility
+ return wx.Size(16, 15)
+
+
+ def SetToolProportion(self, tool_id, proportion):
+ """
+ Sets the tool proportion in the toolbar.
+
+ :param `tool_id`: the L{AuiToolBarItem} identifier;
+ :param `proportion`: the tool proportion in the toolbar.
+ """
+
+ item = self.FindTool(tool_id)
+ if not item:
+ return
+
+ item.proportion = proportion
+
+
+ def GetToolProportion(self, tool_id):
+ """
+ Returns the tool proportion in the toolbar.
+
+ :param `tool_id`: the L{AuiToolBarItem} identifier.
+ """
+
+ item = self.FindTool(tool_id)
+ if not item:
+ return
+
+ return item.proportion
+
+
+ def SetToolSeparation(self, separation):
+ """
+ Sets the separator size for the toolbar.
+
+ :param `separation`: the separator size in pixels.
+ """
+
+ if self._art:
+ self._art.SetElementSize(AUI_TBART_SEPARATOR_SIZE, separation)
+
+
+ def GetToolSeparation(self):
+ """ Returns the separator size for the toolbar, in pixels. """
+
+ if self._art:
+ return self._art.GetElementSize(AUI_TBART_SEPARATOR_SIZE)
+
+ return 5
+
+
+ def SetToolDropDown(self, tool_id, dropdown):
+ """
+ Assigns a drop down window menu to the toolbar item.
+
+ :param `tool_id`: the L{AuiToolBarItem} identifier;
+ :param `dropdown`: whether to assign a drop down menu or not.
+ """
+
+ item = self.FindTool(tool_id)
+ if not item:
+ return
+
+ item.dropdown = dropdown
+
+
+ def GetToolDropDown(self, tool_id):
+ """
+ Returns whether the toolbar item identified by `tool_id` has an associated
+ drop down window menu or not.
+
+ :param `tool_id`: the L{AuiToolBarItem} identifier.
+ """
+
+ item = self.FindTool(tool_id)
+ if not item:
+ return
+
+ return item.dropdown
+
+
+ def SetToolSticky(self, tool_id, sticky):
+ """
+ Sets the toolbar item as sticky or non-sticky.
+
+ :param `tool_id`: the L{AuiToolBarItem} identifier;
+ :param `sticky`: whether the tool should be sticky or not.
+ """
+
+ # ignore separators
+ if tool_id == -1:
+ return
+
+ item = self.FindTool(tool_id)
+ if not item:
+ return
+
+ if item.sticky == sticky:
+ return
+
+ item.sticky = sticky
+
+ self.Refresh(False)
+ self.Update()
+
+
+ def GetToolSticky(self, tool_id):
+ """
+ Returns whether the toolbar item identified by `tool_id` has a sticky
+ behaviour or not.
+
+ :param `tool_id`: the L{AuiToolBarItem} identifier.
+ """
+
+ item = self.FindTool(tool_id)
+ if not item:
+ return
+
+ return item.sticky
+
+
+ def SetToolBorderPadding(self, padding):
+ """
+ Sets the padding between the tool border and the label.
+
+ :param `padding`: the padding in pixels.
+ """
+
+ self._tool_border_padding = padding
+
+
+ def GetToolBorderPadding(self):
+ """ Returns the padding between the tool border and the label, in pixels. """
+
+ return self._tool_border_padding
+
+
+ def SetToolTextOrientation(self, orientation):
+ """
+ Sets the label orientation for the toolbar items.
+
+ :param `orientation`: the L{AuiToolBarItem} label orientation.
+ """
+
+ self._tool_text_orientation = orientation
+
+ if self._art:
+ self._art.SetTextOrientation(orientation)
+
+
+ def GetToolTextOrientation(self):
+ """ Returns the label orientation for the toolbar items. """
+
+ return self._tool_text_orientation
+
+
+ def SetToolOrientation(self, orientation):
+ """
+ Sets the tool orientation for the toolbar items.
+
+ :param `orientation`: the L{AuiToolBarItem} orientation.
+ """
+
+ self._tool_orientation = orientation
+ if self._art:
+ self._art.SetOrientation(orientation)
+
+
+ def GetToolOrientation(self):
+ """ Returns the orientation for the toolbar items. """
+
+ return self._tool_orientation
+
+
+ def SetToolPacking(self, packing):
+ """
+ Sets the value used for spacing tools. The default value is 1 pixel.
+
+ :param `packing`: the value for packing.
+ """
+
+ self._tool_packing = packing
+
+
+ def GetToolPacking(self):
+ """ Returns the value used for spacing tools. The default value is 1 pixel. """
+
+ return self._tool_packing
+
+
+ def SetOrientation(self, orientation):
+ """
+ Sets the toolbar orientation.
+
+ :param `orientation`: either ``wx.VERTICAL`` or ``wx.HORIZONTAL``.
+
+ :note: This can be temporarily overridden by L{AuiManager} when floating and
+ docking a L{AuiToolBar}.
+ """
+
+ pass
+
+
+ def SetMargins(self, left=-1, right=-1, top=-1, bottom=-1):
+ """
+ Set the values to be used as margins for the toolbar.
+
+ :param `left`: the left toolbar margin;
+ :param `right`: the right toolbar margin;
+ :param `top`: the top toolbar margin;
+ :param `bottom`: the bottom toolbar margin.
+ """
+
+ if left != -1:
+ self._left_padding = left
+ if right != -1:
+ self._right_padding = right
+ if top != -1:
+ self._top_padding = top
+ if bottom != -1:
+ self._bottom_padding = bottom
+
+
+ def SetMarginsSize(self, size):
+ """
+ Set the values to be used as margins for the toolbar.
+
+ :param `size`: the margin size (an instance of `wx.Size`).
+ """
+
+ self.SetMargins(size.x, size.x, size.y, size.y)
+
+
+ def SetMarginsXY(self, x, y):
+ """
+ Set the values to be used as margins for the toolbar.
+
+ :param `x`: left margin, right margin and inter-tool separation value;
+ :param `y`: top margin, bottom margin and inter-tool separation value.
+ """
+
+ self.SetMargins(x, x, y, y)
+
+
+ def GetGripperVisible(self):
+ """ Returns whether the toolbar gripper is visible or not. """
+
+ return self._gripper_visible
+
+
+ def SetGripperVisible(self, visible):
+ """
+ Sets whether the toolbar gripper is visible or not.
+
+ :param `visible`: ``True`` for a visible gripper, ``False`` otherwise.
+ """
+
+ self._gripper_visible = visible
+ if visible:
+ self._agwStyle |= AUI_TB_GRIPPER
+ else:
+ self._agwStyle &= ~AUI_TB_GRIPPER
+
+ self.Realize()
+ self.Refresh(False)
+
+
+ def GetOverflowVisible(self):
+ """ Returns whether the overflow button is visible or not. """
+
+ return self._overflow_visible
+
+
+ def SetOverflowVisible(self, visible):
+ """
+ Sets whether the overflow button is visible or not.
+
+ :param `visible`: ``True`` for a visible overflow button, ``False`` otherwise.
+ """
+
+ self._overflow_visible = visible
+ if visible:
+ self._agwStyle |= AUI_TB_OVERFLOW
+ else:
+ self._agwStyle &= ~AUI_TB_OVERFLOW
+
+ self.Refresh(False)
+
+
+ def SetFont(self, font):
+ """
+ Sets the L{AuiToolBar} font.
+
+ :param `font`: a `wx.Font` object.
+
+ :note: Overridden from `wx.PyControl`.
+ """
+
+ res = wx.PyControl.SetFont(self, font)
+
+ if self._art:
+ self._art.SetFont(font)
+
+ return res
+
+
+ def SetHoverItem(self, pitem):
+ """
+ Sets a toolbar item to be currently hovered by the mouse.
+
+ :param `pitem`: an instance of L{AuiToolBarItem}.
+ """
+
+ former_hover = None
+
+ for item in self._items:
+
+ if item.state & AUI_BUTTON_STATE_HOVER:
+ former_hover = item
+
+ item.state &= ~AUI_BUTTON_STATE_HOVER
+
+ if pitem:
+ pitem.state |= AUI_BUTTON_STATE_HOVER
+
+ if former_hover != pitem:
+ self.Refresh(False)
+ self.Update()
+
+
+ def SetPressedItem(self, pitem):
+ """
+ Sets a toolbar item to be currently in a "pressed" state.
+
+ :param `pitem`: an instance of L{AuiToolBarItem}.
+ """
+
+ former_item = None
+
+ for item in self._items:
+
+ if item.state & AUI_BUTTON_STATE_PRESSED:
+ former_item = item
+
+ item.state &= ~AUI_BUTTON_STATE_PRESSED
+
+ if pitem:
+ pitem.state &= ~AUI_BUTTON_STATE_HOVER
+ pitem.state |= AUI_BUTTON_STATE_PRESSED
+
+ if former_item != pitem:
+ self.Refresh(False)
+ self.Update()
+
+
+ def RefreshOverflowState(self):
+ """ Refreshes the overflow button. """
+
+ if not self._overflow_sizer_item:
+ self._overflow_state = 0
+ return
+
+ overflow_state = 0
+ overflow_rect = self.GetOverflowRect()
+
+ # find out the mouse's current position
+ pt = wx.GetMousePosition()
+ pt = self.ScreenToClient(pt)
+
+ # find out if the mouse cursor is inside the dropdown rectangle
+ if overflow_rect.Contains((pt.x, pt.y)):
+
+ if _VERSION_STRING < "2.9":
+ leftDown = wx.GetMouseState().LeftDown()
+ else:
+ leftDown = wx.GetMouseState().LeftIsDown()
+
+ if leftDown:
+ overflow_state = AUI_BUTTON_STATE_PRESSED
+ else:
+ overflow_state = AUI_BUTTON_STATE_HOVER
+
+ if overflow_state != self._overflow_state:
+ self._overflow_state = overflow_state
+ self.Refresh(False)
+ self.Update()
+
+ self._overflow_state = overflow_state
+
+
+ def ToggleTool(self, tool_id, state):
+ """
+ Toggles a tool on or off. This does not cause any event to get emitted.
+
+ :param `tool_id`: tool in question.
+ :param `state`: if ``True``, toggles the tool on, otherwise toggles it off.
+
+ :note: This only applies to a tool that has been specified as a toggle tool.
+ """
+
+ tool = self.FindTool(tool_id)
+
+ if tool:
+ if tool.kind not in [ITEM_CHECK, ITEM_RADIO]:
+ return
+
+ if tool.kind == ITEM_RADIO:
+ idx = self.GetToolIndex(tool_id)
+ if idx >= 0 and idx < len(self._items):
+ for i in xrange(idx, len(self._items)):
+ tool = self.FindToolByIndex(i)
+ if tool.kind != ITEM_RADIO:
+ break
+ tool.state &= ~AUI_BUTTON_STATE_CHECKED
+
+ for i in xrange(idx, -1, -1):
+ tool = self.FindToolByIndex(i)
+ if tool.kind != ITEM_RADIO:
+ break
+ tool.state &= ~AUI_BUTTON_STATE_CHECKED
+
+ tool = self.FindTool(tool_id)
+ tool.state |= AUI_BUTTON_STATE_CHECKED
+ else:
+ if state == True:
+ tool.state |= AUI_BUTTON_STATE_CHECKED
+ else:
+ tool.state &= ~AUI_BUTTON_STATE_CHECKED
+
+
+ def GetToolToggled(self, tool_id):
+ """
+ Returns whether a tool is toggled or not.
+
+ :param `tool_id`: the toolbar item identifier.
+
+ :note: This only applies to a tool that has been specified as a toggle tool.
+ """
+
+ tool = self.FindTool(tool_id)
+
+ if tool:
+ if tool.kind not in [ITEM_CHECK, ITEM_RADIO]:
+ return False
+
+ return (tool.state & AUI_BUTTON_STATE_CHECKED and [True] or [False])[0]
+
+ return False
+
+
+ def EnableTool(self, tool_id, state):
+ """
+ Enables or disables the tool.
+
+ :param `tool_id`: identifier for the tool to enable or disable.
+ :param `state`: if ``True``, enables the tool, otherwise disables it.
+ """
+
+ tool = self.FindTool(tool_id)
+
+ if tool:
+
+ if state == True:
+ tool.state &= ~AUI_BUTTON_STATE_DISABLED
+ else:
+ tool.state |= AUI_BUTTON_STATE_DISABLED
+
+
+ def GetToolEnabled(self, tool_id):
+ """
+ Returns whether the tool identified by `tool_id` is enabled or not.
+
+ :param `tool_id`: the tool identifier.
+ """
+
+ tool = self.FindTool(tool_id)
+
+ if tool:
+ return (tool.state & AUI_BUTTON_STATE_DISABLED and [False] or [True])[0]
+
+ return False
+
+
+ def GetToolLabel(self, tool_id):
+ """
+ Returns the tool label for the tool identified by `tool_id`.
+
+ :param `tool_id`: the tool identifier.
+ """
+
+ tool = self.FindTool(tool_id)
+ if not tool:
+ return ""
+
+ return tool.label
+
+
+ def SetToolLabel(self, tool_id, label):
+ """
+ Sets the tool label for the tool identified by `tool_id`.
+
+ :param `tool_id`: the tool identifier;
+ :param `label`: the new toolbar item label.
+ """
+
+ tool = self.FindTool(tool_id)
+ if tool:
+ tool.label = label
+
+
+ def GetToolBitmap(self, tool_id):
+ """
+ Returns the tool bitmap for the tool identified by `tool_id`.
+
+ :param `tool_id`: the tool identifier.
+ """
+
+ tool = self.FindTool(tool_id)
+ if not tool:
+ return wx.NullBitmap
+
+ return tool.bitmap
+
+
+ def SetToolBitmap(self, tool_id, bitmap):
+ """
+ Sets the tool bitmap for the tool identified by `tool_id`.
+
+ :param `tool_id`: the tool identifier;
+ :param `bitmap`: the new bitmap for the toolbar item (an instance of `wx.Bitmap`).
+ """
+
+ tool = self.FindTool(tool_id)
+ if tool:
+ tool.bitmap = bitmap
+
+
+ def SetToolNormalBitmap(self, tool_id, bitmap):
+ """
+ Sets the tool bitmap for the tool identified by `tool_id`.
+
+ :param `tool_id`: the tool identifier;
+ :param `bitmap`: the new bitmap for the toolbar item (an instance of `wx.Bitmap`).
+ """
+
+ self.SetToolBitmap(tool_id, bitmap)
+
+
+ def SetToolDisabledBitmap(self, tool_id, bitmap):
+ """
+ Sets the tool disabled bitmap for the tool identified by `tool_id`.
+
+ :param `tool_id`: the tool identifier;
+ :param `bitmap`: the new disabled bitmap for the toolbar item (an instance of `wx.Bitmap`).
+ """
+
+ tool = self.FindTool(tool_id)
+ if tool:
+ tool.disabled_bitmap = bitmap
+
+
+ def GetToolShortHelp(self, tool_id):
+ """
+ Returns the short help for the given tool.
+
+ :param `tool_id`: the tool identifier.
+ """
+
+ tool = self.FindTool(tool_id)
+ if not tool:
+ return ""
+
+ return tool.short_help
+
+
+ def SetToolShortHelp(self, tool_id, help_string):
+ """
+ Sets the short help for the given tool.
+
+ :param `tool_id`: the tool identifier;
+ :param `help_string`: the string for the short help.
+ """
+
+ tool = self.FindTool(tool_id)
+ if tool:
+ tool.short_help = help_string
+
+
+ def GetToolLongHelp(self, tool_id):
+ """
+ Returns the long help for the given tool.
+
+ :param `tool_id`: the tool identifier.
+ """
+
+ tool = self.FindTool(tool_id)
+ if not tool:
+ return ""
+
+ return tool.long_help
+
+
+ def SetToolAlignment(self, alignment=wx.EXPAND):
+ """
+ This sets the alignment for all of the tools within the
+ toolbar (only has an effect when the toolbar is expanded).
+
+ :param `alignment`: `wx.Sizer` alignment value
+ (``wx.ALIGN_CENTER_HORIZONTAL`` or ``wx.ALIGN_CENTER_VERTICAL``).
+ """
+
+ self._tool_alignment = alignment
+
+
+
+ def SetToolLongHelp(self, tool_id, help_string):
+ """
+ Sets the long help for the given tool.
+
+ :param `tool_id`: the tool identifier;
+ :param `help_string`: the string for the long help.
+ """
+
+ tool = self.FindTool(tool_id)
+ if tool:
+ tool.long_help = help_string
+
+
+ def SetCustomOverflowItems(self, prepend, append):
+ """
+ Sets the two lists `prepend` and `append` as custom overflow items.
+
+ :param `prepend`: a list of L{AuiToolBarItem} to be prepended;
+ :param `append`: a list of L{AuiToolBarItem} to be appended.
+ """
+
+ self._custom_overflow_prepend = prepend
+ self._custom_overflow_append = append
+
+
+ def GetToolCount(self):
+ """ Returns the number of tools in the L{AuiToolBar}. """
+
+ return len(self._items)
+
+
+ def GetToolIndex(self, tool_id):
+ """
+ Returns the position of the tool in the toolbar given its identifier.
+
+ :param `tool_id`: the toolbar item identifier.
+ """
+
+ # this will prevent us from returning the index of the
+ # first separator in the toolbar since its id is equal to -1
+ if tool_id == -1:
+ return wx.NOT_FOUND
+
+ for i, item in enumerate(self._items):
+ if item.id == tool_id:
+ return i
+
+ return wx.NOT_FOUND
+
+
+ def GetToolPos(self, tool_id):
+ """
+ Returns the position of the tool in the toolbar given its identifier.
+
+ :param `tool_id`: the toolbar item identifier.
+ """
+
+ return self.GetToolIndex(tool_id)
+
+
+ def GetToolFitsByIndex(self, tool_id):
+ """
+ Returns whether the tool identified by `tool_id` fits into the toolbar or not.
+
+ :param `tool_id`: the toolbar item identifier.
+ """
+
+ if tool_id < 0 or tool_id >= len(self._items):
+ return False
+
+ if not self._items[tool_id].sizer_item:
+ return False
+
+ cli_w, cli_h = self.GetClientSize()
+ rect = self._items[tool_id].sizer_item.GetRect()
+
+ if self._agwStyle & AUI_TB_VERTICAL:
+ # take the dropdown size into account
+ if self._overflow_visible:
+ cli_h -= self._overflow_sizer_item.GetSize().y
+
+ if rect.y+rect.height < cli_h:
+ return True
+
+ else:
+
+ # take the dropdown size into account
+ if self._overflow_visible:
+ cli_w -= self._overflow_sizer_item.GetSize().x
+
+ if rect.x+rect.width < cli_w:
+ return True
+
+ return False
+
+
+ def GetToolFits(self, tool_id):
+ """
+ Returns whether the tool identified by `tool_id` fits into the toolbar or not.
+
+ :param `tool_id`: the toolbar item identifier.
+ """
+
+ return self.GetToolFitsByIndex(self.GetToolIndex(tool_id))
+
+
+ def GetToolRect(self, tool_id):
+ """
+ Returns the toolbar item rectangle
+
+ :param `tool_id`: the toolbar item identifier.
+ """
+
+ tool = self.FindTool(tool_id)
+ if tool and tool.sizer_item:
+ return tool.sizer_item.GetRect()
+
+ return wx.Rect()
+
+
+ def GetToolBarFits(self):
+ """ Returns whether the L{AuiToolBar} size fits in a specified size. """
+
+ if len(self._items) == 0:
+ # empty toolbar always 'fits'
+ return True
+
+ # entire toolbar content fits if the last tool fits
+ return self.GetToolFitsByIndex(len(self._items) - 1)
+
+
+ def Realize(self):
+ """ Realizes the toolbar. This function should be called after you have added tools. """
+
+ dc = wx.ClientDC(self)
+
+ if not dc.IsOk():
+ return False
+
+ horizontal = True
+ if self._agwStyle & AUI_TB_VERTICAL:
+ horizontal = False
+
+ # create the new sizer to add toolbar elements to
+ sizer = wx.BoxSizer((horizontal and [wx.HORIZONTAL] or [wx.VERTICAL])[0])
+
+ # add gripper area
+ separator_size = self._art.GetElementSize(AUI_TBART_SEPARATOR_SIZE)
+ gripper_size = self._art.GetElementSize(AUI_TBART_GRIPPER_SIZE)
+
+ if gripper_size > 0 and self._gripper_visible:
+ if horizontal:
+ self._gripper_sizer_item = sizer.Add((gripper_size, 1), 0, wx.EXPAND)
+ else:
+ self._gripper_sizer_item = sizer.Add((1, gripper_size), 0, wx.EXPAND)
+ else:
+ self._gripper_sizer_item = None
+
+ # add "left" padding
+ if self._left_padding > 0:
+ if horizontal:
+ sizer.Add((self._left_padding, 1))
+ else:
+ sizer.Add((1, self._left_padding))
+
+ count = len(self._items)
+ for i, item in enumerate(self._items):
+
+ sizer_item = None
+ kind = item.kind
+
+ if kind == ITEM_LABEL:
+
+ size = self._art.GetLabelSize(dc, self, item)
+ sizer_item = sizer.Add((size.x + (self._tool_border_padding*2),
+ size.y + (self._tool_border_padding*2)),
+ item.proportion,
+ item.alignment)
+ if i+1 < count:
+ sizer.AddSpacer(self._tool_packing)
+
+
+ elif kind in [ITEM_CHECK, ITEM_NORMAL, ITEM_RADIO]:
+
+ size = self._art.GetToolSize(dc, self, item)
+ sizer_item = sizer.Add((size.x + (self._tool_border_padding*2),
+ size.y + (self._tool_border_padding*2)),
+ 0,
+ item.alignment)
+ # add tool packing
+ if i+1 < count:
+ sizer.AddSpacer(self._tool_packing)
+
+ elif kind == ITEM_SEPARATOR:
+
+ if horizontal:
+ sizer_item = sizer.Add((separator_size, 1), 0, wx.EXPAND)
+ else:
+ sizer_item = sizer.Add((1, separator_size), 0, wx.EXPAND)
+
+ # add tool packing
+ if i+1 < count:
+ sizer.AddSpacer(self._tool_packing)
+
+ elif kind == ITEM_SPACER:
+
+ if item.proportion > 0:
+ sizer_item = sizer.AddStretchSpacer(item.proportion)
+ else:
+ sizer_item = sizer.Add((item.spacer_pixels, 1))
+
+ elif kind == ITEM_CONTROL:
+
+ vert_sizer = wx.BoxSizer(wx.VERTICAL)
+ vert_sizer.AddStretchSpacer(1)
+ ctrl_sizer_item = vert_sizer.Add(item.window, 0, wx.EXPAND)
+ vert_sizer.AddStretchSpacer(1)
+
+ if self._agwStyle & AUI_TB_TEXT and \
+ self._tool_text_orientation == AUI_TBTOOL_TEXT_BOTTOM and \
+ item.GetLabel() != "":
+
+ s = self.GetLabelSize(item.GetLabel())
+ vert_sizer.Add((1, s.y))
+
+ sizer_item = sizer.Add(vert_sizer, item.proportion, wx.EXPAND)
+ min_size = item.min_size
+
+ # proportional items will disappear from the toolbar if
+ # their min width is not set to something really small
+ if item.proportion != 0:
+ min_size.x = 1
+
+ if min_size.IsFullySpecified():
+ sizer.SetItemMinSize(vert_sizer, min_size)
+ vert_sizer.SetItemMinSize(item.window, min_size)
+
+ # add tool packing
+ if i+1 < count:
+ sizer.AddSpacer(self._tool_packing)
+
+ item.sizer_item = sizer_item
+
+
+ # add "right" padding
+ if self._right_padding > 0:
+ if horizontal:
+ sizer.Add((self._right_padding, 1))
+ else:
+ sizer.Add((1, self._right_padding))
+
+ # add drop down area
+ self._overflow_sizer_item = None
+
+ if self._agwStyle & AUI_TB_OVERFLOW:
+
+ overflow_size = self._art.GetElementSize(AUI_TBART_OVERFLOW_SIZE)
+ if overflow_size > 0 and self._overflow_visible:
+
+ if horizontal:
+ self._overflow_sizer_item = sizer.Add((overflow_size, 1), 0, wx.EXPAND)
+ else:
+ self._overflow_sizer_item = sizer.Add((1, overflow_size), 0, wx.EXPAND)
+
+ else:
+
+ self._overflow_sizer_item = None
+
+ # the outside sizer helps us apply the "top" and "bottom" padding
+ outside_sizer = wx.BoxSizer((horizontal and [wx.VERTICAL] or [wx.HORIZONTAL])[0])
+
+ # add "top" padding
+ if self._top_padding > 0:
+
+ if horizontal:
+ outside_sizer.Add((1, self._top_padding))
+ else:
+ outside_sizer.Add((self._top_padding, 1))
+
+ # add the sizer that contains all of the toolbar elements
+ outside_sizer.Add(sizer, 1, self._tool_alignment)
+
+ # add "bottom" padding
+ if self._bottom_padding > 0:
+
+ if horizontal:
+ outside_sizer.Add((1, self._bottom_padding))
+ else:
+ outside_sizer.Add((self._bottom_padding, 1))
+
+ del self._sizer # remove old sizer
+ self._sizer = outside_sizer
+ self.SetSizer(outside_sizer)
+
+ # calculate the rock-bottom minimum size
+ for item in self._items:
+
+ if item.sizer_item and item.proportion > 0 and item.min_size.IsFullySpecified():
+ item.sizer_item.SetMinSize((0, 0))
+
+ self._absolute_min_size = self._sizer.GetMinSize()
+
+ # reset the min sizes to what they were
+ for item in self._items:
+
+ if item.sizer_item and item.proportion > 0 and item.min_size.IsFullySpecified():
+ item.sizer_item.SetMinSize(item.min_size)
+
+ # set control size
+ size = self._sizer.GetMinSize()
+ self.SetMinSize(size)
+ self._minWidth = size.x
+ self._minHeight = size.y
+
+ if self._agwStyle & AUI_TB_NO_AUTORESIZE == 0:
+
+ cur_size = self.GetClientSize()
+ new_size = self.GetMinSize()
+
+ if new_size != cur_size:
+
+ self.SetClientSize(new_size)
+
+ else:
+
+ self._sizer.SetDimension(0, 0, cur_size.x, cur_size.y)
+
+ else:
+
+ cur_size = self.GetClientSize()
+ self._sizer.SetDimension(0, 0, cur_size.x, cur_size.y)
+
+ self.Refresh(False)
+ return True
+
+
+ def GetOverflowState(self):
+ """ Returns the state of the overflow button. """
+
+ return self._overflow_state
+
+
+ def GetOverflowRect(self):
+ """ Returns the rectangle of the overflow button. """
+
+ cli_rect = wx.RectPS(wx.Point(0, 0), self.GetClientSize())
+ overflow_rect = wx.Rect(*self._overflow_sizer_item.GetRect())
+ overflow_size = self._art.GetElementSize(AUI_TBART_OVERFLOW_SIZE)
+
+ if self._agwStyle & AUI_TB_VERTICAL:
+
+ overflow_rect.y = cli_rect.height - overflow_size
+ overflow_rect.x = 0
+ overflow_rect.width = cli_rect.width
+ overflow_rect.height = overflow_size
+
+ else:
+
+ overflow_rect.x = cli_rect.width - overflow_size
+ overflow_rect.y = 0
+ overflow_rect.width = overflow_size
+ overflow_rect.height = cli_rect.height
+
+ return overflow_rect
+
+
+ def GetLabelSize(self, label):
+ """
+ Returns the standard size of a toolbar item.
+
+ :param `label`: a test label.
+ """
+
+ dc = wx.ClientDC(self)
+ dc.SetFont(self._font)
+
+ return GetLabelSize(dc, label, self._tool_orientation != AUI_TBTOOL_HORIZONTAL)
+
+
+ def GetAuiManager(self):
+ """ Returns the L{AuiManager} which manages the toolbar. """
+
+ try:
+ return self._auiManager
+ except AttributeError:
+ return False
+
+
+ def SetAuiManager(self, auiManager):
+ """ Sets the L{AuiManager} which manages the toolbar. """
+
+ self._auiManager = auiManager
+
+
+ def DoIdleUpdate(self):
+ """ Updates the toolbar during idle times. """
+
+ handler = self.GetEventHandler()
+ if not handler:
+ return
+
+ need_refresh = False
+
+ for item in self._items:
+
+ if item.id == -1:
+ continue
+
+ evt = wx.UpdateUIEvent(item.id)
+ evt.SetEventObject(self)
+
+ if handler.ProcessEvent(evt):
+
+ if evt.GetSetEnabled():
+
+ if item.window:
+ is_enabled = item.window.IsEnabled()
+ else:
+ is_enabled = (item.state & AUI_BUTTON_STATE_DISABLED and [False] or [True])[0]
+
+ new_enabled = evt.GetEnabled()
+ if new_enabled != is_enabled:
+
+ if item.window:
+ item.window.Enable(new_enabled)
+ else:
+ if new_enabled:
+ item.state &= ~AUI_BUTTON_STATE_DISABLED
+ else:
+ item.state |= AUI_BUTTON_STATE_DISABLED
+
+ need_refresh = True
+
+ if evt.GetSetChecked():
+
+ # make sure we aren't checking an item that can't be
+ if item.kind != ITEM_CHECK and item.kind != ITEM_RADIO:
+ continue
+
+ is_checked = (item.state & AUI_BUTTON_STATE_CHECKED and [True] or [False])[0]
+ new_checked = evt.GetChecked()
+
+ if new_checked != is_checked:
+
+ if new_checked:
+ item.state |= AUI_BUTTON_STATE_CHECKED
+ else:
+ item.state &= ~AUI_BUTTON_STATE_CHECKED
+
+ need_refresh = True
+
+ if need_refresh:
+ self.Refresh(False)
+
+
+ def OnSize(self, event):
+ """
+ Handles the ``wx.EVT_SIZE`` event for L{AuiToolBar}.
+
+ :param `event`: a `wx.SizeEvent` event to be processed.
+ """
+
+ x, y = self.GetClientSize()
+ realize = False
+
+ if x > y:
+ self.SetOrientation(wx.HORIZONTAL)
+ else:
+ self.SetOrientation(wx.VERTICAL)
+
+ if (x >= y and self._absolute_min_size.x > x) or (y > x and self._absolute_min_size.y > y):
+
+ # hide all flexible items
+ for item in self._items:
+ if item.sizer_item and item.proportion > 0 and item.sizer_item.IsShown():
+ item.sizer_item.Show(False)
+ item.sizer_item.SetProportion(0)
+
+ if self._originalStyle & AUI_TB_OVERFLOW:
+ if not self.GetOverflowVisible():
+ self.SetOverflowVisible(True)
+ realize = True
+
+ else:
+
+ if self._originalStyle & AUI_TB_OVERFLOW and not self._custom_overflow_append and \
+ not self._custom_overflow_prepend:
+ if self.GetOverflowVisible():
+ self.SetOverflowVisible(False)
+ realize = True
+
+ # show all flexible items
+ for item in self._items:
+ if item.sizer_item and item.proportion > 0 and not item.sizer_item.IsShown():
+ item.sizer_item.Show(True)
+ item.sizer_item.SetProportion(item.proportion)
+
+ self._sizer.SetDimension(0, 0, x, y)
+
+ if realize:
+ self.Realize()
+ else:
+ self.Refresh(False)
+
+ self.Update()
+
+
+ def DoSetSize(self, x, y, width, height, sizeFlags=wx.SIZE_AUTO):
+ """
+ Sets the position and size of the window in pixels. The `sizeFlags`
+ parameter indicates the interpretation of the other params if they are
+ equal to -1.
+
+ :param `x`: the window `x` position;
+ :param `y`: the window `y` position;
+ :param `width`: the window width;
+ :param `height`: the window height;
+ :param `sizeFlags`: may have one of this bit set:
+
+ =================================== ======================================
+ Size Flags Description
+ =================================== ======================================
+ ``wx.SIZE_AUTO`` A -1 indicates that a class-specific default should be used.
+ ``wx.SIZE_AUTO_WIDTH`` A -1 indicates that a class-specific default should be used for the width.
+ ``wx.SIZE_AUTO_HEIGHT`` A -1 indicates that a class-specific default should be used for the height.
+ ``wx.SIZE_USE_EXISTING`` Existing dimensions should be used if -1 values are supplied.
+ ``wx.SIZE_ALLOW_MINUS_ONE`` Allow dimensions of -1 and less to be interpreted as real dimensions, not default values.
+ ``wx.SIZE_FORCE`` Normally, if the position and the size of the window are already the same as the parameters of this function, nothing is done. but with this flag a window resize may be forced even in this case (supported in wx 2.6.2 and later and only implemented for MSW and ignored elsewhere currently)
+ =================================== ======================================
+
+ :note: Overridden from `wx.PyControl`.
+ """
+
+ parent_size = self.GetParent().GetClientSize()
+ if x + width > parent_size.x:
+ width = max(0, parent_size.x - x)
+ if y + height > parent_size.y:
+ height = max(0, parent_size.y - y)
+
+ wx.PyControl.DoSetSize(self, x, y, width, height, sizeFlags)
+
+
+ def OnIdle(self, event):
+ """
+ Handles the ``wx.EVT_IDLE`` event for L{AuiToolBar}.
+
+ :param `event`: a `wx.IdleEvent` event to be processed.
+ """
+
+ self.DoIdleUpdate()
+ event.Skip()
+
+
+ def DoGetBestSize(self):
+ """
+ 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`.
+ """
+
+ return self._absolute_min_size
+
+
+ def OnPaint(self, event):
+ """
+ Handles the ``wx.EVT_PAINT`` event for L{AuiToolBar}.
+
+ :param `event`: a `wx.PaintEvent` event to be processed.
+ """
+
+ dc = wx.AutoBufferedPaintDC(self)
+ cli_rect = wx.RectPS(wx.Point(0, 0), self.GetClientSize())
+
+ horizontal = True
+ if self._agwStyle & AUI_TB_VERTICAL:
+ horizontal = False
+
+ if self._agwStyle & AUI_TB_PLAIN_BACKGROUND:
+ self._art.DrawPlainBackground(dc, self, cli_rect)
+ else:
+ self._art.DrawBackground(dc, self, cli_rect, horizontal)
+
+ gripper_size = self._art.GetElementSize(AUI_TBART_GRIPPER_SIZE)
+ dropdown_size = self._art.GetElementSize(AUI_TBART_OVERFLOW_SIZE)
+
+ # paint the gripper
+ if gripper_size > 0 and self._gripper_sizer_item:
+ gripper_rect = wx.Rect(*self._gripper_sizer_item.GetRect())
+ if horizontal:
+ gripper_rect.width = gripper_size
+ else:
+ gripper_rect.height = gripper_size
+
+ self._art.DrawGripper(dc, self, gripper_rect)
+
+ # calculated how far we can draw items
+ if horizontal:
+ last_extent = cli_rect.width
+ else:
+ last_extent = cli_rect.height
+
+ if self._overflow_visible:
+ last_extent -= dropdown_size
+
+ # paint each individual tool
+ for item in self._items:
+
+ if not item.sizer_item:
+ continue
+
+ item_rect = wx.Rect(*item.sizer_item.GetRect())
+
+ if (horizontal and item_rect.x + item_rect.width >= last_extent) or \
+ (not horizontal and item_rect.y + item_rect.height >= last_extent):
+
+ break
+
+ if item.kind == ITEM_SEPARATOR:
+ # draw a separator
+ self._art.DrawSeparator(dc, self, item_rect)
+
+ elif item.kind == ITEM_LABEL:
+ # draw a text label only
+ self._art.DrawLabel(dc, self, item, item_rect)
+
+ elif item.kind == ITEM_NORMAL:
+ # draw a regular button or dropdown button
+ if not item.dropdown:
+ self._art.DrawButton(dc, self, item, item_rect)
+ else:
+ self._art.DrawDropDownButton(dc, self, item, item_rect)
+
+ elif item.kind == ITEM_CHECK:
+ # draw a regular toggle button or a dropdown one
+ if not item.dropdown:
+ self._art.DrawButton(dc, self, item, item_rect)
+ else:
+ self._art.DrawDropDownButton(dc, self, item, item_rect)
+
+ elif item.kind == ITEM_RADIO:
+ # draw a toggle button
+ self._art.DrawButton(dc, self, item, item_rect)
+
+ elif item.kind == ITEM_CONTROL:
+ # draw the control's label
+ self._art.DrawControlLabel(dc, self, item, item_rect)
+
+ # fire a signal to see if the item wants to be custom-rendered
+ self.OnCustomRender(dc, item, item_rect)
+
+ # paint the overflow button
+ if dropdown_size > 0 and self._overflow_sizer_item:
+ dropdown_rect = self.GetOverflowRect()
+ self._art.DrawOverflowButton(dc, self, dropdown_rect, self._overflow_state)
+
+
+ def OnEraseBackground(self, event):
+ """
+ Handles the ``wx.EVT_ERASE_BACKGROUND`` event for L{AuiToolBar}.
+
+ :param `event`: a `wx.EraseEvent` event to be processed.
+
+ :note: This is intentionally empty, to reduce flicker.
+ """
+
+ pass
+
+
+ def OnLeftDown(self, event):
+ """
+ Handles the ``wx.EVT_LEFT_DOWN`` event for L{AuiToolBar}.
+
+ :param `event`: a `wx.MouseEvent` event to be processed.
+ """
+
+ cli_rect = wx.RectPS(wx.Point(0, 0), self.GetClientSize())
+ self.StopPreviewTimer()
+
+ if self._gripper_sizer_item:
+
+ gripper_rect = wx.Rect(*self._gripper_sizer_item.GetRect())
+ if gripper_rect.Contains(event.GetPosition()):
+
+ # find aui manager
+ manager = self.GetAuiManager()
+ if not manager:
+ return
+
+ x_drag_offset = event.GetX() - gripper_rect.GetX()
+ y_drag_offset = event.GetY() - gripper_rect.GetY()
+
+ clientPt = wx.Point(*event.GetPosition())
+ screenPt = self.ClientToScreen(clientPt)
+ managedWindow = manager.GetManagedWindow()
+ managerClientPt = managedWindow.ScreenToClient(screenPt)
+
+ # gripper was clicked
+ manager.OnGripperClicked(self, managerClientPt, wx.Point(x_drag_offset, y_drag_offset))
+ return
+
+ if self._overflow_sizer_item:
+ overflow_rect = self.GetOverflowRect()
+
+ if self._art and self._overflow_visible and overflow_rect.Contains(event.GetPosition()):
+
+ e = AuiToolBarEvent(wxEVT_COMMAND_AUITOOLBAR_OVERFLOW_CLICK, -1)
+ e.SetEventObject(self)
+ e.SetToolId(-1)
+ e.SetClickPoint(event.GetPosition())
+ processed = self.ProcessEvent(e)
+
+ if processed:
+ self.DoIdleUpdate()
+ else:
+ overflow_items = []
+
+ # add custom overflow prepend items, if any
+ count = len(self._custom_overflow_prepend)
+ for i in xrange(count):
+ overflow_items.append(self._custom_overflow_prepend[i])
+
+ # only show items that don't fit in the dropdown
+ count = len(self._items)
+ for i in xrange(count):
+
+ if not self.GetToolFitsByIndex(i):
+ overflow_items.append(self._items[i])
+
+ # add custom overflow append items, if any
+ count = len(self._custom_overflow_append)
+ for i in xrange(count):
+ overflow_items.append(self._custom_overflow_append[i])
+
+ res = self._art.ShowDropDown(self, overflow_items)
+ self._overflow_state = 0
+ self.Refresh(False)
+ if res != -1:
+ e = wx.CommandEvent(wx.wxEVT_COMMAND_MENU_SELECTED, res)
+ e.SetEventObject(self)
+ if not self.GetParent().ProcessEvent(e):
+ tool = self.FindTool(res)
+ if tool:
+ state = (tool.state & AUI_BUTTON_STATE_CHECKED and [True] or [False])[0]
+ self.ToggleTool(res, not state)
+
+ return
+
+ self._dragging = False
+ self._action_pos = wx.Point(*event.GetPosition())
+ self._action_item = self.FindToolForPosition(*event.GetPosition())
+
+ if self._action_item:
+
+ if self._action_item.state & AUI_BUTTON_STATE_DISABLED:
+
+ self._action_pos = wx.Point(-1, -1)
+ self._action_item = None
+ return
+
+ self.SetPressedItem(self._action_item)
+
+ # fire the tool dropdown event
+ e = AuiToolBarEvent(wxEVT_COMMAND_AUITOOLBAR_TOOL_DROPDOWN, self._action_item.id)
+ e.SetEventObject(self)
+ e.SetToolId(self._action_item.id)
+ e.SetDropDownClicked(False)
+
+ mouse_x, mouse_y = event.GetX(), event.GetY()
+ rect = wx.Rect(*self._action_item.sizer_item.GetRect())
+
+ if self._action_item.dropdown:
+ if (self._action_item.orientation == AUI_TBTOOL_HORIZONTAL and \
+ mouse_x >= (rect.x+rect.width-BUTTON_DROPDOWN_WIDTH-1) and \
+ mouse_x < (rect.x+rect.width)) or \
+ (self._action_item.orientation != AUI_TBTOOL_HORIZONTAL and \
+ mouse_y >= (rect.y+rect.height-BUTTON_DROPDOWN_WIDTH-1) and \
+ mouse_y < (rect.y+rect.height)):
+
+ e.SetDropDownClicked(True)
+
+ e.SetClickPoint(event.GetPosition())
+ e.SetItemRect(rect)
+ self.ProcessEvent(e)
+ self.DoIdleUpdate()
+
+
+ def OnLeftUp(self, event):
+ """
+ Handles the ``wx.EVT_LEFT_UP`` event for L{AuiToolBar}.
+
+ :param `event`: a `wx.MouseEvent` event to be processed.
+ """
+
+ self.SetPressedItem(None)
+
+ hit_item = self.FindToolForPosition(*event.GetPosition())
+
+ if hit_item and not hit_item.state & AUI_BUTTON_STATE_DISABLED:
+ self.SetHoverItem(hit_item)
+
+ if self._dragging:
+ # reset drag and drop member variables
+ self._dragging = False
+ self._action_pos = wx.Point(-1, -1)
+ self._action_item = None
+
+ else:
+
+ if self._action_item and hit_item == self._action_item:
+ self.SetToolTipString("")
+
+ if hit_item.kind in [ITEM_CHECK, ITEM_RADIO]:
+ toggle = not (self._action_item.state & AUI_BUTTON_STATE_CHECKED)
+ self.ToggleTool(self._action_item.id, toggle)
+
+ # repaint immediately
+ self.Refresh(False)
+ self.Update()
+
+ e = wx.CommandEvent(wx.wxEVT_COMMAND_MENU_SELECTED, self._action_item.id)
+ e.SetEventObject(self)
+ e.SetInt(toggle)
+ self._action_pos = wx.Point(-1, -1)
+ self._action_item = None
+
+ self.ProcessEvent(e)
+ self.DoIdleUpdate()
+
+ else:
+
+ if self._action_item.id == ID_RESTORE_FRAME:
+ # find aui manager
+ manager = self.GetAuiManager()
+
+ if not manager:
+ return
+
+ pane = manager.GetPane(self)
+ e = framemanager.AuiManagerEvent(framemanager.wxEVT_AUI_PANE_MIN_RESTORE)
+
+ e.SetManager(manager)
+ e.SetPane(pane)
+
+ manager.ProcessEvent(e)
+ self.DoIdleUpdate()
+
+ else:
+
+ e = wx.CommandEvent(wx.wxEVT_COMMAND_MENU_SELECTED, self._action_item.id)
+ e.SetEventObject(self)
+ self.ProcessEvent(e)
+ self.DoIdleUpdate()
+
+ # reset drag and drop member variables
+ self._dragging = False
+ self._action_pos = wx.Point(-1, -1)
+ self._action_item = None
+
+
+ def OnRightDown(self, event):
+ """
+ Handles the ``wx.EVT_RIGHT_DOWN`` event for L{AuiToolBar}.
+
+ :param `event`: a `wx.MouseEvent` event to be processed.
+ """
+
+ cli_rect = wx.RectPS(wx.Point(0, 0), self.GetClientSize())
+
+ if self._gripper_sizer_item:
+ gripper_rect = self._gripper_sizer_item.GetRect()
+ if gripper_rect.Contains(event.GetPosition()):
+ return
+
+ if self._overflow_sizer_item:
+
+ dropdown_size = self._art.GetElementSize(AUI_TBART_OVERFLOW_SIZE)
+ if dropdown_size > 0 and event.GetX() > cli_rect.width - dropdown_size and \
+ event.GetY() >= 0 and event.GetY() < cli_rect.height and self._art:
+ return
+
+ self._action_pos = wx.Point(*event.GetPosition())
+ self._action_item = self.FindToolForPosition(*event.GetPosition())
+
+ if self._action_item:
+ if self._action_item.state & AUI_BUTTON_STATE_DISABLED:
+
+ self._action_pos = wx.Point(-1, -1)
+ self._action_item = None
+ return
+
+
+ def OnRightUp(self, event):
+ """
+ Handles the ``wx.EVT_RIGHT_UP`` event for L{AuiToolBar}.
+
+ :param `event`: a `wx.MouseEvent` event to be processed.
+ """
+
+ hit_item = self.FindToolForPosition(*event.GetPosition())
+
+ if self._action_item and hit_item == self._action_item:
+
+ e = AuiToolBarEvent(wxEVT_COMMAND_AUITOOLBAR_RIGHT_CLICK, self._action_item.id)
+ e.SetEventObject(self)
+ e.SetToolId(self._action_item.id)
+ e.SetClickPoint(self._action_pos)
+ self.ProcessEvent(e)
+ self.DoIdleUpdate()
+
+ else:
+
+ # right-clicked on the invalid area of the toolbar
+ e = AuiToolBarEvent(wxEVT_COMMAND_AUITOOLBAR_RIGHT_CLICK, -1)
+ e.SetEventObject(self)
+ e.SetToolId(-1)
+ e.SetClickPoint(self._action_pos)
+ self.ProcessEvent(e)
+ self.DoIdleUpdate()
+
+ # reset member variables
+ self._action_pos = wx.Point(-1, -1)
+ self._action_item = None
+
+
+ def OnMiddleDown(self, event):
+ """
+ Handles the ``wx.EVT_MIDDLE_DOWN`` event for L{AuiToolBar}.
+
+ :param `event`: a `wx.MouseEvent` event to be processed.
+ """
+
+ cli_rect = wx.RectPS(wx.Point(0, 0), self.GetClientSize())
+
+ if self._gripper_sizer_item:
+
+ gripper_rect = self._gripper_sizer_item.GetRect()
+ if gripper_rect.Contains(event.GetPosition()):
+ return
+
+ if self._overflow_sizer_item:
+
+ dropdown_size = self._art.GetElementSize(AUI_TBART_OVERFLOW_SIZE)
+ if dropdown_size > 0 and event.GetX() > cli_rect.width - dropdown_size and \
+ event.GetY() >= 0 and event.GetY() < cli_rect.height and self._art:
+ return
+
+ self._action_pos = wx.Point(*event.GetPosition())
+ self._action_item = self.FindToolForPosition(*event.GetPosition())
+
+ if self._action_item:
+ if self._action_item.state & AUI_BUTTON_STATE_DISABLED:
+
+ self._action_pos = wx.Point(-1, -1)
+ self._action_item = None
+ return
+
+
+ def OnMiddleUp(self, event):
+ """
+ Handles the ``wx.EVT_MIDDLE_UP`` event for L{AuiToolBar}.
+
+ :param `event`: a `wx.MouseEvent` event to be processed.
+ """
+
+ hit_item = self.FindToolForPosition(*event.GetPosition())
+
+ if self._action_item and hit_item == self._action_item:
+ if hit_item.kind == ITEM_NORMAL:
+
+ e = AuiToolBarEvent(wxEVT_COMMAND_AUITOOLBAR_MIDDLE_CLICK, self._action_item.id)
+ e.SetEventObject(self)
+ e.SetToolId(self._action_item.id)
+ e.SetClickPoint(self._action_pos)
+ self.ProcessEvent(e)
+ self.DoIdleUpdate()
+
+ # reset member variables
+ self._action_pos = wx.Point(-1, -1)
+ self._action_item = None
+
+
+ def OnMotion(self, event):
+ """
+ Handles the ``wx.EVT_MOTION`` event for L{AuiToolBar}.
+
+ :param `event`: a `wx.MouseEvent` event to be processed.
+ """
+
+ # start a drag event
+ if not self._dragging and self._action_item != None and self._action_pos != wx.Point(-1, -1) and \
+ abs(event.GetX() - self._action_pos.x) + abs(event.GetY() - self._action_pos.y) > 5:
+
+ self.SetToolTipString("")
+ self._dragging = True
+
+ e = AuiToolBarEvent(wxEVT_COMMAND_AUITOOLBAR_BEGIN_DRAG, self.GetId())
+ e.SetEventObject(self)
+ e.SetToolId(self._action_item.id)
+ self.ProcessEvent(e)
+ self.DoIdleUpdate()
+ return
+
+ hit_item = self.FindToolForPosition(*event.GetPosition())
+
+ if hit_item:
+ if not hit_item.state & AUI_BUTTON_STATE_DISABLED:
+ self.SetHoverItem(hit_item)
+ else:
+ self.SetHoverItem(None)
+
+ else:
+ # no hit item, remove any hit item
+ self.SetHoverItem(hit_item)
+
+ # figure out tooltips
+ packing_hit_item = self.FindToolForPositionWithPacking(*event.GetPosition())
+
+ if packing_hit_item:
+
+ if packing_hit_item != self._tip_item:
+ self._tip_item = packing_hit_item
+
+ if packing_hit_item.short_help != "":
+ self.StartPreviewTimer()
+ self.SetToolTipString(packing_hit_item.short_help)
+ else:
+ self.SetToolTipString("")
+ self.StopPreviewTimer()
+
+ else:
+
+ self.SetToolTipString("")
+ self._tip_item = None
+ self.StopPreviewTimer()
+
+ # if we've pressed down an item and we're hovering
+ # over it, make sure it's state is set to pressed
+ if self._action_item:
+
+ if self._action_item == hit_item:
+ self.SetPressedItem(self._action_item)
+ else:
+ self.SetPressedItem(None)
+
+ # figure out the dropdown button state (are we hovering or pressing it?)
+ self.RefreshOverflowState()
+
+
+ def OnLeaveWindow(self, event):
+ """
+ Handles the ``wx.EVT_LEAVE_WINDOW`` event for L{AuiToolBar}.
+
+ :param `event`: a `wx.MouseEvent` event to be processed.
+ """
+
+ self.RefreshOverflowState()
+ self.SetHoverItem(None)
+ self.SetPressedItem(None)
+
+ self._tip_item = None
+ self.StopPreviewTimer()
+
+
+ def OnSetCursor(self, event):
+ """
+ Handles the ``wx.EVT_SET_CURSOR`` event for L{AuiToolBar}.
+
+ :param `event`: a `wx.SetCursorEvent` event to be processed.
+ """
+
+ cursor = wx.NullCursor
+
+ if self._gripper_sizer_item:
+
+ gripper_rect = self._gripper_sizer_item.GetRect()
+ if gripper_rect.Contains((event.GetX(), event.GetY())):
+ cursor = wx.StockCursor(wx.CURSOR_SIZING)
+
+ event.SetCursor(cursor)
+
+
+ def OnCustomRender(self, dc, item, rect):
+ """
+ Handles custom render for single L{AuiToolBar} items.
+
+ :param `dc`: a `wx.DC` device context;
+ :param `item`: an instance of L{AuiToolBarItem};
+ :param `rect`: the toolbar item rect.
+
+ :note: This method must be overridden to provide custom rendering of items.
+ """
+
+ pass
+
+
+ def IsPaneMinimized(self):
+ """ Returns whether this L{AuiToolBar} contains a minimized pane tool. """
+
+ manager = self.GetAuiManager()
+ if not manager:
+ return False
+
+ if manager.GetAGWFlags() & AUI_MGR_PREVIEW_MINIMIZED_PANES == 0:
+ # No previews here
+ return False
+
+ self_name = manager.GetPane(self).name
+
+ if not self_name.endswith("_min"):
+ # Wrong tool name
+ return False
+
+ return self_name[0:-4]
+
+
+ def StartPreviewTimer(self):
+ """ Starts a timer in L{AuiManager} to slide-in/slide-out the minimized pane. """
+
+ self_name = self.IsPaneMinimized()
+ if not self_name:
+ return
+
+ manager = self.GetAuiManager()
+ manager.StartPreviewTimer(self)
+
+
+ def StopPreviewTimer(self):
+ """ Stops a timer in L{AuiManager} to slide-in/slide-out the minimized pane. """
+
+ self_name = self.IsPaneMinimized()
+ if not self_name:
+ return
+
+ manager = self.GetAuiManager()
+ manager.StopPreviewTimer()
+