// Name: app.h
// Purpose:
// Author: Robert Roebling
-// Created: 01/02/97
-// Id:
-// Copyright: (c) 1998 Robert Roebling, Julian Smart and Markus Holzem
+// Id: $Id$
+// Copyright: (c) 1998 Robert Roebling, Julian Smart
// Licence: wxWindows licence
/////////////////////////////////////////////////////////////////////////////
public:
- wxApp(void);
- ~wxApp(void);
+ wxApp();
+ ~wxApp();
static void SetInitializerFunction(wxAppInitializerFunction fn) { m_appInitFn = fn; }
- static wxAppInitializerFunction GetInitializerFunction(void) { return m_appInitFn; }
+ static wxAppInitializerFunction GetInitializerFunction() { return m_appInitFn; }
- virtual bool OnInit(void);
- virtual bool OnInitGui(void);
- virtual int OnRun(void);
- virtual int OnExit(void);
+ /* 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; }
+
+ virtual int OnRun() { return MainLoop(); }
+ virtual int OnExit() { return 0; }
- wxWindow *GetTopWindow(void);
+ wxWindow *GetTopWindow();
void SetTopWindow( wxWindow *win );
- virtual int MainLoop(void);
- void ExitMainLoop(void);
- bool Initialized(void);
- virtual bool Pending(void);
- virtual void Dispatch(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(void) { return m_wantDebugOutput; }
+ inline void SetWantDebugOutput( bool flag ) { m_wantDebugOutput = flag; }
+ inline bool GetWantDebugOutput() { return m_wantDebugOutput; }
void OnIdle( wxIdleEvent &event );
- bool SendIdleEvents(void);
+ bool SendIdleEvents();
bool SendIdleEvents( wxWindow* win );
- 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 wxString GetAppName() const
+ { if (m_appName != "") return m_appName; else return m_className; }
+ inline void SetAppName( const wxString& name ) { m_appName = name; }
+
+ inline wxString GetClassName() const { return m_className; }
+ inline void SetClassName( const wxString& name ) { m_className = name; }
+
const wxString& GetVendorName() const { return m_vendorName; }
- void SetVendorName(const wxString& name) { m_vendorName = name; }
+ void SetVendorName( const wxString& name ) { m_vendorName = name; }
- inline void SetExitOnFrameDelete(bool flag) { m_exitOnFrameDelete = flag; }
- inline bool GetExitOnFrameDelete(void) const { return m_exitOnFrameDelete; }
+ inline void SetExitOnFrameDelete( bool flag ) { m_exitOnFrameDelete = flag; }
+ inline bool GetExitOnFrameDelete() const { return m_exitOnFrameDelete; }
- void SetPrintMode(int WXUNUSED(mode) ) {};
- int GetPrintMode(void) const { return wxPRINT_POSTSCRIPT; };
+ 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)
+ /* override this function to create default log target of arbitrary
+ * user-defined classv (default implementation creates a wxLogGui object) */
virtual wxLog *CreateLogTarget();
- // GTK implementation
+ // implementation
- static void CommonInit(void);
- static void CommonCleanUp(void);
+ static bool Initialize();
+ static bool InitialzeVisual();
+ static void CleanUp();
- bool ProcessIdle(void);
- void DeletePendingObjects(void);
+ bool ProcessIdle();
+#if wxUSE_THREADS
+ void ProcessPendingEvents();
+#endif
+ void DeletePendingObjects();
- bool m_initialized;
- bool m_exitOnFrameDelete;
- bool m_wantDebugOutput;
- wxWindow *m_topWindow;
+ /// 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; }
+
+ bool m_initialized;
+ bool m_exitOnFrameDelete;
+ bool m_wantDebugOutput;
+ wxWindow *m_topWindow;
- gint m_idleTag;
+ gint m_idleTag;
+ unsigned char *m_colorCube;
- int argc;
- char **argv;
+ int argc;
+ char **argv;
- static wxAppInitializerFunction m_appInitFn;
-
-private:
- wxString m_vendorName,
- m_appName,
- m_className;
+ 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()
};