]> git.saurik.com Git - wxWidgets.git/blame_incremental - include/wx/msw/app.h
Corrected memory.cpp checkpoint bug; added Tex2RTF
[wxWidgets.git] / include / wx / msw / app.h
... / ...
CommitLineData
1/////////////////////////////////////////////////////////////////////////////
2// Name: app.h
3// Purpose: wxApp class
4// Author: Julian Smart
5// Modified by:
6// Created: 01/02/97
7// RCS-ID: $Id$
8// Copyright: (c) Julian Smart
9// Licence: wxWindows licence
10/////////////////////////////////////////////////////////////////////////////
11
12#ifndef _WX_APP_H_
13#define _WX_APP_H_
14
15#ifdef __GNUG__
16#pragma interface "app.h"
17#endif
18
19#include "wx/defs.h"
20#include "wx/object.h"
21
22class WXDLLEXPORT wxFrame;
23class WXDLLEXPORT wxWindow;
24class WXDLLEXPORT wxApp ;
25class WXDLLEXPORT wxKeyEvent;
26class WXDLLEXPORT wxLog;
27
28#define wxPRINT_WINDOWS 1
29#define wxPRINT_POSTSCRIPT 2
30
31WXDLLEXPORT_DATA(extern wxApp*) wxTheApp;
32
33// Force an exit from main loop
34void WXDLLEXPORT wxExit();
35
36// Yield to other apps/messages
37bool WXDLLEXPORT wxYield();
38
39// Represents the application. Derive OnInit and declare
40// a new App object to start application
41class WXDLLEXPORT wxApp: public wxEvtHandler
42{
43 DECLARE_DYNAMIC_CLASS(wxApp)
44 wxApp();
45 ~wxApp();
46
47 static void SetInitializerFunction(wxAppInitializerFunction fn) { m_appInitFn = fn; }
48 static wxAppInitializerFunction GetInitializerFunction() { return m_appInitFn; }
49
50 virtual int MainLoop();
51 void ExitMainLoop();
52 bool Initialized();
53 virtual bool Pending() ;
54 virtual void Dispatch() ;
55
56 void OnIdle(wxIdleEvent& event);
57 void OnEndSession(wxCloseEvent& event);
58 void OnQueryEndSession(wxCloseEvent& event);
59
60 // Generic
61 virtual bool OnInit() { return FALSE; };
62
63 // No specific tasks to do here.
64 virtual bool OnInitGui() { return TRUE; }
65
66 // Called to set off the main loop
67 virtual int OnRun() { return MainLoop(); };
68 virtual int OnExit() { return 0; }
69
70 // called when a fatal exception occurs, this function should take care not
71 // to do anything which might provoke a nested exception!
72 virtual void OnFatalException() { }
73
74 inline void SetPrintMode(int mode) { m_printMode = mode; }
75 inline int GetPrintMode() const { return m_printMode; }
76
77 inline void SetExitOnFrameDelete(bool flag) { m_exitOnFrameDelete = flag; }
78 inline bool GetExitOnFrameDelete() const { return m_exitOnFrameDelete; }
79
80 inline wxString GetAppName() const {
81 if (m_appName != "")
82 return m_appName;
83 else return m_className;
84 }
85
86 inline void SetAppName(const wxString& name) { m_appName = name; };
87 inline wxString GetClassName() const { return m_className; }
88 inline void SetClassName(const wxString& name) { m_className = name; }
89
90 void SetVendorName(const wxString& vendorName) { m_vendorName = vendorName; }
91 const wxString& GetVendorName() const { return m_vendorName; }
92
93 wxWindow *GetTopWindow() const ;
94 inline void SetTopWindow(wxWindow *win) { m_topWindow = win; }
95
96 inline void SetWantDebugOutput(bool flag) { m_wantDebugOutput = flag; }
97 inline bool GetWantDebugOutput() { return m_wantDebugOutput; }
98
99 // Send idle event to all top-level windows.
100 // Returns TRUE if more idle time is requested.
101 bool SendIdleEvents();
102
103 // Send idle event to window and all subwindows
104 // Returns TRUE if more idle time is requested.
105 bool SendIdleEvents(wxWindow* win);
106
107 inline void SetAuto3D(bool flag) { m_auto3D = flag; }
108 inline bool GetAuto3D() const { return m_auto3D; }
109
110 // Creates a log object
111 virtual wxLog* CreateLogTarget();
112
113public:
114// void (*work_proc)(wxApp*app); // work procedure;
115 int argc;
116 char ** argv;
117
118protected:
119 bool m_wantDebugOutput ;
120 wxString m_className;
121 wxString m_appName,
122 m_vendorName;
123 wxWindow * m_topWindow;
124 bool m_exitOnFrameDelete;
125 bool m_showOnInit;
126 int m_printMode; // wxPRINT_WINDOWS, wxPRINT_POSTSCRIPT
127 bool m_auto3D ; // Always use 3D controls, except
128 // where overriden
129 static wxAppInitializerFunction m_appInitFn;
130
131/* Windows-specific wxApp definitions */
132
133public:
134
135 // Implementation
136 static bool Initialize();
137 static void CleanUp();
138
139 static bool RegisterWindowClasses();
140 // Convert Windows to argc, argv style
141 void ConvertToStandardCommandArgs(char* p);
142 virtual bool DoMessage();
143 virtual bool ProcessMessage(WXMSG* pMsg);
144 void DeletePendingObjects();
145 bool ProcessIdle();
146 int GetComCtl32Version() const;
147
148public:
149 static long sm_lastMessageTime;
150 int m_nCmdShow;
151
152protected:
153 bool m_keepGoing ;
154
155DECLARE_EVENT_TABLE()
156};
157
158#if !defined(_WINDLL) || (defined(_WINDLL) && defined(WXMAKINGDLL))
159int WXDLLEXPORT wxEntry(WXHINSTANCE hInstance, WXHINSTANCE hPrevInstance, char *lpszCmdLine,
160 int nCmdShow, bool enterLoop = TRUE);
161#else
162int WXDLLEXPORT wxEntry(WXHINSTANCE hInstance);
163#endif
164
165#endif
166 // _WX_APP_H_
167