// 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__
#pragma interface
#endif
+#include "wx/defs.h"
#include "wx/window.h"
#include "wx/frame.h"
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;
+ 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__