include/wx/msgdlg.h

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        wx/msgdlgg.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
  22 WXDLLIMPEXP_DATA_CORE(extern const char) wxMessageBoxCaptionStr[];
  23
  24 // ----------------------------------------------------------------------------
  25 // wxMessageDialogBase: base class defining wxMessageDialog interface
  26 // ----------------------------------------------------------------------------
  27
  28 class WXDLLIMPEXP_CORE wxMessageDialogBase : public wxDialog
  29 {
  30 public:
  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 ? m_label
  72                                           : wxGetStockLabel(m_stockId);
  73         }
  74
  75         // return the stock id or wxID_NONE if this is not a stock label
  76         int GetStockId() const { return m_stockId; }
  77
  78     private:
  79         // the label if explicitly given or empty if this is a stock item
  80         const wxString m_label;
  81
  82         // the stock item id or wxID_NONE if m_label should be used
  83         const int m_stockId;
  84     };
  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
 104     // methods for setting up more custom message dialogs -- all functions
 105     // return false if they're not implemented
 106     virtual bool SetYesNoLabels(const ButtonLabel& WXUNUSED(yes),
 107                                 const ButtonLabel& WXUNUSED(no))
 108     {
 109         return false;
 110     }
 111
 112     virtual bool SetYesNoCancelLabels(const ButtonLabel& WXUNUSED(yes),
 113                                       const ButtonLabel& WXUNUSED(no),
 114                                       const ButtonLabel& WXUNUSED(cancel))
 115     {
 116         return false;
 117     }
 118
 119     virtual bool SetOKLabel(const ButtonLabel& WXUNUSED(ok))
 120     {
 121         return false;
 122     }
 123
 124     virtual bool SetOKCancelLabels(const ButtonLabel& WXUNUSED(ok),
 125                                    const ButtonLabel& WXUNUSED(cancel))
 126     {
 127         return false;
 128     }
 129
 130     virtual void SetMessage(const wxString& message)
 131     {
 132         m_message = message;
 133     }
 134
 135     virtual void SetExtendedMessage(const wxString& extendedMessage)
 136     {
 137         m_extendedMessage = extendedMessage;
 138     }
 139
 140     // change the dialog style flag
 141     void SetMessageDialogStyle(long style)
 142     {
 143         wxASSERT_MSG( ((style & wxYES_NO) == wxYES_NO) || !(style & wxYES_NO),
 144                       "wxYES and wxNO may only be used together" );
 145
 146         wxASSERT_MSG( !(style & wxYES) || !(style & wxOK),
 147                       "wxOK and wxYES/wxNO can't be used together" );
 148
 149         wxASSERT_MSG( (style & wxYES) || (style & wxOK),
 150                       "one of wxOK and wxYES/wxNO must be used" );
 151
 152         wxASSERT_MSG( (style & wxID_OK) != wxID_OK,
 153                       "wxMessageBox: Did you mean wxOK (and not wxID_OK)?" );
 154
 155         if ((style & wxNO_DEFAULT) != 0 && (style & wxNO) == 0)
 156             wxFAIL_MSG("wxNO_DEFAULT is invalid without wxNO");
 157
 158         if ((style & wxCANCEL_DEFAULT) != 0 && (style & wxCANCEL) == 0)
 159             wxFAIL_MSG("wxCANCEL_DEFAULT is invalid without wxCANCEL");
 160
 161         if ((style & wxCANCEL_DEFAULT) != 0 && (style & wxNO_DEFAULT) != 0)
 162             wxFAIL_MSG("only one default button can be specified");
 163
 164         m_dialogStyle = style;
 165     }
 166
 167 protected:
 168     long GetMessageDialogStyle() const { return m_dialogStyle; }
 169
 170
 171     // for the platforms not supporting separate main and extended messages
 172     // this function should be used to combine both of them in a single string
 173     wxString GetFullMessage() const
 174     {
 175         wxString msg = m_message;
 176         if ( !m_extendedMessage.empty() )
 177             msg << "\n\n" << m_extendedMessage;
 178
 179         return msg;
 180     }
 181
 182     wxString m_message,
 183              m_extendedMessage,
 184              m_caption;
 185     long m_dialogStyle;
 186
 187     wxDECLARE_NO_COPY_CLASS(wxMessageDialogBase);
 188 };
 189
 190 // this is a helper class for native wxMessageDialog implementations which need
 191 // to store the custom button labels as member variables and then use them in
 192 // ShowModal() (there could conceivably be a port which would have some native
 193 // functions for setting these labels immediately and we also don't need to
 194 // store them at all if custom labels are not supported, which is why we do
 195 // this in a separate class and not wxMessageDialogBase itself)
 196 #if defined(__WXCOCOA__) || \
 197     defined(__WXGTK20__) || \
 198     defined(__WXMAC__) || \
 199     defined(__WXMSW__)
 200
 201 class WXDLLIMPEXP_CORE wxMessageDialogWithCustomLabels
 202     : public wxMessageDialogBase
 203 {
 204 public:
 205     // ctors
 206     wxMessageDialogWithCustomLabels() { }
 207     wxMessageDialogWithCustomLabels(wxWindow *parent,
 208                                     const wxString& message,
 209                                     const wxString& caption,
 210                                     long style)
 211         : wxMessageDialogBase(parent, message, caption, style)
 212     {
 213     }
 214
 215     // customization of the message box buttons
 216     virtual bool SetYesNoLabels(const ButtonLabel& yes,const ButtonLabel& no)
 217     {
 218         DoSetCustomLabel(m_yes, yes);
 219         DoSetCustomLabel(m_no, no);
 220         return true;
 221     }
 222
 223     virtual bool SetYesNoCancelLabels(const ButtonLabel& yes,
 224                                       const ButtonLabel& no,
 225                                       const ButtonLabel& cancel)
 226     {
 227         DoSetCustomLabel(m_yes, yes);
 228         DoSetCustomLabel(m_no, no);
 229         DoSetCustomLabel(m_cancel, cancel);
 230         return true;
 231     }
 232
 233     virtual bool SetOKLabel(const ButtonLabel& ok)
 234     {
 235         DoSetCustomLabel(m_ok, ok);
 236         return true;
 237     }
 238
 239     virtual bool SetOKCancelLabels(const ButtonLabel& ok,
 240                                    const ButtonLabel& cancel)
 241     {
 242         DoSetCustomLabel(m_ok, ok);
 243         DoSetCustomLabel(m_cancel, cancel);
 244         return true;
 245     }
 246
 247 protected:
 248     // test if any custom labels were set
 249     bool HasCustomLabels() const
 250     {
 251         return !(m_ok.empty() && m_cancel.empty() &&
 252                  m_yes.empty() && m_no.empty());
 253     }
 254
 255     // these functions return the label to be used for the button which is
 256     // either a custom label explicitly set by the user or the default label,
 257     // i.e. they always return a valid string
 258     wxString GetYesLabel() const
 259         { return m_yes.empty() ? GetDefaultYesLabel() : m_yes; }
 260     wxString GetNoLabel() const
 261         { return m_no.empty() ? GetDefaultNoLabel() : m_no; }
 262     wxString GetOKLabel() const
 263         { return m_ok.empty() ? GetDefaultOKLabel() : m_ok; }
 264     wxString GetCancelLabel() const
 265         { return m_cancel.empty() ? GetDefaultCancelLabel() : m_cancel; }
 266
 267     // this function is called by our public SetXXXLabels() and should assign
 268     // the value to var with possibly some transformation (e.g. Cocoa version
 269     // currently uses this to remove any accelerators from the button strings
 270     // while GTK+ one handles stock items specifically here)
 271     virtual void DoSetCustomLabel(wxString& var, const ButtonLabel& label)
 272     {
 273         var = label.GetAsString();
 274     }
 275
 276 private:
 277     // these functions may be overridden to provide different defaults for the
 278     // default button labels (this is used by wxGTK)
 279     virtual wxString GetDefaultYesLabel() const { return _("Yes"); }
 280     virtual wxString GetDefaultNoLabel() const { return _("No"); }
 281     virtual wxString GetDefaultOKLabel() const { return _("OK"); }
 282     virtual wxString GetDefaultCancelLabel() const { return _("Cancel"); }
 283
 284     // labels for the buttons, initially empty meaning that the defaults should
 285     // be used, use GetYes/No/OK/CancelLabel() to access them
 286     wxString m_yes,
 287              m_no,
 288              m_ok,
 289              m_cancel;
 290
 291     wxDECLARE_NO_COPY_CLASS(wxMessageDialogWithCustomLabels);
 292 };
 293
 294 #endif // ports needing wxMessageDialogWithCustomLabels
 295
 296 #if defined(__WX_COMPILING_MSGDLGG_CPP__) || \
 297     defined(__WXUNIVERSAL__) || defined(__WXGPE__) || \
 298     (defined(__WXGTK__) && !defined(__WXGTK20__))
 299     #include "wx/generic/msgdlgg.h"
 300
 301     #define wxMessageDialog wxGenericMessageDialog
 302 #elif defined(__WXCOCOA__)
 303     #include "wx/cocoa/msgdlg.h"
 304 #elif defined(__WXPALMOS__)
 305     #include "wx/palmos/msgdlg.h"
 306 #elif defined(__WXMSW__)
 307     #include "wx/msw/msgdlg.h"
 308 #elif defined(__WXMOTIF__)
 309     #include "wx/motif/msgdlg.h"
 310 #elif defined(__WXGTK20__)
 311     #include "wx/gtk/msgdlg.h"
 312 #elif defined(__WXMAC__)
 313     #include "wx/osx/msgdlg.h"
 314 #elif defined(__WXPM__)
 315     #include "wx/os2/msgdlg.h"
 316 #endif
 317
 318 // ----------------------------------------------------------------------------
 319 // wxMessageBox: the simplest way to use wxMessageDialog
 320 // ----------------------------------------------------------------------------
 321
 322 int WXDLLIMPEXP_CORE wxMessageBox(const wxString& message,
 323                              const wxString& caption = wxMessageBoxCaptionStr,
 324                              long style = wxOK | wxCENTRE,
 325                              wxWindow *parent = NULL,
 326                              int x = wxDefaultCoord, int y = wxDefaultCoord);
 327
 328 #endif // wxUSE_MSGDLG
 329
 330 #endif // _WX_MSGDLG_H_BASE_