]> git.saurik.com Git - wxWidgets.git/blame_incremental - include/wx/msgdlg.h
Ensure that key events are sent to focused window first in wxGTK.
[wxWidgets.git] / include / wx / msgdlg.h
... / ...
CommitLineData
1/////////////////////////////////////////////////////////////////////////////
2// Name: wx/msgdlg.h
3// Purpose: common header and base class for wxMessageDialog
4// Author: Julian Smart
5// Modified by:
6// Created:
7// RCS-ID: $Id$
8// Copyright: (c) Julian Smart
9// Licence: wxWindows licence
10/////////////////////////////////////////////////////////////////////////////
11
12#ifndef _WX_MSGDLG_H_BASE_
13#define _WX_MSGDLG_H_BASE_
14
15#include "wx/defs.h"
16
17#if wxUSE_MSGDLG
18
19#include "wx/dialog.h"
20#include "wx/stockitem.h"
21
22extern WXDLLIMPEXP_DATA_CORE(const char) wxMessageBoxCaptionStr[];
23
24// ----------------------------------------------------------------------------
25// wxMessageDialogBase: base class defining wxMessageDialog interface
26// ----------------------------------------------------------------------------
27
28class WXDLLIMPEXP_CORE wxMessageDialogBase : public wxDialog
29{
30public:
31 // helper class for SetXXXLabels() methods: it makes it possible to pass
32 // either a stock id (wxID_CLOSE) or a string ("&Close") to them
33 class ButtonLabel
34 {
35 public:
36 // ctors are not explicit, objects of this class can be implicitly
37 // constructed from either stock ids or strings
38 ButtonLabel(int stockId)
39 : m_stockId(stockId)
40 {
41 wxASSERT_MSG( wxIsStockID(stockId), "invalid stock id" );
42 }
43
44 ButtonLabel(const wxString& label)
45 : m_label(label), m_stockId(wxID_NONE)
46 {
47 }
48
49 ButtonLabel(const char *label)
50 : m_label(label), m_stockId(wxID_NONE)
51 {
52 }
53
54 ButtonLabel(const wchar_t *label)
55 : m_label(label), m_stockId(wxID_NONE)
56 {
57 }
58
59 ButtonLabel(const wxCStrData& label)
60 : m_label(label), m_stockId(wxID_NONE)
61 {
62 }
63
64 // default copy ctor and dtor are ok
65
66 // get the string label, whether it was originally specified directly
67 // or as a stock id -- this is only useful for platforms without native
68 // stock items id support
69 wxString GetAsString() const
70 {
71 return m_stockId == wxID_NONE
72 ? m_label
73 : wxGetStockLabel(m_stockId, wxSTOCK_FOR_BUTTON);
74 }
75
76 // return the stock id or wxID_NONE if this is not a stock label
77 int GetStockId() const { return m_stockId; }
78
79 private:
80 // the label if explicitly given or empty if this is a stock item
81 const wxString m_label;
82
83 // the stock item id or wxID_NONE if m_label should be used
84 const int m_stockId;
85 };
86
87 // ctors
88 wxMessageDialogBase() { m_dialogStyle = 0; }
89 wxMessageDialogBase(wxWindow *parent,
90 const wxString& message,
91 const wxString& caption,
92 long style)
93 : m_message(message),
94 m_caption(caption)
95 {
96 m_parent = parent;
97 SetMessageDialogStyle(style);
98 }
99
100 // virtual dtor for the base class
101 virtual ~wxMessageDialogBase() { }
102
103 wxString GetCaption() const { return m_caption; }
104
105 virtual void SetMessage(const wxString& message)
106 {
107 m_message = message;
108 }
109
110 wxString GetMessage() const { return m_message; }
111
112 void SetExtendedMessage(const wxString& extendedMessage)
113 {
114 m_extendedMessage = extendedMessage;
115 }
116
117 wxString GetExtendedMessage() const { return m_extendedMessage; }
118
119 // change the dialog style flag
120 void SetMessageDialogStyle(long style)
121 {
122 wxASSERT_MSG( ((style & wxYES_NO) == wxYES_NO) || !(style & wxYES_NO),
123 "wxYES and wxNO may only be used together" );
124
125 wxASSERT_MSG( !(style & wxYES) || !(style & wxOK),
126 "wxOK and wxYES/wxNO can't be used together" );
127
128 // It is common to specify just the icon, without wxOK, in the existing
129 // code, especially one written by Windows programmers as MB_OK is 0
130 // and so they're used to omitting wxOK. Don't complain about it but
131 // just add wxOK implicitly for compatibility.
132 if ( !(style & wxYES) && !(style & wxOK) )
133 style |= wxOK;
134
135 wxASSERT_MSG( (style & wxID_OK) != wxID_OK,
136 "wxMessageBox: Did you mean wxOK (and not wxID_OK)?" );
137
138 wxASSERT_MSG( !(style & wxNO_DEFAULT) || (style & wxNO),
139 "wxNO_DEFAULT is invalid without wxNO" );
140
141 wxASSERT_MSG( !(style & wxCANCEL_DEFAULT) || (style & wxCANCEL),
142 "wxCANCEL_DEFAULT is invalid without wxCANCEL" );
143
144 wxASSERT_MSG( !(style & wxCANCEL_DEFAULT) || !(style & wxNO_DEFAULT),
145 "only one default button can be specified" );
146
147 m_dialogStyle = style;
148 }
149
150 long GetMessageDialogStyle() const { return m_dialogStyle; }
151
152 // customization of the message box buttons
153 virtual bool SetYesNoLabels(const ButtonLabel& yes,const ButtonLabel& no)
154 {
155 DoSetCustomLabel(m_yes, yes);
156 DoSetCustomLabel(m_no, no);
157 return true;
158 }
159
160 virtual bool SetYesNoCancelLabels(const ButtonLabel& yes,
161 const ButtonLabel& no,
162 const ButtonLabel& cancel)
163 {
164 DoSetCustomLabel(m_yes, yes);
165 DoSetCustomLabel(m_no, no);
166 DoSetCustomLabel(m_cancel, cancel);
167 return true;
168 }
169
170 virtual bool SetOKLabel(const ButtonLabel& ok)
171 {
172 DoSetCustomLabel(m_ok, ok);
173 return true;
174 }
175
176 virtual bool SetOKCancelLabels(const ButtonLabel& ok,
177 const ButtonLabel& cancel)
178 {
179 DoSetCustomLabel(m_ok, ok);
180 DoSetCustomLabel(m_cancel, cancel);
181 return true;
182 }
183
184 virtual bool SetHelpLabel(const ButtonLabel& help)
185 {
186 DoSetCustomLabel(m_help, help);
187 return true;
188 }
189
190 // test if any custom labels were set
191 bool HasCustomLabels() const
192 {
193 return !(m_ok.empty() && m_cancel.empty() && m_help.empty() &&
194 m_yes.empty() && m_no.empty());
195 }
196
197 // these functions return the label to be used for the button which is
198 // either a custom label explicitly set by the user or the default label,
199 // i.e. they always return a valid string
200 wxString GetYesLabel() const
201 { return m_yes.empty() ? GetDefaultYesLabel() : m_yes; }
202 wxString GetNoLabel() const
203 { return m_no.empty() ? GetDefaultNoLabel() : m_no; }
204 wxString GetOKLabel() const
205 { return m_ok.empty() ? GetDefaultOKLabel() : m_ok; }
206 wxString GetCancelLabel() const
207 { return m_cancel.empty() ? GetDefaultCancelLabel() : m_cancel; }
208 wxString GetHelpLabel() const
209 { return m_help.empty() ? GetDefaultHelpLabel() : m_help; }
210
211 // based on message dialog style, returns exactly one of: wxICON_NONE,
212 // wxICON_ERROR, wxICON_WARNING, wxICON_QUESTION, wxICON_INFORMATION
213 long GetEffectiveIcon() const
214 {
215 if ( m_dialogStyle & wxICON_NONE )
216 return wxICON_NONE;
217 else if ( m_dialogStyle & wxICON_ERROR )
218 return wxICON_ERROR;
219 else if ( m_dialogStyle & wxICON_WARNING )
220 return wxICON_WARNING;
221 else if ( m_dialogStyle & wxICON_QUESTION )
222 return wxICON_QUESTION;
223 else if ( m_dialogStyle & wxICON_INFORMATION )
224 return wxICON_INFORMATION;
225 else if ( m_dialogStyle & wxYES )
226 return wxICON_QUESTION;
227 else
228 return wxICON_INFORMATION;
229 }
230
231protected:
232 // for the platforms not supporting separate main and extended messages
233 // this function should be used to combine both of them in a single string
234 wxString GetFullMessage() const
235 {
236 wxString msg = m_message;
237 if ( !m_extendedMessage.empty() )
238 msg << "\n\n" << m_extendedMessage;
239
240 return msg;
241 }
242
243 wxString m_message,
244 m_extendedMessage,
245 m_caption;
246 long m_dialogStyle;
247
248 // this function is called by our public SetXXXLabels() and should assign
249 // the value to var with possibly some transformation (e.g. Cocoa version
250 // currently uses this to remove any accelerators from the button strings
251 // while GTK+ one handles stock items specifically here)
252 virtual void DoSetCustomLabel(wxString& var, const ButtonLabel& label)
253 {
254 var = label.GetAsString();
255 }
256
257 // these functions return the custom label or empty string and should be
258 // used only in specific circumstances such as creating the buttons with
259 // these labels (in which case it makes sense to only use a custom label if
260 // it was really given and fall back on stock label otherwise), use the
261 // Get{Yes,No,OK,Cancel}Label() methods above otherwise
262 const wxString& GetCustomYesLabel() const { return m_yes; }
263 const wxString& GetCustomNoLabel() const { return m_no; }
264 const wxString& GetCustomOKLabel() const { return m_ok; }
265 const wxString& GetCustomHelpLabel() const { return m_help; }
266 const wxString& GetCustomCancelLabel() const { return m_cancel; }
267
268private:
269 // these functions may be overridden to provide different defaults for the
270 // default button labels (this is used by wxGTK)
271 virtual wxString GetDefaultYesLabel() const { return wxGetTranslation("Yes"); }
272 virtual wxString GetDefaultNoLabel() const { return wxGetTranslation("No"); }
273 virtual wxString GetDefaultOKLabel() const { return wxGetTranslation("OK"); }
274 virtual wxString GetDefaultCancelLabel() const { return wxGetTranslation("Cancel"); }
275 virtual wxString GetDefaultHelpLabel() const { return wxGetTranslation("Help"); }
276
277 // labels for the buttons, initially empty meaning that the defaults should
278 // be used, use GetYes/No/OK/CancelLabel() to access them
279 wxString m_yes,
280 m_no,
281 m_ok,
282 m_cancel,
283 m_help;
284
285 wxDECLARE_NO_COPY_CLASS(wxMessageDialogBase);
286};
287
288#include "wx/generic/msgdlgg.h"
289
290#if defined(__WX_COMPILING_MSGDLGG_CPP__) || \
291 defined(__WXUNIVERSAL__) || defined(__WXGPE__) || \
292 (defined(__WXGTK__) && !defined(__WXGTK20__))
293
294 #define wxMessageDialog wxGenericMessageDialog
295#elif defined(__WXCOCOA__)
296 #include "wx/cocoa/msgdlg.h"
297#elif defined(__WXMSW__)
298 #include "wx/msw/msgdlg.h"
299#elif defined(__WXMOTIF__)
300 #include "wx/motif/msgdlg.h"
301#elif defined(__WXGTK20__)
302 #include "wx/gtk/msgdlg.h"
303#elif defined(__WXMAC__)
304 #include "wx/osx/msgdlg.h"
305#elif defined(__WXPM__)
306 #include "wx/os2/msgdlg.h"
307#endif
308
309// ----------------------------------------------------------------------------
310// wxMessageBox: the simplest way to use wxMessageDialog
311// ----------------------------------------------------------------------------
312
313int WXDLLIMPEXP_CORE wxMessageBox(const wxString& message,
314 const wxString& caption = wxMessageBoxCaptionStr,
315 long style = wxOK | wxCENTRE,
316 wxWindow *parent = NULL,
317 int x = wxDefaultCoord, int y = wxDefaultCoord);
318
319#endif // wxUSE_MSGDLG
320
321#endif // _WX_MSGDLG_H_BASE_