1 ///////////////////////////////////////////////////////////////////////////////
3 // Purpose: wxMessageOutput class. Shows a message to the user
4 // Author: Mattia Barbon
8 // Copyright: (c) Mattia Barbon
9 // Licence: wxWindows licence
10 ///////////////////////////////////////////////////////////////////////////////
15 // ----------------------------------------------------------------------------
17 // ----------------------------------------------------------------------------
20 #include "wx/wxchar.h"
21 #include "wx/strvararg.h"
23 // ----------------------------------------------------------------------------
24 // wxMessageOutput is a class abstracting formatted output target, i.e.
25 // something you can printf() to
26 // ----------------------------------------------------------------------------
28 // NB: VC6 has a bug that causes linker errors if you have template methods
29 // in a class using __declspec(dllimport). The solution is to split such
30 // class into two classes, one that contains the template methods and does
31 // *not* use WXDLLIMPEXP_BASE and another class that contains the rest
32 // (with DLL linkage).
33 class wxMessageOutputBase
36 virtual ~wxMessageOutputBase() { }
38 // show a message to the user
39 // void Printf(const wxChar* format, ...) ATTRIBUTE_PRINTF_2 = 0;
40 WX_DEFINE_VARARG_FUNC_VOID(Printf
, DoPrintf
)
43 virtual void DoPrintf(const wxChar
* format
, ...) ATTRIBUTE_PRINTF_2
= 0;
47 // "non dll-interface class 'wxStringPrintfMixin' used as base interface
48 // for dll-interface class 'wxString'" -- this is OK in our case
49 #pragma warning (disable:4275)
52 class WXDLLIMPEXP_BASE wxMessageOutput
: public wxMessageOutputBase
55 virtual ~wxMessageOutput() { }
57 // gets the current wxMessageOutput object (may be NULL during
58 // initialization or shutdown)
59 static wxMessageOutput
* Get();
61 // sets the global wxMessageOutput instance; returns the previous one
62 static wxMessageOutput
* Set(wxMessageOutput
* msgout
);
65 static wxMessageOutput
* ms_msgOut
;
69 #pragma warning (default:4275)
72 // ----------------------------------------------------------------------------
73 // implementation showing the message to the user in "best" possible way: uses
74 // native message box if available (currently only under Windows) and stderr
75 // otherwise; unlike wxMessageOutputMessageBox this class is always safe to use
76 // ----------------------------------------------------------------------------
78 class WXDLLIMPEXP_BASE wxMessageOutputBest
: public wxMessageOutput
81 wxMessageOutputBest() { }
84 virtual void DoPrintf(const wxChar
* format
, ...) ATTRIBUTE_PRINTF_2
;
87 // ----------------------------------------------------------------------------
88 // implementation which sends output to stderr
89 // ----------------------------------------------------------------------------
91 class WXDLLIMPEXP_BASE wxMessageOutputStderr
: public wxMessageOutput
94 wxMessageOutputStderr() { }
97 virtual void DoPrintf(const wxChar
* format
, ...) ATTRIBUTE_PRINTF_2
;
100 // ----------------------------------------------------------------------------
101 // implementation which shows output in a message box
102 // ----------------------------------------------------------------------------
106 class WXDLLIMPEXP_CORE wxMessageOutputMessageBox
: public wxMessageOutput
109 wxMessageOutputMessageBox() { }
112 virtual void DoPrintf(const wxChar
* format
, ...) ATTRIBUTE_PRINTF_2
;
117 // ----------------------------------------------------------------------------
118 // implementation using the native way of outputting debug messages
119 // ----------------------------------------------------------------------------
121 class WXDLLIMPEXP_BASE wxMessageOutputDebug
: public wxMessageOutput
124 wxMessageOutputDebug() { }
127 virtual void DoPrintf(const wxChar
* format
, ...) ATTRIBUTE_PRINTF_2
;
130 // ----------------------------------------------------------------------------
131 // implementation using wxLog (mainly for backwards compatibility)
132 // ----------------------------------------------------------------------------
134 class WXDLLIMPEXP_BASE wxMessageOutputLog
: public wxMessageOutput
137 wxMessageOutputLog() { }
140 virtual void DoPrintf(const wxChar
* format
, ...) ATTRIBUTE_PRINTF_2
;