]> git.saurik.com Git - wxWidgets.git/blame - include/wx/msgout.h
don't draw borders for bitmap buttons with wxBORDER_NONE style
[wxWidgets.git] / include / wx / msgout.h
CommitLineData
74698d3a
MB
1///////////////////////////////////////////////////////////////////////////////
2// Name: wx/msgout.h
3// Purpose: wxMessageOutput class. Shows a message to the user
4// Author: Mattia Barbon
5// Modified by:
6// Created: 17.07.02
7// RCS-ID: $Id$
99d80019 8// Copyright: (c) Mattia Barbon
65571936 9// Licence: wxWindows licence
74698d3a
MB
10///////////////////////////////////////////////////////////////////////////////
11
12#ifndef _WX_MSGOUT_H_
13#define _WX_MSGOUT_H_
14
15// ----------------------------------------------------------------------------
16// headers
17// ----------------------------------------------------------------------------
18
74698d3a 19#include "wx/defs.h"
e3f6cbd9 20#include "wx/chartype.h"
c9f78968 21#include "wx/strvararg.h"
74698d3a 22
98020767
VZ
23// ----------------------------------------------------------------------------
24// wxMessageOutput is a class abstracting formatted output target, i.e.
25// something you can printf() to
26// ----------------------------------------------------------------------------
27
c9f78968
VS
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).
33class wxMessageOutputBase
74698d3a
MB
34{
35public:
c9f78968 36 virtual ~wxMessageOutputBase() { }
74698d3a
MB
37
38 // show a message to the user
2523e9b7 39 // void Printf(const wxString& format, ...) = 0;
1528e0b8 40 WX_DEFINE_VARARG_FUNC_VOID(Printf, 1, (const wxFormatString&),
d1f6e2cf 41 DoPrintfWchar, DoPrintfUtf8)
2523e9b7
VS
42#ifdef __WATCOMC__
43 // workaround for http://bugzilla.openwatcom.org/show_bug.cgi?id=351
59a14f69
VS
44 WX_VARARG_WATCOM_WORKAROUND(void, Printf, 1, (const wxString&),
45 (wxFormatString(f1)));
46 WX_VARARG_WATCOM_WORKAROUND(void, Printf, 1, (const wxCStrData&),
47 (wxFormatString(f1)));
48 WX_VARARG_WATCOM_WORKAROUND(void, Printf, 1, (const char*),
49 (wxFormatString(f1)));
50 WX_VARARG_WATCOM_WORKAROUND(void, Printf, 1, (const wchar_t*),
51 (wxFormatString(f1)));
2523e9b7 52#endif
c9f78968 53
8a946489
VZ
54 // called by DoPrintf() to output formatted string but can also be called
55 // directly if no formatting is needed
56 virtual void Output(const wxString& str) = 0;
57
c9f78968 58protected:
b5536269
VS
59 // NB: this is pure virtual so that it can be implemented in dllexported
60 // wxMessagOutput class
d1f6e2cf
VS
61#if !wxUSE_UTF8_LOCALE_ONLY
62 virtual void DoPrintfWchar(const wxChar *format, ...) = 0;
63#endif
64#if wxUSE_UNICODE_UTF8
65 virtual void DoPrintfUtf8(const char *format, ...) = 0;
66#endif
c9f78968
VS
67};
68
69#ifdef __VISUALC__
70 // "non dll-interface class 'wxStringPrintfMixin' used as base interface
71 // for dll-interface class 'wxString'" -- this is OK in our case
fb330c2e 72 #pragma warning (push)
c9f78968
VS
73 #pragma warning (disable:4275)
74#endif
75
76class WXDLLIMPEXP_BASE wxMessageOutput : public wxMessageOutputBase
77{
78public:
79 virtual ~wxMessageOutput() { }
98020767 80
e12a951e
VZ
81 // gets the current wxMessageOutput object (may be NULL during
82 // initialization or shutdown)
74698d3a 83 static wxMessageOutput* Get();
98020767 84
74698d3a
MB
85 // sets the global wxMessageOutput instance; returns the previous one
86 static wxMessageOutput* Set(wxMessageOutput* msgout);
98020767 87
b5536269 88protected:
d1f6e2cf
VS
89#if !wxUSE_UTF8_LOCALE_ONLY
90 virtual void DoPrintfWchar(const wxChar *format, ...);
91#endif
92#if wxUSE_UNICODE_UTF8
93 virtual void DoPrintfUtf8(const char *format, ...);
94#endif
b5536269 95
74698d3a
MB
96private:
97 static wxMessageOutput* ms_msgOut;
98};
99
c9f78968 100#ifdef __VISUALC__
fb330c2e 101 #pragma warning (pop)
c9f78968
VS
102#endif
103
e12a951e 104// ----------------------------------------------------------------------------
784ee7d5 105// implementation which sends output to stderr
e12a951e
VZ
106// ----------------------------------------------------------------------------
107
784ee7d5 108class WXDLLIMPEXP_BASE wxMessageOutputStderr : public wxMessageOutput
e12a951e
VZ
109{
110public:
784ee7d5 111 wxMessageOutputStderr() { }
e12a951e 112
5b077ec7 113 virtual void Output(const wxString& str);
784ee7d5 114
8a946489 115protected:
784ee7d5
VZ
116 // return the string with "\n" appended if it doesn't already terminate
117 // with it (in which case it's returned unchanged)
118 wxString AppendLineFeedIfNeeded(const wxString& str);
e12a951e
VZ
119};
120
98020767 121// ----------------------------------------------------------------------------
784ee7d5
VZ
122// implementation showing the message to the user in "best" possible way:
123// uses stderr or message box if available according to the flag given to ctor.
98020767
VZ
124// ----------------------------------------------------------------------------
125
784ee7d5
VZ
126enum wxMessageOutputFlags
127{
128 wxMSGOUT_PREFER_STDERR = 0, // use stderr if available (this is the default)
129 wxMSGOUT_PREFER_MSGBOX = 1 // always use message box if available
130};
131
132class WXDLLIMPEXP_BASE wxMessageOutputBest : public wxMessageOutputStderr
74698d3a
MB
133{
134public:
784ee7d5
VZ
135 wxMessageOutputBest(wxMessageOutputFlags flags = wxMSGOUT_PREFER_STDERR)
136 : m_flags(flags) { }
74698d3a 137
5b077ec7 138 virtual void Output(const wxString& str);
784ee7d5
VZ
139
140private:
141 wxMessageOutputFlags m_flags;
74698d3a
MB
142};
143
98020767
VZ
144// ----------------------------------------------------------------------------
145// implementation which shows output in a message box
146// ----------------------------------------------------------------------------
147
fae86641 148#if wxUSE_GUI && wxUSE_MSGDLG
74698d3a 149
bddd7a8d 150class WXDLLIMPEXP_CORE wxMessageOutputMessageBox : public wxMessageOutput
74698d3a
MB
151{
152public:
98020767 153 wxMessageOutputMessageBox() { }
74698d3a 154
5b077ec7 155 virtual void Output(const wxString& str);
74698d3a
MB
156};
157
fae86641 158#endif // wxUSE_GUI && wxUSE_MSGDLG
74698d3a 159
e2478fde
VZ
160// ----------------------------------------------------------------------------
161// implementation using the native way of outputting debug messages
162// ----------------------------------------------------------------------------
163
784ee7d5 164class WXDLLIMPEXP_BASE wxMessageOutputDebug : public wxMessageOutputStderr
e2478fde
VZ
165{
166public:
167 wxMessageOutputDebug() { }
168
5b077ec7 169 virtual void Output(const wxString& str);
e2478fde
VZ
170};
171
98020767
VZ
172// ----------------------------------------------------------------------------
173// implementation using wxLog (mainly for backwards compatibility)
174// ----------------------------------------------------------------------------
175
bddd7a8d 176class WXDLLIMPEXP_BASE wxMessageOutputLog : public wxMessageOutput
74698d3a
MB
177{
178public:
98020767 179 wxMessageOutputLog() { }
74698d3a 180
5b077ec7 181 virtual void Output(const wxString& str);
74698d3a
MB
182};
183
784ee7d5 184#endif // _WX_MSGOUT_H_