From e09838afc4370986b533462791c950d426caf9de Mon Sep 17 00:00:00 2001
From: Robin Dunn <robin@alldunn.com>
Date: Wed, 7 May 2003 00:57:59 +0000
Subject: [PATCH] Added wxFutureCall, a subclass of wxTimer that makes it easy
 to delay a call to any Python callable object.

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/branches/WX_2_4_BRANCH@20518 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
---
 wxPython/CHANGES.txt    |  2 ++
 wxPython/src/_extras.py | 71 +++++++++++++++++++++++++++++++++++++++--
 2 files changed, 71 insertions(+), 2 deletions(-)

diff --git a/wxPython/CHANGES.txt b/wxPython/CHANGES.txt
index c88ee3dd9d..166e86756b 100644
--- a/wxPython/CHANGES.txt
+++ b/wxPython/CHANGES.txt
@@ -459,6 +459,8 @@ Added wxTreeListCtrl.  (Looks like a wxTreeCtrl embedded in a
 wxListCtrl, but actually is just giving multiple columns to a
 wxTreeCtrl.)
 
+Added wxFutureCall, a subclass of wxTimer that makes it easy to delay
+a call to any Python callable object.
 
 
 
diff --git a/wxPython/src/_extras.py b/wxPython/src/_extras.py
index 3f3012a92d..0d8bb93bb9 100644
--- a/wxPython/src/_extras.py
+++ b/wxPython/src/_extras.py
@@ -744,8 +744,63 @@ def wxCallAfter(callable, *args, **kw):
     evt.kw = kw
     wxPostEvent(app, evt)
 
-# an alias
-wxRunLater = wxCallAfter
+
+#----------------------------------------------------------------------
+
+class wxFutureCall(wxTimer):
+    """
+    A convenience class for wxTimer, that calls the given callable
+    object once after the given amount of milliseconds, passing any
+    positional or keyword args.  The return value of the callable is
+    availbale after it has been run with the GetResult method.
+    """
+    def __init__(self, millis, callable, *args, **kwargs):
+        wxTimer.__init__(self)
+        self.millis = millis
+        self.callable = callable
+        self.SetArgs(*args, **kwargs)
+        self.runCount = 0
+        self.hasRun = False
+        self.result = None
+        self.Start(self.millis, wxTIMER_ONE_SHOT)
+
+    def __del__(self):
+        self.Stop()
+        wxTimer.__del__(self)
+
+    def Restart(self, millis=None):
+        """
+        Restart the timer with the same duration as before.
+        """
+        self.hasRun = False
+        if millis is not None:
+            self.millis = millis
+        self.Start(self.millis, wxTIMER_ONE_SHOT)
+
+    def SetArgs(self, *args, **kwargs):
+        """
+        (Re)set the args passed to the callable object.  This is
+        useful in conjunction with Restart if you want to schedule a
+        new call to the same callable object but with different
+        parameters.
+        """
+        self.args = args
+        self.kwargs = kwargs
+
+    def HasRun(self):
+        return self.hasRun
+
+    def GetResult(self):
+        return self.result
+
+    def Notify(self):
+        """
+        The timer has expired so call the callable.
+        """
+        if self.callable and getattr(self.callable, 'im_self', True):
+            self.runCount += 1
+            self.result = self.callable(*self.args, **self.kwargs)
+        self.hasRun = True
 
 #----------------------------------------------------------------------
 
@@ -858,6 +913,18 @@ class wxApp(wxPyApp):
 
     def __init__(self, redirect=_defRedirect, filename=None, useBestVisual=False):
         wxPyApp.__init__(self)
+
+        if wx.wxPlatform == "__WXMAC__":
+            try:
+                import MacOS
+                if not MacOS.WMAvailable():
+                    print """This program needs access to the screen. Please run with
+'pythonw', not 'python', and only when you are logged in on the main display
+of your Mac."""
+                    sys.exit(1)
+            except:
+                pass
+
         self.stdioWin = None
         self.saveStdio = (sys.stdout, sys.stderr)