X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/c801d85f158c4cba50b588807daabdcbd0ed3853..238d735dc2db6fc2c64ed48ceba2d00a85c4b273:/include/wx/gtk1/app.h

diff --git a/include/wx/gtk1/app.h b/include/wx/gtk1/app.h
index 11af9c4903..03b53e2440 100644
--- a/include/wx/gtk1/app.h
+++ b/include/wx/gtk1/app.h
@@ -2,10 +2,9 @@
 // Name:        app.h
 // Purpose:
 // Author:      Robert Roebling
-// Created:     01/02/97
-// Id:
-// Copyright:   (c) 1998 Robert Roebling, Julian Smart and Markus Holzem
-// Licence:   	wxWindows licence
+// Id:          $Id$
+// Copyright:   (c) 1998 Robert Roebling, Julian Smart
+// Licence:     wxWindows licence
 /////////////////////////////////////////////////////////////////////////////
 
 #ifndef __GTKAPPH__
@@ -15,6 +14,7 @@
 #pragma interface
 #endif
 
+#include "wx/defs.h"
 #include "wx/window.h"
 #include "wx/frame.h"
 
@@ -54,60 +54,99 @@ class wxApp: public wxEvtHandler
   DECLARE_DYNAMIC_CLASS(wxApp)
 
   public:
-  
-    wxApp(void);
-    ~wxApp(void);
-    
+
+    wxApp();
+    ~wxApp();
+
     static void SetInitializerFunction(wxAppInitializerFunction fn) { m_appInitFn = fn; }
-    static wxAppInitializerFunction GetInitializerFunction(void) { return m_appInitFn; }
-    virtual bool OnInit(void);
-    virtual bool OnInitGui(void);
-    virtual int OnRun(void);
-    virtual bool OnIdle(void);
-    virtual int OnExit(void);
+    static wxAppInitializerFunction GetInitializerFunction() { return m_appInitFn; }
+
+    /* override for altering the way wxGTK intializes the GUI (palette/visual/colorcube).
+     * under wxMSW, OnInitGui() does nothing by default. when overriding this method,
+     * the code in it is likely to be platform dependent, otherwise use OnInit(). */
+    virtual bool OnInitGui();
+    
+    /* override to create top level frame, display splash screen etc. */
+    virtual bool OnInit() { return FALSE; }
     
-    wxWindow *GetTopWindow(void);
+    virtual int OnRun() { return MainLoop(); }
+    virtual int OnExit() { return 0; }
+
+    wxWindow *GetTopWindow();
     void SetTopWindow( wxWindow *win );
-    virtual int MainLoop(void);
-    void ExitMainLoop(void);
-    bool Initialized(void);
-    virtual bool Pending(void);
-    virtual void Dispatch(void);
-    void DeletePendingObjects(void);
     
-    inline wxString GetAppName(void) const {
-      if (m_appName != "")
-        return m_appName;
-      else return m_className;
-    }
-    inline void SetAppName(const wxString& name) { m_appName = name; };
-    inline wxString GetClassName(void) const { return m_className; }
-    inline void SetClassName(const wxString& name) { m_className = name; }
-
-    inline void SetExitOnFrameDelete(bool flag) { m_exitOnFrameDelete = flag; }
-    inline bool GetExitOnFrameDelete(void) const { return m_exitOnFrameDelete; }
-  
-    void SetPrintMode(int WXUNUSED(mode) ) {}; 
-    int GetPrintMode(void) const { return wxPRINT_POSTSCRIPT; };
-  
-    static void CommonInit(void);
-    static void CommonCleanUp(void);    
+    virtual int MainLoop();
+    void ExitMainLoop();
+    bool Initialized();
+    virtual bool Pending();
+    virtual void Dispatch();
+
+    inline void SetWantDebugOutput( bool flag ) { m_wantDebugOutput = flag; }
+    inline bool GetWantDebugOutput() { return m_wantDebugOutput; }
+
+    void OnIdle( wxIdleEvent &event );
+    bool SendIdleEvents();
+    bool SendIdleEvents( wxWindow* win );
+
+    inline wxString GetAppName() const 
+      { if (m_appName != "") return m_appName; else return m_className; }
+    inline void SetAppName( const wxString& name ) { m_appName = name; }
     
-    // override this function to create default log target of arbitrary
-    // user-defined classv (default implementation creates a wxLogGui object)
-    virtual wxLog *CreateLogTarget();
+    inline wxString GetClassName() const { return m_className; }
+    inline void SetClassName( const wxString& name ) { m_className = name; }
     
-    bool          m_initialized;
-    bool          m_exitOnFrameDelete;
-    gint          m_idleTag;
-    wxWindow     *m_topWindow;
-    wxString      m_appName;
-    wxString      m_className;
+    const wxString& GetVendorName() const { return m_vendorName; }
+    void SetVendorName( const wxString& name ) { m_vendorName = name; }
+
+    inline void SetExitOnFrameDelete( bool flag ) { m_exitOnFrameDelete = flag; }
+    inline bool GetExitOnFrameDelete() const { return m_exitOnFrameDelete; }
+
+    void SetPrintMode( int WXUNUSED(mode) ) {}
+    int GetPrintMode() const { return wxPRINT_POSTSCRIPT; }
+
+    /* override this function to create default log target of arbitrary
+     * user-defined classv (default implementation creates a wxLogGui object) */
+    virtual wxLog *CreateLogTarget();
+
+  // implementation 
+
+    static bool Initialize();
+    static bool InitialzeVisual();
+    static void CleanUp();
+
+    bool ProcessIdle();
+#if wxUSE_THREADS
+    void ProcessPendingEvents();
+#endif
+    void DeletePendingObjects();
+
+    /// This can be used to suppress the generation of Idle events.
+    inline void SuppressIdleEvents(bool arg = TRUE) { m_suppressIdleEvents = arg; }
+    inline bool GetSuppressIdleEvents() const { return m_suppressIdleEvents; }
     
-    int         argc;
-    char      **argv;
+    bool            m_initialized;
+    bool            m_exitOnFrameDelete;
+    bool            m_wantDebugOutput;
+    wxWindow       *m_topWindow;
     
+    gint            m_idleTag;
+#if wxUSE_THREADS
+    gint            m_wakeUpTimerTag;
+#endif
+    unsigned char  *m_colorCube;
+
+    int             argc;
+    char          **argv;
+
+    wxString        m_vendorName;
+    wxString        m_appName;
+    wxString        m_className;
+
     static wxAppInitializerFunction m_appInitFn;
+ private:
+    /// Set to TRUE while we are in wxYield().
+    bool m_suppressIdleEvents;
+  DECLARE_EVENT_TABLE()
 };
 
 #endif // __GTKAPPH__