wxPython 4.3.2__cp315-cp315-win_amd64.whl

wx/lib/art/img2pyartprov.py

@@ -0,0 +1,56 @@
+#-----------------------------------------------------------------------------
+# Name:        img2pyartprov.py
+# Purpose:
+#
+# Author:      Riaan Booysen
+#
+# Copyright:   (c) 2006
+# Licence:     wxPython
+#-----------------------------------------------------------------------------
+"""ArtProvider class that publishes images from modules generated by img2py.
+
+Image modules must be generated with the -u and -n <name> parameters.
+
+Typical usage::
+    >>> import wx, wx.lib.art.img2pyartprov, myimagemodule
+    >>> wx.ArtProvider.PushProvider(wx.lib.art.img2pyartprov.Img2PyArtProvider(myimagemodule))
+
+If myimagemodule.catalog['MYIMAGE'] is defined, it can be accessed as::
+    >>> wx.ArtProvider.GetBitmap('wxART_MYIMAGE')
+
+"""
+
+import wx
+
+_NULL_BMP = wx.NullBitmap
+class Img2PyArtProvider(wx.ArtProvider):
+    def __init__(self, imageModule, artIdPrefix='wxART_'):
+        self.catalog = {}
+        self.index = []
+        self.UpdateFromImageModule(imageModule)
+        self.artIdPrefix = artIdPrefix
+
+        wx.ArtProvider.__init__(self)
+
+    def UpdateFromImageModule(self, imageModule):
+        try:
+            self.catalog.update(imageModule.catalog)
+        except AttributeError:
+            raise Exception('No catalog dictionary defined for the image module')
+
+        try:
+            self.index.extend(imageModule.index)
+        except AttributeError:
+            raise Exception('No index list defined for the image module')
+
+    def GenerateArtIdList(self):
+        return [self.artIdPrefix+name for name in self.index]
+
+    def CreateBitmap(self, artId, artClient, size):
+        if artId.startswith(self.artIdPrefix):
+            name = artId[len(self.artIdPrefix):]
+            if name in self.catalog:
+                return self.catalog[name].GetBitmap()
+
+        return _NULL_BMP
+

wx/lib/busy.py

@@ -0,0 +1,152 @@
+#---------------------------------------------------------------------------
+#  File:         busy.py
+#  Description:  A class like wx.BusyInfo but which doesn't take up so much
+#                space by default and which has a nicer look.
+#
+#  Date:         11-Sept-2012
+#  Author:       Robin Dunn
+#  Tags:         phoenix-port, unittest, documented
+#---------------------------------------------------------------------------
+
+"""
+A class like :class:`wx.BusyInfo` but which doesn't take up so much space by default
+and which has a nicer look.
+"""
+
+import sys
+import wx
+from wx.lib.stattext import GenStaticText as StaticText
+
+if sys.version_info >= (3, 11):
+    from typing import Self
+else:
+    from typing_extensions import Self
+
+#---------------------------------------------------------------------------
+
+
+class BusyInfo(object):
+    """
+    This class is just like :class:`wx.BusyInfo`, except that its default
+    size is smaller, (unless the size of the message requires a larger window
+    size) and the background and foreground colors of the message box can be
+    set.
+
+    Creating an instance of the class will create and show a window with the
+    given message, and when the instance is deleted then that window will be
+    closed. This class also implements the context manager magic methods, so
+    it can be used with Python's `with` statement, like this::
+
+        with BusyInfo('Please wait...'):
+            doSomethingThatNeedsWaiting()
+
+    """
+
+    def __init__(self, msg, parent=None, bgColour=None, fgColour=None):
+        """
+        Create a new :class:`BusyInfo`.
+
+        :param string `msg`:     a string to be displayed in the BusyInfo window.
+        :param wx.Window `parent`:  an optional window to be used as the parent of
+            the `:class:`BusyInfo`.  If given then the ``BusyInfo`` will be centered
+            over that window, otherwise it will be centered on the screen.
+        :param wx.Colour `bgColour`: colour to be used for the background
+            of the :class:`BusyInfo`
+        :param wx.Colour `fgColour`: colour to be used for the foreground (text)
+            of the :class:`BusyInfo`
+        """
+        self.frame = _InfoFrame(parent, msg, bgColour, fgColour)
+        self.frame.Show()
+        self.frame.Refresh()
+        self.frame.Update()
+
+    def __del__(self):
+        self.Close()
+
+    def Close(self):
+        """
+        Hide and close the busy info box.
+        """
+        if self.frame:
+            self.frame.Hide()
+            self.frame.Close()
+            self.frame = None
+
+
+    # Magic methods for using this class as a Context Manager
+    def __enter__(self) -> Self:
+        return self
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        self.Close()
+        return False
+
+
+#---------------------------------------------------------------------------
+
+class _InfoFrame(wx.Frame):
+    def __init__(self, parent, msg, bgColour=None, fgColour=None):
+        wx.Frame.__init__(self, parent, style=wx.BORDER_SIMPLE|wx.FRAME_TOOL_WINDOW|wx.STAY_ON_TOP)
+
+        bgColour = bgColour if bgColour is not None else wx.Colour(253, 255, 225)
+        fgColour = fgColour if fgColour is not None else wx.BLACK
+
+        panel = wx.Panel(self)
+        text = StaticText(panel, -1, msg)
+
+        for win in [panel, text]:
+            win.SetCursor(wx.HOURGLASS_CURSOR)
+            win.SetBackgroundColour(bgColour)
+            win.SetForegroundColour(fgColour)
+
+        size = text.GetBestSize()
+        self.SetClientSize((size.width + 60, size.height + 40))
+        panel.SetSize(self.GetClientSize())
+        text.Center()
+        self.Center()
+
+
+#---------------------------------------------------------------------------
+
+
+if __name__ == '__main__':
+
+    def test1(frm):
+        with BusyInfo("short message...", frm):
+            wx.Sleep(2)
+        wx.CallLater(1000, test2, frm)
+
+    def test2(frm):
+        with BusyInfo("This is my longer short message.  Please be patient...", frm):
+            wx.Sleep(2)
+            wx.CallLater(1000, test3, frm)
+
+    def test3(frm):
+        busy = BusyInfo("Without using the context manager...", frm)
+        wx.Sleep(2)
+        del busy
+        wx.CallLater(1000, test4, frm)
+
+    def test4(frm):
+        with BusyInfo("Without using the parent window..."):
+            wx.Sleep(2)
+        wx.CallLater(1000, test5, frm)
+
+    def test5(frm):
+
+        message = """A long message with line breaks:
+Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do
+eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim
+veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea
+commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit
+esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat
+cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est
+laborum."""
+        with BusyInfo(message, frm):
+            wx.Sleep(2)
+
+
+    app = wx.App(False)
+    frm = wx.Frame(None, title="BusyInfoTest")
+    wx.CallLater(1000, test1, frm)
+    frm.Show()
+    app.MainLoop()