1 ///////////////////////////////////////////////////////////////////////////////
3 // Purpose: declaration of wxAppTraits and derived classes
4 // Author: Vadim Zeitlin
8 // Copyright: (c) 2003 Vadim Zeitlin <vadim@wxwidgets.org>
9 // Licence: wxWindows licence
10 ///////////////////////////////////////////////////////////////////////////////
12 #ifndef _WX_APPTRAIT_H_
13 #define _WX_APPTRAIT_H_
15 #include "wx/string.h"
16 #include "wx/platinfo.h"
18 class WXDLLIMPEXP_BASE wxObject
;
19 class WXDLLEXPORT wxAppTraits
;
21 class WXDLLEXPORT wxFontMapper
;
22 #endif // wxUSE_FONTMAP
23 class WXDLLIMPEXP_BASE wxLog
;
24 class WXDLLIMPEXP_BASE wxMessageOutput
;
25 class WXDLLEXPORT wxRendererNative
;
26 class WXDLLIMPEXP_BASE wxString
;
27 class WXDLLIMPEXP_BASE wxTimer
;
28 class WXDLLIMPEXP_BASE wxTimerImpl
;
30 class GSocketGUIFunctionsTable
;
33 // ----------------------------------------------------------------------------
34 // wxAppTraits: this class defines various configurable aspects of wxApp
35 // ----------------------------------------------------------------------------
37 class WXDLLIMPEXP_BASE wxStandardPathsBase
;
39 class WXDLLIMPEXP_BASE wxAppTraitsBase
42 // needed since this class declares virtual members
43 virtual ~wxAppTraitsBase() { }
45 // hooks for working with the global objects, may be overridden by the user
46 // ------------------------------------------------------------------------
49 // create the default log target
50 virtual wxLog
*CreateLogTarget() = 0;
53 // create the global object used for printing out messages
54 virtual wxMessageOutput
*CreateMessageOutput() = 0;
57 // create the global font mapper object used for encodings/charset mapping
58 virtual wxFontMapper
*CreateFontMapper() = 0;
59 #endif // wxUSE_FONTMAP
61 // get the renderer to use for drawing the generic controls (return value
62 // may be NULL in which case the default renderer for the current platform
63 // is used); this is used in GUI only and always returns NULL in console
65 // NB: returned pointer will be deleted by the caller
66 virtual wxRendererNative
*CreateRenderer() = 0;
69 // wxStandardPaths object is normally the same for wxBase and wxGUI
70 // except in the case of wxMac and wxCocoa
71 virtual wxStandardPathsBase
& GetStandardPaths();
72 #endif // wxUSE_STDPATHS
75 // called during wxApp initialization to set the locale to correspond to
76 // the user default (i.e. system locale under Windows, LC_ALL under Unix)
77 virtual void SetLocale();
81 // functions abstracting differences between GUI and console modes
82 // ------------------------------------------------------------------------
85 // show the assert dialog with the specified message in GUI or just print
86 // the string to stderr in console mode
88 // base class version has an implementation (in spite of being pure
89 // virtual) in base/appbase.cpp which can be called as last resort.
91 // return true to suppress subsequent asserts, false to continue as before
92 virtual bool ShowAssertDialog(const wxString
& msg
) = 0;
95 // return true if fprintf(stderr) goes somewhere, false otherwise
96 virtual bool HasStderr() = 0;
98 // managing "pending delete" list: in GUI mode we can't immediately delete
99 // some objects because there may be unprocessed events for them and so we
100 // only do it during the next idle loop iteration while this is, of course,
101 // unnecessary in wxBase, so we have a few functions to abstract these
104 // add the object to the pending delete list in GUI, delete it immediately
106 virtual void ScheduleForDestroy(wxObject
*object
) = 0;
108 // remove this object from the pending delete list in GUI, do nothing in
110 virtual void RemoveFromPendingDelete(wxObject
*object
) = 0;
113 // return table of GUI callbacks for GSocket code or NULL in wxBase. This
114 // is needed because networking classes are in their own library and so
115 // they can't directly call GUI functions (the same net library can be
116 // used in both GUI and base apps). To complicate it further, GUI library
117 // ("wxCore") doesn't depend on networking library and so only a functions
118 // table can be passed around
119 virtual GSocketGUIFunctionsTable
* GetSocketGUIFunctionsTable() = 0;
123 // return platform and toolkit dependent wxTimer implementation
124 virtual wxTimerImpl
*CreateTimerImpl(wxTimer
*timer
) = 0;
127 // functions returning port-specific information
128 // ------------------------------------------------------------------------
130 // return information about the (native) toolkit currently used and its
131 // runtime (not compile-time) version.
132 // returns wxPORT_BASE for console applications and one of the remaining
133 // wxPORT_* values for GUI applications.
134 virtual wxPortId
GetToolkitVersion(int *majVer
, int *minVer
) const = 0;
136 // return true if the port is using wxUniversal for the GUI, false if not
137 virtual bool IsUsingUniversalWidgets() const = 0;
139 // return the name of the Desktop Environment such as
140 // "KDE" or "GNOME". May return an empty string.
141 virtual wxString
GetDesktopEnvironment() const = 0;
143 // returns a short string to identify the block of the standard command
144 // line options parsed automatically by current port: if this string is
145 // empty, there are no such options, otherwise the function also fills
146 // passed arrays with the names and the descriptions of those options.
147 virtual wxString
GetStandardCmdLineOptions(wxArrayString
& names
,
148 wxArrayString
& desc
) const
153 return wxEmptyString
;
158 #if wxUSE_STACKWALKER && defined( __WXDEBUG__ )
159 // utility function: returns the stack frame as a plain wxString
160 virtual wxString
GetAssertStackTrace();
164 // ----------------------------------------------------------------------------
165 // include the platform-specific version of the class
166 // ----------------------------------------------------------------------------
168 // NB: test for __UNIX__ before __WXMAC__ as under Darwin we want to use the
169 // Unix code (and otherwise __UNIX__ wouldn't be defined)
170 // ABX: check __WIN32__ instead of __WXMSW__ for the same MSWBase in any Win32 port
171 #if defined(__WXPALMOS__)
172 #include "wx/palmos/apptbase.h"
173 #elif defined(__WIN32__)
174 #include "wx/msw/apptbase.h"
175 #elif defined(__UNIX__) && !defined(__EMX__)
176 #include "wx/unix/apptbase.h"
177 #elif defined(__WXMAC__)
178 #include "wx/mac/apptbase.h"
179 #elif defined(__OS2__)
180 #include "wx/os2/apptbase.h"
181 #else // no platform-specific methods to add to wxAppTraits
182 // wxAppTraits must be a class because it was forward declared as class
183 class WXDLLIMPEXP_BASE wxAppTraits
: public wxAppTraitsBase
188 // ============================================================================
189 // standard traits for console and GUI applications
190 // ============================================================================
192 // ----------------------------------------------------------------------------
193 // wxConsoleAppTraitsBase: wxAppTraits implementation for the console apps
194 // ----------------------------------------------------------------------------
196 class WXDLLIMPEXP_BASE wxConsoleAppTraitsBase
: public wxAppTraits
200 virtual wxLog
*CreateLogTarget();
202 virtual wxMessageOutput
*CreateMessageOutput();
204 virtual wxFontMapper
*CreateFontMapper();
205 #endif // wxUSE_FONTMAP
206 virtual wxRendererNative
*CreateRenderer();
208 virtual GSocketGUIFunctionsTable
* GetSocketGUIFunctionsTable();
212 virtual bool ShowAssertDialog(const wxString
& msg
);
213 #endif // __WXDEBUG__
214 virtual bool HasStderr();
216 virtual void ScheduleForDestroy(wxObject
*object
);
217 virtual void RemoveFromPendingDelete(wxObject
*object
);
219 // the GetToolkitVersion for console application is always the same
220 virtual wxPortId
GetToolkitVersion(int *verMaj
, int *verMin
) const
222 // no toolkits (wxBase is for console applications without GUI support)
223 // NB: zero means "no toolkit", -1 means "not initialized yet"
224 // so we must use zero here!
225 if (verMaj
) *verMaj
= 0;
226 if (verMin
) *verMin
= 0;
230 virtual bool IsUsingUniversalWidgets() const { return false; }
231 virtual wxString
GetDesktopEnvironment() const { return wxEmptyString
; }
234 // ----------------------------------------------------------------------------
235 // wxGUIAppTraitsBase: wxAppTraits implementation for the GUI apps
236 // ----------------------------------------------------------------------------
240 class WXDLLEXPORT wxGUIAppTraitsBase
: public wxAppTraits
244 virtual wxLog
*CreateLogTarget();
246 virtual wxMessageOutput
*CreateMessageOutput();
248 virtual wxFontMapper
*CreateFontMapper();
249 #endif // wxUSE_FONTMAP
250 virtual wxRendererNative
*CreateRenderer();
252 virtual GSocketGUIFunctionsTable
* GetSocketGUIFunctionsTable();
256 virtual bool ShowAssertDialog(const wxString
& msg
);
257 #endif // __WXDEBUG__
258 virtual bool HasStderr();
260 virtual void ScheduleForDestroy(wxObject
*object
);
261 virtual void RemoveFromPendingDelete(wxObject
*object
);
263 virtual bool IsUsingUniversalWidgets() const
265 #ifdef __WXUNIVERSAL__
272 virtual wxString
GetDesktopEnvironment() const { return wxEmptyString
; }
277 // ----------------------------------------------------------------------------
278 // include the platform-specific version of the classes above
279 // ----------------------------------------------------------------------------
281 // ABX: check __WIN32__ instead of __WXMSW__ for the same MSWBase in any Win32 port
282 #if defined(__WXPALMOS__)
283 #include "wx/palmos/apptrait.h"
284 #elif defined(__WIN32__)
285 #include "wx/msw/apptrait.h"
286 #elif defined(__OS2__)
287 #include "wx/os2/apptrait.h"
288 #elif defined(__UNIX__)
289 #include "wx/unix/apptrait.h"
290 #elif defined(__WXMAC__)
291 #include "wx/mac/apptrait.h"
292 #elif defined(__DOS__)
293 #include "wx/msdos/apptrait.h"
296 class wxGUIAppTraits
: public wxGUIAppTraitsBase
300 class wxConsoleAppTraits
: public wxConsoleAppTraitsBase
305 #endif // _WX_APPTRAIT_H_