synchronize GTK2 minimum version in docs

[wxWidgets.git] / interface / wx / evtloop.h

diff --git a/interface/wx/evtloop.h b/interface/wx/evtloop.h
index 659a6b964e2e8aedbd6e1e3e4a2bf3c1afafadfb..4e42be0dc46f8b819890e0fc58fb9c59040ecf28 100644 (file)
--- a/interface/wx/evtloop.h
+++ b/interface/wx/evtloop.h
@@ -4,7 +4,7 @@
 // Author:      Vadim Zeitlin
 // Copyright:   (C) 2008 Vadim Zeitlin
 // RCS-ID:      $Id$
 // Author:      Vadim Zeitlin
 // Copyright:   (C) 2008 Vadim Zeitlin
 // RCS-ID:      $Id$

-// Licence:     wxWindows license
+// Licence:     wxWindows licence

 /////////////////////////////////////////////////////////////////////////////
 
 /**
 /////////////////////////////////////////////////////////////////////////////
 
 /**


@@ -12,8 +12,16 @@
 
     Base class for all event loop implementations.
 
 
     Base class for all event loop implementations.
 

+    An event loop is a class which queries the queue of native events sent
+    to the wxWidgets application and dispatches them to the appropriate
+    wxEvtHandlers.
+

     An object of this class is created by wxAppTraits::CreateEventLoop() and
     used by wxApp to run the main application event loop.
     An object of this class is created by wxAppTraits::CreateEventLoop() and
     used by wxApp to run the main application event loop.

+    Temporary event loops are usually created by wxDialog::ShowModal().
+
+    You can create your own event loop if you need, provided that you restore
+    the main event loop once yours is destroyed (see wxEventLoopActivator).

 
     @library{wxbase}
     @category{appmanagement}
 
     @library{wxbase}
     @category{appmanagement}


@@ -37,9 +45,16 @@ public:
         Called by wxEventLoopActivator, use an instance of this class instead
         of calling this method directly to ensure that the previously active
         event loop is restored.
         Called by wxEventLoopActivator, use an instance of this class instead
         of calling this method directly to ensure that the previously active
         event loop is restored.

+
+        Results in a call to wxAppConsole::OnEventLoopEnter.

      */
     static void SetActive(wxEventLoopBase* loop);
 
      */
     static void SetActive(wxEventLoopBase* loop);
 

+    /**
+        Returns @true if this is the main loop executed by wxApp::OnRun().
+    */
+    bool IsMain() const;
+

 
     /**
         @name Dispatch and processing
 
     /**
         @name Dispatch and processing


@@ -131,41 +146,6 @@ public:
     //@}
 
 
     //@}
 
 

-    /**
-        @name Pending events
-    */
-    //@{
-
-    /**
-        Process all pending events; it is necessary to call this function to
-        process posted events.
-
-        This happens during each event loop iteration in GUI mode but
-        it may be also called directly.
-    */
-    virtual void ProcessPendingEvents();
-
-    /**
-        Returns @true if there are pending events on the internal pending event list.
-    */
-    bool HasPendingEvents() const;
-
-    /**
-        Temporary suspends processing of the pending events.
-
-        @see ResumeProcessingOfPendingEvents()
-    */
-    void SuspendProcessingOfPendingEvents();
-
-    /**
-        Resume processing of the pending events previously stopped because of a
-        call to SuspendProcessingOfPendingEvents().
-    */
-    void ResumeProcessingOfPendingEvents();
-
-    //@}
-
-

     /**
         @name Idle handling
     */
     /**
         @name Idle handling
     */


@@ -193,7 +173,7 @@ public:
     //@{
 
     /**
     //@{
 
     /**

-        Returns @true if called from inside Yield().
+        Returns @true if called from inside Yield() or from inside YieldFor().

     */
     virtual bool IsYielding() const;
 
     */
     virtual bool IsYielding() const;
 


@@ -261,7 +241,7 @@ protected:
         happens normally (because of Exit() call) or abnormally (because of an
         exception thrown from inside the loop).
 
         happens normally (because of Exit() call) or abnormally (because of an
         exception thrown from inside the loop).
 

-        Default version does nothing.
+        The default implementation calls wxAppConsole::OnEventLoopExit.

      */
     virtual void OnExit();
 };
      */
     virtual void OnExit();
 };


@@ -306,3 +286,20 @@ public:
      */
     ~wxEventLoopActivator();
 };
      */
     ~wxEventLoopActivator();
 };

+
+/**
+    @class wxGUIEventLoop
+
+    A generic implementation of the GUI event loop.
+    
+    @library{wxbase}
+    @category{appmanagement}
+*/
+class wxGUIEventLoop : public wxEventLoopBase
+{
+public:
+    wxGUIEventLoop();
+    virtual ~wxGUIEventLoop();
+};
+
+