mirror of
https://github.com/Sneed-Group/Poodletooth-iLand
synced 2024-12-27 21:52:25 -06:00
399 lines
11 KiB
Python
399 lines
11 KiB
Python
# --------------------------------------------------------------------------- #
|
|
# PYBUSYINFO Control wxPython IMPLEMENTATION
|
|
# Inspired By And Heavily Based On wxBusyInfo.
|
|
#
|
|
# Python Code By:
|
|
#
|
|
# Andrea Gavana, @ 10 December 2009
|
|
# Latest Revision: 27 Dec 2012, 21.00 GMT
|
|
#
|
|
#
|
|
# TODO List/Caveats
|
|
#
|
|
# 1. ?
|
|
#
|
|
#
|
|
# For All Kind Of Problems, Requests Of Enhancements And Bug Reports, Please
|
|
# Write To Me At:
|
|
#
|
|
# andrea.gavana@gmail.com
|
|
# andrea.gavana@maerskoil.com
|
|
#
|
|
# Or, Obviously, To The wxPython Mailing List!!!
|
|
#
|
|
# Tags: phoenix-port, unittest, documented, py3-port
|
|
#
|
|
# End Of Comments
|
|
# --------------------------------------------------------------------------- #
|
|
|
|
"""
|
|
:class:`PyBusyInfo` constructs a busy info window and displays a message in it.
|
|
|
|
|
|
Description
|
|
===========
|
|
|
|
:class:`PyBusyInfo` constructs a busy info window and displays a message in it.
|
|
|
|
This class makes it easy to tell your user that the program is temporarily busy.
|
|
Just create a :class:`PyBusyInfo` object, and within the current scope, a message window
|
|
will be shown.
|
|
|
|
For example::
|
|
|
|
busy = PyBusyInfo("Please wait, working...")
|
|
|
|
for i in xrange(10000):
|
|
DoACalculation()
|
|
|
|
del busy
|
|
|
|
|
|
It works by creating a window in the constructor, and deleting it in the destructor.
|
|
You may also want to call :func:`Yield` () to refresh the window periodically (in case
|
|
it had been obscured by other windows, for example).
|
|
|
|
|
|
Usage
|
|
=====
|
|
|
|
Usage example::
|
|
|
|
import wx
|
|
import wx.lib.agw.pybusyinfo as PBI
|
|
|
|
class MyFrame(wx.Frame):
|
|
|
|
def __init__(self, parent):
|
|
|
|
wx.Frame.__init__(self, parent, -1, "PyBusyInfo Demo")
|
|
|
|
panel = wx.Panel(self)
|
|
|
|
b = wx.Button(panel, -1, "Test PyBusyInfo ", (50,50))
|
|
self.Bind(wx.EVT_BUTTON, self.OnButton, b)
|
|
|
|
|
|
def OnButton(self, event):
|
|
|
|
message = "Please wait 5 seconds, working..."
|
|
busy = PBI.PyBusyInfo(message, parent=self, title="Really Busy")
|
|
|
|
wx.Yield()
|
|
|
|
for indx in xrange(5):
|
|
wx.MilliSleep(1000)
|
|
|
|
del busy
|
|
|
|
|
|
# our normal wxApp-derived class, as usual
|
|
|
|
app = wx.App(0)
|
|
|
|
frame = MyFrame(None)
|
|
app.SetTopWindow(frame)
|
|
frame.Show()
|
|
|
|
app.MainLoop()
|
|
|
|
|
|
|
|
Supported Platforms
|
|
===================
|
|
|
|
:class:`PyBusyInfo` has been tested on the following platforms:
|
|
* Windows (Windows XP).
|
|
|
|
|
|
Window Styles
|
|
=============
|
|
|
|
`No particular window styles are available for this class.`
|
|
|
|
|
|
Events Processing
|
|
=================
|
|
|
|
`No custom events are available for this class.`
|
|
|
|
|
|
License And Version
|
|
===================
|
|
|
|
:class:`PyBusyInfo` is distributed under the wxPython license.
|
|
|
|
Latest Revision: Andrea Gavana @ 27 Dec 2012, 21.00 GMT
|
|
|
|
Version 0.3
|
|
|
|
"""
|
|
|
|
# Version Info
|
|
__version__ = "0.3"
|
|
|
|
import wx
|
|
|
|
_ = wx.GetTranslation
|
|
|
|
|
|
class PyInfoFrame(wx.Frame):
|
|
""" Base class for :class:`PyBusyInfo`. """
|
|
|
|
def __init__(self, parent, message, title, icon):
|
|
"""
|
|
Default class constructor.
|
|
|
|
:param `parent`: the frame parent;
|
|
:param `message`: the message to display in the :class:`PyBusyInfo`;
|
|
:param `title`: the main :class:`PyBusyInfo` title;
|
|
:param `icon`: an icon to draw as the frame icon, an instance of :class:`Bitmap`.
|
|
"""
|
|
|
|
wx.Frame.__init__(self, parent, wx.ID_ANY, title, wx.DefaultPosition,
|
|
wx.DefaultSize, wx.NO_BORDER|wx.FRAME_TOOL_WINDOW|wx.FRAME_SHAPED|wx.STAY_ON_TOP)
|
|
|
|
panel = wx.Panel(self)
|
|
panel.SetCursor(wx.HOURGLASS_CURSOR)
|
|
|
|
self._message = message
|
|
self._title = title
|
|
self._icon = icon
|
|
|
|
dc = wx.ClientDC(self)
|
|
textWidth, textHeight, dummy = dc.GetFullMultiLineTextExtent(self._message)
|
|
sizeText = wx.Size(textWidth, textHeight)
|
|
|
|
self.SetClientSize((max(sizeText.x, 340) + 60, max(sizeText.y, 40) + 60))
|
|
# need to size the panel correctly first so that text.Centre() works
|
|
panel.SetSize(self.GetClientSize())
|
|
|
|
# Bind the events to draw ourselves
|
|
panel.Bind(wx.EVT_PAINT, self.OnPaint)
|
|
panel.Bind(wx.EVT_ERASE_BACKGROUND, self.OnErase)
|
|
|
|
self.Centre(wx.BOTH)
|
|
|
|
# Create a non-rectangular region to set the frame shape
|
|
size = self.GetSize()
|
|
bmp = wx.Bitmap(size.x, size.y)
|
|
dc = wx.BufferedDC(None, bmp)
|
|
dc.SetBackground(wx.Brush(wx.Colour(0, 0, 0)))
|
|
dc.Clear()
|
|
dc.SetPen(wx.Pen(wx.Colour(0, 0, 0), 1))
|
|
dc.DrawRoundedRectangle(0, 0, size.x, size.y, 12)
|
|
r = wx.Region(bmp, wx.Colour(0, 0, 0))
|
|
# Store the non-rectangular region
|
|
self.reg = r
|
|
|
|
if wx.Platform == "__WXGTK__":
|
|
self.Bind(wx.EVT_WINDOW_CREATE, self.SetBusyShape)
|
|
else:
|
|
self.SetBusyShape()
|
|
|
|
# Add a custom bitmap at the top (if any)
|
|
|
|
|
|
def SetBusyShape(self, event=None):
|
|
"""
|
|
Sets :class:`PyInfoFrame` shape using the region created from the bitmap.
|
|
|
|
:param `event`: a :class:`WindowCreateEvent` event (GTK only, as GTK supports setting
|
|
the window shape only during window creation).
|
|
"""
|
|
|
|
self.SetShape(self.reg)
|
|
if event:
|
|
# GTK only
|
|
event.Skip()
|
|
|
|
|
|
def OnPaint(self, event):
|
|
"""
|
|
Handles the ``wx.EVT_PAINT`` event for :class:`PyInfoFrame`.
|
|
|
|
:param `event`: a :class:`PaintEvent` to be processed.
|
|
"""
|
|
|
|
panel = event.GetEventObject()
|
|
|
|
dc = wx.BufferedPaintDC(panel)
|
|
dc.Clear()
|
|
|
|
# Fill the background with a gradient shading
|
|
startColour = wx.SystemSettings.GetColour(wx.SYS_COLOUR_ACTIVECAPTION)
|
|
endColour = wx.WHITE
|
|
|
|
rect = panel.GetRect()
|
|
dc.GradientFillLinear(rect, startColour, endColour, wx.SOUTH)
|
|
|
|
# Draw the label
|
|
font = wx.SystemSettings.GetFont(wx.SYS_DEFAULT_GUI_FONT)
|
|
dc.SetFont(font)
|
|
|
|
# Draw the message
|
|
rect2 = wx.Rect(*rect)
|
|
rect2.height += 20
|
|
dc.DrawLabel(self._message, rect2, alignment=wx.ALIGN_CENTER|wx.ALIGN_CENTER)
|
|
|
|
# Draw the top title
|
|
font.SetWeight(wx.BOLD)
|
|
dc.SetFont(font)
|
|
dc.SetPen(wx.Pen(wx.SystemSettings.GetColour(wx.SYS_COLOUR_CAPTIONTEXT)))
|
|
dc.SetTextForeground(wx.SystemSettings.GetColour(wx.SYS_COLOUR_CAPTIONTEXT))
|
|
|
|
if self._icon.IsOk():
|
|
iconWidth, iconHeight = self._icon.GetWidth(), self._icon.GetHeight()
|
|
dummy, textHeight = dc.GetTextExtent(self._title)
|
|
textXPos, textYPos = iconWidth + 10, (iconHeight-textHeight)//2
|
|
dc.DrawBitmap(self._icon, 5, 5, True)
|
|
else:
|
|
textXPos, textYPos = 5, 0
|
|
|
|
dc.DrawText(self._title, textXPos, textYPos+5)
|
|
dc.DrawLine(5, 25, rect.width-5, 25)
|
|
|
|
size = self.GetSize()
|
|
dc.SetPen(wx.Pen(startColour, 1))
|
|
dc.SetBrush(wx.TRANSPARENT_BRUSH)
|
|
dc.DrawRoundedRectangle(0, 0, size.x, size.y-1, 12)
|
|
|
|
|
|
def OnErase(self, event):
|
|
"""
|
|
Handles the ``wx.EVT_ERASE_BACKGROUND`` event for :class:`PyInfoFrame`.
|
|
|
|
:param `event`: a :class:`EraseEvent` event to be processed.
|
|
|
|
:note: This method is intentionally empty to reduce flicker.
|
|
"""
|
|
|
|
# This is empty on purpose, to avoid flickering
|
|
pass
|
|
|
|
|
|
# -------------------------------------------------------------------- #
|
|
# The actual PyBusyInfo implementation
|
|
# -------------------------------------------------------------------- #
|
|
|
|
class PyBusyInfo(object):
|
|
"""
|
|
Constructs a busy info window as child of parent and displays a message in it.
|
|
"""
|
|
|
|
def __init__(self, message, parent=None, title=_("Busy"), icon=wx.NullBitmap):
|
|
"""
|
|
Default class constructor.
|
|
|
|
:param `parent`: the :class:`PyBusyInfo` parent;
|
|
:param `message`: the message to display in the :class:`PyBusyInfo`;
|
|
:param `title`: the main :class:`PyBusyInfo` title;
|
|
:param `icon`: an icon to draw as the frame icon, an instance of :class:`Bitmap`.
|
|
|
|
:note: If `parent` is not ``None`` you must ensure that it is not closed
|
|
while the busy info is shown.
|
|
"""
|
|
|
|
self._infoFrame = PyInfoFrame(parent, message, title, icon)
|
|
|
|
if parent and parent.HasFlag(wx.STAY_ON_TOP):
|
|
# we must have this flag to be in front of our parent if it has it
|
|
self._infoFrame.SetWindowStyleFlag(wx.STAY_ON_TOP)
|
|
|
|
# Added for the screenshot-taking tool
|
|
self.Show()
|
|
|
|
|
|
def __del__(self):
|
|
""" Overloaded method, for compatibility with wxWidgets. """
|
|
|
|
self._infoFrame.Show(False)
|
|
self._infoFrame.Destroy()
|
|
|
|
|
|
def Show(self, show=True):
|
|
"""
|
|
Shows or hides the window.
|
|
|
|
You may need to call `Raise` for a top level window if you want to bring it to
|
|
top, although this is not needed if :meth:`PyBusyInfo.Show` is called immediately after the frame creation.
|
|
|
|
:param bool `show`: ``True`` to show the :class:`PyBusyInfo` frame, ``False`` to hide it.
|
|
|
|
:return: ``True`` if the window has been shown or hidden or ``False`` if nothing was done
|
|
because it already was in the requested state.
|
|
|
|
.. note::
|
|
|
|
Notice that the default state of newly created top level windows is hidden (to allow
|
|
you to create their contents without flicker) unlike for all the other, not derived from
|
|
:class:`TopLevelWindow`, windows that are by default created in the shown state.
|
|
|
|
|
|
.. versionadded:: 0.9.5
|
|
"""
|
|
|
|
retVal = self._infoFrame.Show(show)
|
|
|
|
if show:
|
|
self._infoFrame.Refresh()
|
|
self._infoFrame.Update()
|
|
|
|
return retVal
|
|
|
|
|
|
def Update(self):
|
|
"""
|
|
Calling this method immediately repaints the invalidated area of the window and all of its
|
|
children recursively (this normally only happens when the flow of control returns to the
|
|
event loop).
|
|
|
|
:note: Notice that this function doesn't invalidate any area of the window so nothing happens
|
|
if nothing has been invalidated (i.e. marked as requiring a redraw). Use `Refresh` first if
|
|
you want to immediately redraw the window unconditionally.
|
|
|
|
.. versionadded:: 0.9.5
|
|
"""
|
|
|
|
self._infoFrame.Update()
|
|
|
|
|
|
if __name__ == '__main__':
|
|
|
|
import wx
|
|
|
|
class MyFrame(wx.Frame):
|
|
|
|
def __init__(self, parent):
|
|
|
|
wx.Frame.__init__(self, parent, -1, "PyBusyInfo Demo")
|
|
|
|
panel = wx.Panel(self)
|
|
|
|
b = wx.Button(panel, -1, "Test PyBusyInfo ", (50,50))
|
|
self.Bind(wx.EVT_BUTTON, self.OnButton, b)
|
|
|
|
|
|
def OnButton(self, event):
|
|
|
|
message = "Please wait 5 seconds, working..."
|
|
busy = PyBusyInfo(message, parent=self, title="Really Busy")
|
|
|
|
wx.Yield()
|
|
|
|
for indx in range(5):
|
|
wx.MilliSleep(1000)
|
|
|
|
del busy
|
|
|
|
|
|
# our normal wxApp-derived class, as usual
|
|
|
|
app = wx.App(0)
|
|
|
|
frame = MyFrame(None)
|
|
app.SetTopWindow(frame)
|
|
frame.Show()
|
|
|
|
app.MainLoop()
|
|
|