]>
Commit | Line | Data |
---|---|---|
c801d85f | 1 | ///////////////////////////////////////////////////////////////////////////// |
090a6d7a | 2 | // Name: wx/app.h |
094637f6 VZ |
3 | // Purpose: wxAppBase class and macros used for declaration of wxApp |
4 | // derived class in the user code | |
c801d85f KB |
5 | // Author: Julian Smart |
6 | // Modified by: | |
7 | // Created: 01/02/97 | |
8 | // RCS-ID: $Id$ | |
371a5b4e | 9 | // Copyright: (c) Julian Smart |
65571936 | 10 | // Licence: wxWindows licence |
c801d85f KB |
11 | ///////////////////////////////////////////////////////////////////////////// |
12 | ||
34138703 JS |
13 | #ifndef _WX_APP_H_BASE_ |
14 | #define _WX_APP_H_BASE_ | |
c801d85f | 15 | |
23280650 VZ |
16 | // ---------------------------------------------------------------------------- |
17 | // headers we have to include here | |
18 | // ---------------------------------------------------------------------------- | |
19 | ||
20 | #include "wx/event.h" // for the base class | |
090a6d7a | 21 | #include "wx/build.h" |
541ea80f | 22 | #include "wx/cmdargs.h" // for wxCmdLineArgsArray used by wxApp::argv |
0fcbaf23 | 23 | #include "wx/init.h" // we must declare wxEntry() |
5ff14574 | 24 | #include "wx/intl.h" // for wxLayoutDirection |
090a6d7a | 25 | |
b5dbe15d VS |
26 | class WXDLLIMPEXP_FWD_BASE wxAppConsole; |
27 | class WXDLLIMPEXP_FWD_BASE wxAppTraits; | |
28 | class WXDLLIMPEXP_FWD_BASE wxCmdLineParser; | |
29 | class WXDLLIMPEXP_FWD_BASE wxEventLoopBase; | |
30 | class WXDLLIMPEXP_FWD_BASE wxLog; | |
31 | class WXDLLIMPEXP_FWD_BASE wxMessageOutput; | |
a69be60b | 32 | |
4d90072c | 33 | #if wxUSE_GUI |
4ec80a59 | 34 | struct WXDLLIMPEXP_FWD_CORE wxVideoMode; |
fb761cd5 | 35 | #endif |
1bf77ee5 | 36 | |
53c9228e VZ |
37 | // ---------------------------------------------------------------------------- |
38 | // typedefs | |
39 | // ---------------------------------------------------------------------------- | |
40 | ||
41 | // the type of the function used to create a wxApp object on program start up | |
e8e1149b | 42 | typedef wxAppConsole* (*wxAppInitializerFunction)(); |
53c9228e | 43 | |
094637f6 VZ |
44 | // ---------------------------------------------------------------------------- |
45 | // constants | |
46 | // ---------------------------------------------------------------------------- | |
47 | ||
e2478fde VZ |
48 | enum |
49 | { | |
50 | wxPRINT_WINDOWS = 1, | |
51 | wxPRINT_POSTSCRIPT = 2 | |
52 | }; | |
094637f6 VZ |
53 | |
54 | // ---------------------------------------------------------------------------- | |
e0954e72 | 55 | // wxAppConsoleBase: wxApp for non-GUI applications |
094637f6 VZ |
56 | // ---------------------------------------------------------------------------- |
57 | ||
e0954e72 | 58 | class WXDLLIMPEXP_BASE wxAppConsoleBase : public wxEvtHandler |
094637f6 VZ |
59 | { |
60 | public: | |
e2478fde | 61 | // ctor and dtor |
e0954e72 VZ |
62 | wxAppConsoleBase(); |
63 | virtual ~wxAppConsoleBase(); | |
e2478fde | 64 | |
1e6feb95 | 65 | |
094637f6 VZ |
66 | // the virtual functions which may/must be overridden in the derived class |
67 | // ----------------------------------------------------------------------- | |
bf188f1a | 68 | |
94826170 VZ |
69 | // This is the very first function called for a newly created wxApp object, |
70 | // it is used by the library to do the global initialization. If, for some | |
71 | // reason, you must override it (instead of just overriding OnInit(), as | |
72 | // usual, for app-specific initializations), do not forget to call the base | |
73 | // class version! | |
05e2b077 | 74 | virtual bool Initialize(int& argc, wxChar **argv); |
94826170 | 75 | |
7fbc89bb DE |
76 | // This gives wxCocoa a chance to call OnInit() with a memory pool in place |
77 | virtual bool CallOnInit() { return OnInit(); } | |
78 | ||
e2478fde VZ |
79 | // Called before OnRun(), this is a good place to do initialization -- if |
80 | // anything fails, return false from here to prevent the program from | |
81 | // continuing. The command line is normally parsed here, call the base | |
82 | // class OnInit() to do it. | |
bf188f1a | 83 | virtual bool OnInit(); |
094637f6 | 84 | |
87b6002d | 85 | // this is here only temporary hopefully (FIXME) |
94826170 VZ |
86 | virtual bool OnInitGui() { return true; } |
87 | ||
e2478fde VZ |
88 | // This is the replacement for the normal main(): all program work should |
89 | // be done here. When OnRun() returns, the programs starts shutting down. | |
b46b1d59 | 90 | virtual int OnRun(); |
094637f6 | 91 | |
e2478fde VZ |
92 | // This is only called if OnInit() returned true so it's a good place to do |
93 | // any cleanup matching the initializations done there. | |
7beba2fc | 94 | virtual int OnExit(); |
094637f6 | 95 | |
94826170 VZ |
96 | // This is the very last function called on wxApp object before it is |
97 | // destroyed. If you override it (instead of overriding OnExit() as usual) | |
98 | // do not forget to call the base class version! | |
99 | virtual void CleanUp(); | |
100 | ||
e2478fde VZ |
101 | // Called when a fatal exception occurs, this function should take care not |
102 | // to do anything which might provoke a nested exception! It may be | |
103 | // overridden if you wish to react somehow in non-default way (core dump | |
104 | // under Unix, application crash under Windows) to fatal program errors, | |
105 | // however extreme care should be taken if you don't want this function to | |
106 | // crash. | |
094637f6 VZ |
107 | virtual void OnFatalException() { } |
108 | ||
e2478fde VZ |
109 | // Called from wxExit() function, should terminate the application a.s.a.p. |
110 | virtual void Exit(); | |
b137e493 | 111 | |
094637f6 VZ |
112 | |
113 | // application info: name, description, vendor | |
114 | // ------------------------------------------- | |
115 | ||
116 | // NB: all these should be set by the application itself, there are no | |
117 | // reasonable default except for the application name which is taken to | |
118 | // be argv[0] | |
119 | ||
120 | // set/get the application name | |
121 | wxString GetAppName() const | |
122 | { | |
e2478fde | 123 | return m_appName.empty() ? m_className : m_appName; |
094637f6 VZ |
124 | } |
125 | void SetAppName(const wxString& name) { m_appName = name; } | |
126 | ||
9cf3d218 VZ |
127 | // set/get the application display name: the display name is the name |
128 | // shown to the user in titles, reports, etc while the app name is | |
129 | // used for paths, config, and other places the user doesn't see | |
130 | // | |
131 | // so the app name could be myapp while display name could be "My App" | |
132 | wxString GetAppDisplayName() const | |
133 | { | |
328fafa1 VZ |
134 | return m_appDisplayName.empty() ? GetAppName().Capitalize() |
135 | : m_appDisplayName; | |
9cf3d218 | 136 | } |
328fafa1 | 137 | |
9cf3d218 VZ |
138 | void SetAppDisplayName(const wxString& name) { m_appDisplayName = name; } |
139 | ||
094637f6 VZ |
140 | // set/get the app class name |
141 | wxString GetClassName() const { return m_className; } | |
142 | void SetClassName(const wxString& name) { m_className = name; } | |
143 | ||
144 | // set/get the vendor name | |
145 | const wxString& GetVendorName() const { return m_vendorName; } | |
146 | void SetVendorName(const wxString& name) { m_vendorName = name; } | |
147 | ||
180b5b48 VZ |
148 | // set/get the vendor display name: the display name is shown |
149 | // in titles/reports/dialogs to the user, while the vendor name | |
150 | // is used in some areas such as wxConfig, wxStandardPaths, etc | |
151 | const wxString& GetVendorDisplayName() const | |
152 | { | |
153 | return m_vendorDisplayName.empty() ? GetVendorName() | |
154 | : m_vendorDisplayName; | |
155 | } | |
156 | void SetVendorDisplayName(const wxString& name) | |
157 | { | |
158 | m_vendorDisplayName = name; | |
159 | } | |
160 | ||
e90c1d2a | 161 | |
bf188f1a VZ |
162 | // cmd line parsing stuff |
163 | // ---------------------- | |
164 | ||
165 | // all of these methods may be overridden in the derived class to | |
166 | // customize the command line parsing (by default only a few standard | |
167 | // options are handled) | |
168 | // | |
169 | // you also need to call wxApp::OnInit() from YourApp::OnInit() for all | |
170 | // this to work | |
171 | ||
172 | #if wxUSE_CMDLINE_PARSER | |
173 | // this one is called from OnInit() to add all supported options | |
b913d3ed VZ |
174 | // to the given parser (don't forget to call the base class version if you |
175 | // override it!) | |
bf188f1a VZ |
176 | virtual void OnInitCmdLine(wxCmdLineParser& parser); |
177 | ||
4629016d WS |
178 | // called after successfully parsing the command line, return true |
179 | // to continue and false to exit (don't forget to call the base class | |
b913d3ed | 180 | // version if you override it!) |
bf188f1a VZ |
181 | virtual bool OnCmdLineParsed(wxCmdLineParser& parser); |
182 | ||
4629016d WS |
183 | // called if "--help" option was specified, return true to continue |
184 | // and false to exit | |
bf188f1a VZ |
185 | virtual bool OnCmdLineHelp(wxCmdLineParser& parser); |
186 | ||
187 | // called if incorrect command line options were given, return | |
4629016d | 188 | // false to abort and true to continue |
bf188f1a VZ |
189 | virtual bool OnCmdLineError(wxCmdLineParser& parser); |
190 | #endif // wxUSE_CMDLINE_PARSER | |
191 | ||
e2478fde | 192 | |
094637f6 VZ |
193 | // miscellaneous customization functions |
194 | // ------------------------------------- | |
195 | ||
e2478fde VZ |
196 | // create the app traits object to which we delegate for everything which |
197 | // either should be configurable by the user (then he can change the | |
198 | // default behaviour simply by overriding CreateTraits() and returning his | |
199 | // own traits object) or which is GUI/console dependent as then wxAppTraits | |
9d55bfef | 200 | // allows us to abstract the differences behind the common facade |
e2478fde VZ |
201 | wxAppTraits *GetTraits(); |
202 | ||
96b2cbe8 VZ |
203 | // this function provides safer access to traits object than |
204 | // wxTheApp->GetTraits() during startup or termination when the global | |
205 | // application object itself may be unavailable | |
206 | // | |
207 | // of course, it still returns NULL in this case and the caller must check | |
208 | // for it | |
209 | static wxAppTraits *GetTraitsIfExists(); | |
75acb532 | 210 | |
e2478fde VZ |
211 | // event processing functions |
212 | // -------------------------- | |
094637f6 | 213 | |
9154d8cf VZ |
214 | // this method allows to filter all the events processed by the program, so |
215 | // you should try to return quickly from it to avoid slowing down the | |
216 | // program to the crawl | |
217 | // | |
218 | // return value should be -1 to continue with the normal event processing, | |
219 | // or TRUE or FALSE to stop further processing and pretend that the event | |
220 | // had been already processed or won't be processed at all, respectively | |
221 | virtual int FilterEvent(wxEvent& event); | |
222 | ||
883117d1 VZ |
223 | #if wxUSE_EXCEPTIONS |
224 | // call the specified handler on the given object with the given event | |
225 | // | |
226 | // this method only exists to allow catching the exceptions thrown by any | |
227 | // event handler, it would lead to an extra (useless) virtual function call | |
228 | // if the exceptions were not used, so it doesn't even exist in that case | |
229 | virtual void HandleEvent(wxEvtHandler *handler, | |
230 | wxEventFunction func, | |
231 | wxEvent& event) const; | |
2dc62891 VZ |
232 | |
233 | // Called when an unhandled C++ exception occurs inside OnRun(): note that | |
1663c655 VZ |
234 | // the main event loop has already terminated by now and the program will |
235 | // exit, if you need to really handle the exceptions you need to override | |
236 | // OnExceptionInMainLoop() | |
237 | virtual void OnUnhandledException(); | |
883117d1 VZ |
238 | #endif // wxUSE_EXCEPTIONS |
239 | ||
b46b1d59 VZ |
240 | // event processing functions |
241 | // -------------------------- | |
242 | ||
243 | // return true if we're running event loop, i.e. if the events can | |
244 | // (already) be dispatched | |
e0954e72 | 245 | static bool IsMainLoopRunning(); |
b46b1d59 | 246 | |
e2478fde VZ |
247 | // process all events in the wxPendingEvents list -- it is necessary to |
248 | // call this function to process posted events. This happens during each | |
249 | // event loop iteration in GUI mode but if there is no main loop, it may be | |
250 | // also called directly. | |
251 | virtual void ProcessPendingEvents(); | |
252 | ||
b46b1d59 VZ |
253 | // check if there are pending events on global pending event list |
254 | bool HasPendingEvents() const; | |
255 | ||
e2478fde VZ |
256 | // doesn't do anything in this class, just a hook for GUI wxApp |
257 | virtual bool Yield(bool WXUNUSED(onlyIfNeeded) = false) { return true; } | |
258 | ||
259 | // make sure that idle events are sent again | |
b46b1d59 VZ |
260 | virtual void WakeUpIdle(); |
261 | ||
262 | // execute the main GUI loop, the function returns when the loop ends | |
263 | virtual int MainLoop(); | |
264 | ||
265 | // exit the main GUI loop during the next iteration (i.e. it does not | |
266 | // stop the program immediately!) | |
267 | virtual void ExitMainLoop(); | |
268 | ||
269 | // returns true if there are unprocessed events in the event queue | |
270 | virtual bool Pending(); | |
e2478fde | 271 | |
b46b1d59 VZ |
272 | // process the first event in the event queue (blocks until an event |
273 | // appears if there are none currently, use Pending() if this is not | |
274 | // wanted), returns false if the event loop should stop and true | |
275 | // otherwise | |
276 | virtual bool Dispatch(); | |
9b0db452 | 277 | |
b46b1d59 VZ |
278 | // this virtual function is called when the application |
279 | // becomes idle and normally just sends wxIdleEvent to all interested | |
280 | // parties | |
281 | // | |
282 | // it should return true if more idle events are needed, false if not | |
283 | virtual bool ProcessIdle(); | |
284 | ||
285 | #if wxUSE_EXCEPTIONS | |
286 | // Function called if an uncaught exception is caught inside the main | |
287 | // event loop: it may return true to continue running the event loop or | |
288 | // false to stop it (in the latter case it may rethrow the exception as | |
289 | // well) | |
290 | virtual bool OnExceptionInMainLoop(); | |
291 | #endif // wxUSE_EXCEPTIONS | |
e2478fde | 292 | |
a5f1fd3e VZ |
293 | // debugging support |
294 | // ----------------- | |
295 | ||
3ec4a23f | 296 | #ifdef __WXDEBUG__ |
a5f1fd3e VZ |
297 | // this function is called when an assert failure occurs, the base class |
298 | // version does the normal processing (i.e. shows the usual assert failure | |
299 | // dialog box) | |
aad65f13 | 300 | // |
3ec4a23f VZ |
301 | // the arguments are the location of the failed assert (func may be empty |
302 | // if the compiler doesn't support C99 __FUNCTION__), the text of the | |
aad65f13 | 303 | // assert itself and the user-specified message |
3ec4a23f VZ |
304 | virtual void OnAssertFailure(const wxChar *file, |
305 | int line, | |
306 | const wxChar *func, | |
307 | const wxChar *cond, | |
308 | const wxChar *msg); | |
309 | ||
310 | // old version of the function without func parameter, for compatibility | |
311 | // only, override OnAssertFailure() in the new code | |
aad65f13 VZ |
312 | virtual void OnAssert(const wxChar *file, |
313 | int line, | |
314 | const wxChar *cond, | |
315 | const wxChar *msg); | |
a5f1fd3e | 316 | #endif // __WXDEBUG__ |
8030d606 | 317 | |
090a6d7a VZ |
318 | // check that the wxBuildOptions object (constructed in the application |
319 | // itself, usually the one from IMPLEMENT_APP() macro) matches the build | |
320 | // options of the library and abort if it doesn't | |
2a7c7605 VS |
321 | static bool CheckBuildOptions(const char *optionsSignature, |
322 | const char *componentName); | |
73deed44 | 323 | |
094637f6 VZ |
324 | // implementation only from now on |
325 | // ------------------------------- | |
326 | ||
327 | // helpers for dynamic wxApp construction | |
328 | static void SetInitializerFunction(wxAppInitializerFunction fn) | |
e2478fde | 329 | { ms_appInitFn = fn; } |
094637f6 | 330 | static wxAppInitializerFunction GetInitializerFunction() |
e2478fde | 331 | { return ms_appInitFn; } |
094637f6 | 332 | |
a80e5f9e VZ |
333 | // accessors for ms_appInstance field (external code might wish to modify |
334 | // it, this is why we provide a setter here as well, but you should really | |
335 | // know what you're doing if you call it), wxTheApp is usually used instead | |
336 | // of GetInstance() | |
337 | static wxAppConsole *GetInstance() { return ms_appInstance; } | |
338 | static void SetInstance(wxAppConsole *app) { ms_appInstance = app; } | |
339 | ||
72cdf4c9 | 340 | |
e2478fde | 341 | // command line arguments (public for backwards compatibility) |
541ea80f VZ |
342 | int argc; |
343 | ||
344 | // this object is implicitly convertible to either "char**" (traditional | |
345 | // type of argv parameter of main()) or to "wchar_t **" (for compatibility | |
346 | // with Unicode build in previous wx versions and because the command line | |
347 | // can, in pr | |
348 | #if wxUSE_UNICODE | |
349 | wxCmdLineArgsArray argv; | |
350 | #else | |
351 | char **argv; | |
352 | #endif | |
094637f6 | 353 | |
094637f6 | 354 | protected: |
e2478fde VZ |
355 | // the function which creates the traits object when GetTraits() needs it |
356 | // for the first time | |
357 | virtual wxAppTraits *CreateTraits(); | |
358 | ||
359 | ||
094637f6 | 360 | // function used for dynamic wxApp creation |
e2478fde | 361 | static wxAppInitializerFunction ms_appInitFn; |
094637f6 | 362 | |
a80e5f9e VZ |
363 | // the one and only global application object |
364 | static wxAppConsole *ms_appInstance; | |
365 | ||
b46b1d59 VZ |
366 | // create main loop from AppTraits or return NULL if |
367 | // there is no main loop implementation | |
2ddff00c | 368 | wxEventLoopBase *CreateMainLoop(); |
7cafd224 | 369 | |
094637f6 | 370 | // application info (must be set from the user code) |
180b5b48 VZ |
371 | wxString m_vendorName, // vendor name ("acme") |
372 | m_vendorDisplayName, // vendor display name (e.g. "ACME Inc") | |
9cf3d218 VZ |
373 | m_appName, // app name ("myapp") |
374 | m_appDisplayName, // app display name ("My Application") | |
375 | m_className; // class name | |
a69be60b | 376 | |
e2478fde VZ |
377 | // the class defining the application behaviour, NULL initially and created |
378 | // by GetTraits() when first needed | |
379 | wxAppTraits *m_traits; | |
380 | ||
b46b1d59 VZ |
381 | // the main event loop of the application (may be NULL if the loop hasn't |
382 | // been started yet or has already terminated) | |
2ddff00c | 383 | wxEventLoopBase *m_mainLoop; |
e2478fde VZ |
384 | |
385 | // the application object is a singleton anyhow, there is no sense in | |
386 | // copying it | |
e0954e72 | 387 | DECLARE_NO_COPY_CLASS(wxAppConsoleBase) |
e2478fde VZ |
388 | }; |
389 | ||
e0954e72 VZ |
390 | #if defined(__UNIX__) |
391 | #include "wx/unix/app.h" | |
392 | #else | |
4c2a8d89 VZ |
393 | // this has to be a class and not a typedef as we forward declare it |
394 | class wxAppConsole : public wxAppConsoleBase { }; | |
e0954e72 VZ |
395 | #endif |
396 | ||
e2478fde VZ |
397 | // ---------------------------------------------------------------------------- |
398 | // wxAppBase: the common part of wxApp implementations for all platforms | |
399 | // ---------------------------------------------------------------------------- | |
400 | ||
1e6feb95 | 401 | #if wxUSE_GUI |
e2478fde | 402 | |
bddd7a8d | 403 | class WXDLLIMPEXP_CORE wxAppBase : public wxAppConsole |
e2478fde VZ |
404 | { |
405 | public: | |
406 | wxAppBase(); | |
407 | virtual ~wxAppBase(); | |
408 | ||
409 | // the virtual functions which may/must be overridden in the derived class | |
410 | // ----------------------------------------------------------------------- | |
411 | ||
94826170 VZ |
412 | // very first initialization function |
413 | // | |
414 | // Override: very rarely | |
05e2b077 | 415 | virtual bool Initialize(int& argc, wxChar **argv); |
94826170 | 416 | |
e2478fde VZ |
417 | // a platform-dependent version of OnInit(): the code here is likely to |
418 | // depend on the toolkit. default version does nothing. | |
419 | // | |
420 | // Override: rarely. | |
421 | virtual bool OnInitGui(); | |
422 | ||
423 | // called to start program execution - the default version just enters | |
424 | // the main GUI loop in which events are received and processed until | |
425 | // the last window is not deleted (if GetExitOnFrameDelete) or | |
426 | // ExitMainLoop() is called. In console mode programs, the execution | |
427 | // of the program really starts here | |
428 | // | |
429 | // Override: rarely in GUI applications, always in console ones. | |
430 | virtual int OnRun(); | |
431 | ||
b913d3ed VZ |
432 | // a matching function for OnInit() |
433 | virtual int OnExit(); | |
434 | ||
94826170 VZ |
435 | // very last clean up function |
436 | // | |
437 | // Override: very rarely | |
438 | virtual void CleanUp(); | |
e2478fde VZ |
439 | |
440 | ||
441 | // the worker functions - usually not used directly by the user code | |
442 | // ----------------------------------------------------------------- | |
443 | ||
e2478fde | 444 | |
e2478fde VZ |
445 | |
446 | // process all currently pending events right now | |
447 | // | |
448 | // it is an error to call Yield() recursively unless the value of | |
4629016d | 449 | // onlyIfNeeded is true |
e2478fde VZ |
450 | // |
451 | // WARNING: this function is dangerous as it can lead to unexpected | |
452 | // reentrancies (i.e. when called from an event handler it | |
453 | // may result in calling the same event handler again), use | |
454 | // with _extreme_ care or, better, don't use at all! | |
4629016d | 455 | virtual bool Yield(bool onlyIfNeeded = false) = 0; |
e2478fde VZ |
456 | |
457 | // this virtual function is called in the GUI mode when the application | |
458 | // becomes idle and normally just sends wxIdleEvent to all interested | |
459 | // parties | |
460 | // | |
4629016d | 461 | // it should return true if more idle events are needed, false if not |
1bf77ee5 | 462 | virtual bool ProcessIdle(); |
e39af974 | 463 | |
e39af974 | 464 | // Send idle event to window and all subwindows |
4629016d | 465 | // Returns true if more idle time is requested. |
5109ae5d | 466 | virtual bool SendIdleEvents(wxWindow* win, wxIdleEvent& event); |
e2478fde | 467 | |
2dc62891 | 468 | |
e2478fde VZ |
469 | // top level window functions |
470 | // -------------------------- | |
471 | ||
4629016d | 472 | // return true if our app has focus |
e2478fde VZ |
473 | virtual bool IsActive() const { return m_isActive; } |
474 | ||
475 | // set the "main" top level window | |
476 | void SetTopWindow(wxWindow *win) { m_topWindow = win; } | |
477 | ||
478 | // return the "main" top level window (if it hadn't been set previously | |
479 | // with SetTopWindow(), will return just some top level window and, if | |
480 | // there are none, will return NULL) | |
5ff14574 | 481 | virtual wxWindow *GetTopWindow() const; |
e2478fde VZ |
482 | |
483 | // control the exit behaviour: by default, the program will exit the | |
484 | // main loop (and so, usually, terminate) when the last top-level | |
485 | // program window is deleted. Beware that if you disable this behaviour | |
4629016d | 486 | // (with SetExitOnFrameDelete(false)), you'll have to call |
e2478fde VZ |
487 | // ExitMainLoop() explicitly from somewhere. |
488 | void SetExitOnFrameDelete(bool flag) | |
489 | { m_exitOnFrameDelete = flag ? Yes : No; } | |
490 | bool GetExitOnFrameDelete() const | |
491 | { return m_exitOnFrameDelete == Yes; } | |
492 | ||
493 | ||
494 | // display mode, visual, printing mode, ... | |
495 | // ------------------------------------------------------------------------ | |
496 | ||
497 | // Get display mode that is used use. This is only used in framebuffer | |
b3c86150 | 498 | // wxWin ports (such as wxMGL or wxDFB). |
5ff14574 | 499 | virtual wxVideoMode GetDisplayMode() const; |
e2478fde | 500 | // Set display mode to use. This is only used in framebuffer wxWin |
b3c86150 | 501 | // ports (such as wxMGL or wxDFB). This method should be called from |
e2478fde | 502 | // wxApp::OnInitGui |
4629016d | 503 | virtual bool SetDisplayMode(const wxVideoMode& WXUNUSED(info)) { return true; } |
e2478fde VZ |
504 | |
505 | // set use of best visual flag (see below) | |
9cf3d218 | 506 | void SetUseBestVisual( bool flag, bool forceTrueColour = false ) |
515a31bf | 507 | { m_useBestVisual = flag; m_forceTrueColour = forceTrueColour; } |
e2478fde VZ |
508 | bool GetUseBestVisual() const { return m_useBestVisual; } |
509 | ||
510 | // set/get printing mode: see wxPRINT_XXX constants. | |
511 | // | |
512 | // default behaviour is the normal one for Unix: always use PostScript | |
513 | // printing. | |
514 | virtual void SetPrintMode(int WXUNUSED(mode)) { } | |
515 | int GetPrintMode() const { return wxPRINT_POSTSCRIPT; } | |
516 | ||
475a93b7 VZ |
517 | // Return the layout direction for the current locale or wxLayout_Default |
518 | // if it's unknown | |
519 | virtual wxLayoutDirection GetLayoutDirection() const; | |
520 | ||
c50c6fb2 VZ |
521 | // Change the theme used by the application, return true on success. |
522 | virtual bool SetNativeTheme(const wxString& WXUNUSED(theme)) { return false; } | |
523 | ||
e2478fde | 524 | |
b913d3ed VZ |
525 | // command line parsing (GUI-specific) |
526 | // ------------------------------------------------------------------------ | |
527 | ||
8030d606 | 528 | #if wxUSE_CMDLINE_PARSER |
b913d3ed VZ |
529 | virtual bool OnCmdLineParsed(wxCmdLineParser& parser); |
530 | virtual void OnInitCmdLine(wxCmdLineParser& parser); | |
8030d606 | 531 | #endif |
b913d3ed | 532 | |
e2478fde VZ |
533 | // miscellaneous other stuff |
534 | // ------------------------------------------------------------------------ | |
535 | ||
536 | // called by toolkit-specific code to set the app status: active (we have | |
537 | // focus) or not and also the last window which had focus before we were | |
538 | // deactivated | |
539 | virtual void SetActive(bool isActive, wxWindow *lastFocus); | |
540 | ||
40ff126a | 541 | #if WXWIN_COMPATIBILITY_2_6 |
dd435a79 VZ |
542 | // OBSOLETE: don't use, always returns true |
543 | // | |
544 | // returns true if the program is successfully initialized | |
40ff126a WS |
545 | wxDEPRECATED( bool Initialized() ); |
546 | #endif // WXWIN_COMPATIBILITY_2_6 | |
dd435a79 | 547 | |
e2478fde | 548 | protected: |
94826170 VZ |
549 | // delete all objects in wxPendingDelete list |
550 | void DeletePendingObjects(); | |
551 | ||
e2478fde VZ |
552 | // override base class method to use GUI traits |
553 | virtual wxAppTraits *CreateTraits(); | |
554 | ||
555 | ||
556 | // the main top level window (may be NULL) | |
1e6feb95 VZ |
557 | wxWindow *m_topWindow; |
558 | ||
1cbee0b4 VZ |
559 | // if Yes, exit the main loop when the last top level window is deleted, if |
560 | // No don't do it and if Later -- only do it once we reach our OnRun() | |
561 | // | |
562 | // the explanation for using this strange scheme is given in appcmn.cpp | |
563 | enum | |
564 | { | |
565 | Later = -1, | |
566 | No, | |
567 | Yes | |
568 | } m_exitOnFrameDelete; | |
1e6feb95 | 569 | |
90e572f1 | 570 | // true if the app wants to use the best visual on systems where |
8480b297 RR |
571 | // more than one are available (Sun, SGI, XFree86 4.0 ?) |
572 | bool m_useBestVisual; | |
515a31bf RR |
573 | // force TrueColour just in case "best" isn't TrueColour |
574 | bool m_forceTrueColour; | |
094637f6 | 575 | |
90e572f1 | 576 | // does any of our windows have focus? |
1e6feb95 | 577 | bool m_isActive; |
e2478fde VZ |
578 | |
579 | ||
580 | DECLARE_NO_COPY_CLASS(wxAppBase) | |
094637f6 VZ |
581 | }; |
582 | ||
40ff126a WS |
583 | #if WXWIN_COMPATIBILITY_2_6 |
584 | inline bool wxAppBase::Initialized() { return true; } | |
585 | #endif // WXWIN_COMPATIBILITY_2_6 | |
586 | ||
094637f6 VZ |
587 | // ---------------------------------------------------------------------------- |
588 | // now include the declaration of the real class | |
589 | // ---------------------------------------------------------------------------- | |
590 | ||
e0954e72 VZ |
591 | #if defined(__WXPALMOS__) |
592 | #include "wx/palmos/app.h" | |
593 | #elif defined(__WXMSW__) | |
594 | #include "wx/msw/app.h" | |
595 | #elif defined(__WXMOTIF__) | |
596 | #include "wx/motif/app.h" | |
597 | #elif defined(__WXMGL__) | |
598 | #include "wx/mgl/app.h" | |
599 | #elif defined(__WXDFB__) | |
600 | #include "wx/dfb/app.h" | |
601 | #elif defined(__WXGTK20__) | |
602 | #include "wx/gtk/app.h" | |
603 | #elif defined(__WXGTK__) | |
604 | #include "wx/gtk1/app.h" | |
605 | #elif defined(__WXX11__) | |
606 | #include "wx/x11/app.h" | |
607 | #elif defined(__WXMAC__) | |
ef0e9220 | 608 | #include "wx/osx/app.h" |
e0954e72 VZ |
609 | #elif defined(__WXCOCOA__) |
610 | #include "wx/cocoa/app.h" | |
611 | #elif defined(__WXPM__) | |
612 | #include "wx/os2/app.h" | |
613 | #endif | |
614 | ||
e90c1d2a | 615 | #else // !GUI |
e0954e72 VZ |
616 | |
617 | // wxApp is defined in core and we cannot define another one in wxBase, | |
618 | // so use the preprocessor to allow using wxApp in console programs too | |
619 | #define wxApp wxAppConsole | |
620 | ||
e90c1d2a | 621 | #endif // GUI/!GUI |
c801d85f | 622 | |
094637f6 | 623 | // ---------------------------------------------------------------------------- |
ee31c392 VZ |
624 | // the global data |
625 | // ---------------------------------------------------------------------------- | |
626 | ||
7cafd224 VZ |
627 | // for compatibility, we define this macro to access the global application |
628 | // object of type wxApp | |
629 | // | |
630 | // note that instead of using of wxTheApp in application code you should | |
631 | // consider using DECLARE_APP() after which you may call wxGetApp() which will | |
632 | // return the object of the correct type (i.e. MyApp and not wxApp) | |
633 | // | |
634 | // the cast is safe as in GUI build we only use wxApp, not wxAppConsole, and in | |
635 | // console mode it does nothing at all | |
5c33522f | 636 | #define wxTheApp static_cast<wxApp*>(wxApp::GetInstance()) |
ee31c392 VZ |
637 | |
638 | // ---------------------------------------------------------------------------- | |
639 | // global functions | |
640 | // ---------------------------------------------------------------------------- | |
641 | ||
e90c1d2a VZ |
642 | // event loop related functions only work in GUI programs |
643 | // ------------------------------------------------------ | |
644 | ||
ee31c392 | 645 | // Force an exit from main loop |
bddd7a8d | 646 | extern void WXDLLIMPEXP_BASE wxExit(); |
ee31c392 | 647 | |
a131b460 VZ |
648 | // avoid redeclaring this function here if it had been already declated by |
649 | // wx/utils.h, this results in warnings from g++ with -Wredundant-decls | |
650 | #ifndef wx_YIELD_DECLARED | |
651 | #define wx_YIELD_DECLARED | |
652 | ||
ee31c392 | 653 | // Yield to other apps/messages |
bddd7a8d | 654 | extern bool WXDLLIMPEXP_BASE wxYield(); |
e90c1d2a | 655 | |
a131b460 VZ |
656 | #endif // wx_YIELD_DECLARED |
657 | ||
bf9e3e73 | 658 | // Yield to other apps/messages |
bddd7a8d | 659 | extern void WXDLLIMPEXP_BASE wxWakeUpIdle(); |
bf9e3e73 | 660 | |
ee31c392 | 661 | // ---------------------------------------------------------------------------- |
094637f6 VZ |
662 | // macros for dynamic creation of the application object |
663 | // ---------------------------------------------------------------------------- | |
664 | ||
665 | // Having a global instance of this class allows wxApp to be aware of the app | |
666 | // creator function. wxApp can then call this function to create a new app | |
667 | // object. Convoluted, but necessary. | |
c801d85f | 668 | |
bddd7a8d | 669 | class WXDLLIMPEXP_BASE wxAppInitializer |
c801d85f KB |
670 | { |
671 | public: | |
094637f6 VZ |
672 | wxAppInitializer(wxAppInitializerFunction fn) |
673 | { wxApp::SetInitializerFunction(fn); } | |
c801d85f KB |
674 | }; |
675 | ||
956495ca VZ |
676 | // the code below defines a IMPLEMENT_WXWIN_MAIN macro which you can use if |
677 | // your compiler really, really wants main() to be in your main program (e.g. | |
678 | // hello.cpp). Now IMPLEMENT_APP should add this code if required. | |
26a87b69 | 679 | |
80b2db4e VS |
680 | #define IMPLEMENT_WXWIN_MAIN_CONSOLE \ |
681 | int main(int argc, char **argv) { return wxEntry(argc, argv); } | |
682 | ||
90e572f1 | 683 | // port-specific header could have defined it already in some special way |
956495ca | 684 | #ifndef IMPLEMENT_WXWIN_MAIN |
7738c2e5 | 685 | #define IMPLEMENT_WXWIN_MAIN IMPLEMENT_WXWIN_MAIN_CONSOLE |
956495ca | 686 | #endif // defined(IMPLEMENT_WXWIN_MAIN) |
26a87b69 | 687 | |
24e78d27 VZ |
688 | #ifdef __WXUNIVERSAL__ |
689 | #include "wx/univ/theme.h" | |
690 | ||
ee92941a VS |
691 | #ifdef wxUNIV_DEFAULT_THEME |
692 | #define IMPLEMENT_WX_THEME_SUPPORT \ | |
693 | WX_USE_THEME(wxUNIV_DEFAULT_THEME); | |
694 | #else | |
695 | #define IMPLEMENT_WX_THEME_SUPPORT | |
696 | #endif | |
24e78d27 VZ |
697 | #else |
698 | #define IMPLEMENT_WX_THEME_SUPPORT | |
699 | #endif | |
c801d85f | 700 | |
c661ecca RR |
701 | // Use this macro if you want to define your own main() or WinMain() function |
702 | // and call wxEntry() from there. | |
94826170 | 703 | #define IMPLEMENT_APP_NO_MAIN(appname) \ |
e8e1149b | 704 | wxAppConsole *wxCreateApp() \ |
94826170 | 705 | { \ |
2a7c7605 | 706 | wxAppConsole::CheckBuildOptions(WX_BUILD_OPTIONS_SIGNATURE, \ |
82c75aea | 707 | "your program"); \ |
94826170 VZ |
708 | return new appname; \ |
709 | } \ | |
710 | wxAppInitializer \ | |
711 | wxTheAppInitializer((wxAppInitializerFunction) wxCreateApp); \ | |
17a1ebd1 | 712 | DECLARE_APP(appname) \ |
5c33522f | 713 | appname& wxGetApp() { return *static_cast<appname*>(wxApp::GetInstance()); } |
c661ecca | 714 | |
24e78d27 VZ |
715 | // Same as IMPLEMENT_APP() normally but doesn't include themes support in |
716 | // wxUniversal builds | |
717 | #define IMPLEMENT_APP_NO_THEMES(appname) \ | |
718 | IMPLEMENT_APP_NO_MAIN(appname) \ | |
719 | IMPLEMENT_WXWIN_MAIN | |
720 | ||
721 | // Use this macro exactly once, the argument is the name of the wxApp-derived | |
722 | // class which is the class of your application. | |
723 | #define IMPLEMENT_APP(appname) \ | |
724 | IMPLEMENT_APP_NO_THEMES(appname) \ | |
725 | IMPLEMENT_WX_THEME_SUPPORT | |
726 | ||
80b2db4e VS |
727 | // Same as IMPLEMENT_APP(), but for console applications. |
728 | #define IMPLEMENT_APP_CONSOLE(appname) \ | |
729 | IMPLEMENT_APP_NO_MAIN(appname) \ | |
730 | IMPLEMENT_WXWIN_MAIN_CONSOLE | |
731 | ||
24e78d27 VZ |
732 | // this macro can be used multiple times and just allows you to use wxGetApp() |
733 | // function | |
094637f6 | 734 | #define DECLARE_APP(appname) extern appname& wxGetApp(); |
c801d85f | 735 | |
17a1ebd1 VZ |
736 | |
737 | // declare the stuff defined by IMPLEMENT_APP() macro, it's not really needed | |
738 | // anywhere else but at the very least it suppresses icc warnings about | |
739 | // defining extern symbols without prior declaration, and it shouldn't do any | |
740 | // harm | |
741 | extern wxAppConsole *wxCreateApp(); | |
742 | extern wxAppInitializer wxTheAppInitializer; | |
743 | ||
94826170 | 744 | #endif // _WX_APP_H_BASE_ |