2008-03-08 08:52:38 -05:00
|
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
|
|
// Name: msgdlg.h
|
2008-03-10 11:24:38 -04:00
|
|
|
// Purpose: interface of wxMessageDialog
|
2008-03-08 08:52:38 -05:00
|
|
|
// Author: wxWidgets team
|
|
|
|
// RCS-ID: $Id$
|
|
|
|
// Licence: wxWindows license
|
|
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
|
|
|
|
|
|
/**
|
|
|
|
@class wxMessageDialog
|
2008-03-08 09:43:31 -05:00
|
|
|
|
2008-03-08 08:52:38 -05:00
|
|
|
This class represents a dialog that shows a single or multi-line message,
|
|
|
|
with a choice of OK, Yes, No and Cancel buttons.
|
2008-03-08 09:43:31 -05:00
|
|
|
|
2008-11-28 14:33:37 -05:00
|
|
|
@beginStyleTable
|
|
|
|
@style{wxOK}
|
|
|
|
Puts an Ok button in the message box. May be combined with @c wxCANCEL.
|
|
|
|
@style{wxCANCEL}
|
|
|
|
Puts a Cancel button in the message box. Must be combined with
|
|
|
|
either @c wxOK or @c wxYES_NO.
|
|
|
|
@style{wxYES_NO}
|
|
|
|
Puts Yes and No buttons in the message box. May be combined with
|
|
|
|
@c wxCANCEL.
|
|
|
|
@style{wxNO_DEFAULT}
|
|
|
|
Makes the "No" button default, can only be used with @c wxYES_NO.
|
|
|
|
@style{wxCANCEL_DEFAULT}
|
|
|
|
Makes the "Cancel" button default, can only be used with @c wxCANCEL
|
|
|
|
@style{wxYES_DEFAULT}
|
|
|
|
Makes the "Yes" button default, this is the default behaviour and
|
|
|
|
this flag exists solely for symmetry with @c wxNO_DEFAULT.
|
|
|
|
@style{wxOK_DEFAULT}
|
|
|
|
Makes the "OK" button default, this is the default behaviour and
|
|
|
|
this flag exists solely for symmetry with @c wxCANCEL_DEFAULT.
|
|
|
|
@style{wxICON_EXCLAMATION}
|
|
|
|
Displays an exclamation mark symbol.
|
|
|
|
@style{wxICON_ERROR}
|
|
|
|
Displays an error symbol.
|
|
|
|
@style{wxICON_HAND}
|
|
|
|
Displays an error symbol, this is a MSW-inspired synonym for @c wxICON_ERROR.
|
|
|
|
@style{wxICON_QUESTION}
|
|
|
|
Displays a question mark symbol. This icon is automatically used
|
|
|
|
with @c wxYES_NO so it's usually unnecessary to specify it explicitly.
|
|
|
|
@style{wxICON_INFORMATION}
|
|
|
|
Displays an information symbol. This icon is used by default if
|
|
|
|
@c wxYES_NO is not given so it is usually unnecessary to specify it
|
|
|
|
explicitly.
|
|
|
|
@style{wxSTAY_ON_TOP}
|
|
|
|
Makes the message box stay on top of all other windows (currently
|
|
|
|
implemented only under MSW).
|
|
|
|
@endStyleTable
|
|
|
|
|
2008-03-08 08:52:38 -05:00
|
|
|
@library{wxcore}
|
|
|
|
@category{cmndlg}
|
2008-03-08 09:43:31 -05:00
|
|
|
|
2008-10-11 09:10:48 -04:00
|
|
|
@see @ref overview_cmndlg_msg
|
2008-03-08 08:52:38 -05:00
|
|
|
*/
|
|
|
|
class wxMessageDialog : public wxDialog
|
|
|
|
{
|
|
|
|
public:
|
|
|
|
/**
|
2008-06-21 19:05:38 -04:00
|
|
|
Constructor specifying the message box properties.
|
|
|
|
Use ShowModal() to show the dialog.
|
|
|
|
|
2008-11-28 14:33:37 -05:00
|
|
|
@a style may be a bit list of the identifiers described above.
|
2008-03-20 09:45:17 -04:00
|
|
|
|
2008-10-11 09:10:48 -04:00
|
|
|
Notice that not all styles are compatible: only one of @c wxOK and
|
|
|
|
@c wxYES_NO may be specified (and one of them must be specified) and at
|
2008-09-11 19:37:35 -04:00
|
|
|
most one default button style can be used and it is only valid if the
|
|
|
|
corresponding button is shown in the message box.
|
|
|
|
|
2008-03-08 09:43:31 -05:00
|
|
|
@param parent
|
2008-03-09 08:33:59 -04:00
|
|
|
Parent window.
|
2008-03-08 09:43:31 -05:00
|
|
|
@param message
|
2008-06-21 19:05:38 -04:00
|
|
|
Message to show in the dialog.
|
2008-03-08 09:43:31 -05:00
|
|
|
@param caption
|
2008-06-21 19:05:38 -04:00
|
|
|
The dialog title.
|
2008-03-08 09:43:31 -05:00
|
|
|
@param style
|
2008-06-21 19:05:38 -04:00
|
|
|
Combination of style flags described above.
|
2008-03-08 09:43:31 -05:00
|
|
|
@param pos
|
2008-06-21 19:05:38 -04:00
|
|
|
Dialog position (ignored under MSW).
|
2008-03-08 08:52:38 -05:00
|
|
|
*/
|
|
|
|
wxMessageDialog(wxWindow* parent, const wxString& message,
|
2008-11-10 16:33:25 -05:00
|
|
|
const wxString& caption = wxMessageBoxCaptionStr,
|
2008-09-11 19:37:35 -04:00
|
|
|
long style = wxOK | wxCENTRE,
|
2008-03-08 08:52:38 -05:00
|
|
|
const wxPoint& pos = wxDefaultPosition);
|
|
|
|
|
|
|
|
/**
|
2008-06-21 19:05:38 -04:00
|
|
|
Sets the extended message for the dialog: this message is usually an
|
|
|
|
extension of the short message specified in the constructor or set with
|
|
|
|
SetMessage().
|
|
|
|
|
|
|
|
If it is set, the main message appears highlighted -- if supported --
|
|
|
|
and this message appears beneath it in normal font. On the platforms
|
|
|
|
which don't support extended messages, it is simply appended to the
|
|
|
|
normal message with a new line separating them.
|
2008-03-08 08:52:38 -05:00
|
|
|
*/
|
2008-10-28 11:36:26 -04:00
|
|
|
virtual void SetExtendedMessage(const wxString& extendedMessage);
|
2008-03-08 08:52:38 -05:00
|
|
|
|
|
|
|
/**
|
|
|
|
Sets the message shown by the dialog.
|
|
|
|
*/
|
2008-10-28 11:36:26 -04:00
|
|
|
virtual void SetMessage(const wxString& message);
|
2008-03-08 08:52:38 -05:00
|
|
|
|
|
|
|
/**
|
|
|
|
Overrides the default labels of the OK and Cancel buttons.
|
2008-06-21 19:05:38 -04:00
|
|
|
|
|
|
|
Please see the remarks in SetYesNoLabels() documentation.
|
2008-03-08 08:52:38 -05:00
|
|
|
*/
|
2008-09-27 07:21:10 -04:00
|
|
|
virtual bool SetOKCancelLabels(const ButtonLabel& ok,
|
|
|
|
const ButtonLabel& cancel);
|
2008-03-08 08:52:38 -05:00
|
|
|
|
|
|
|
/**
|
|
|
|
Overrides the default label of the OK button.
|
2008-06-21 19:05:38 -04:00
|
|
|
|
|
|
|
Please see the remarks in SetYesNoLabels() documentation.
|
2008-03-08 08:52:38 -05:00
|
|
|
*/
|
2008-09-27 07:21:10 -04:00
|
|
|
virtual bool SetOKLabel(const ButtonLabel& ok);
|
2008-03-08 08:52:38 -05:00
|
|
|
|
|
|
|
/**
|
|
|
|
Overrides the default labels of the Yes, No and Cancel buttons.
|
2008-06-21 19:05:38 -04:00
|
|
|
|
|
|
|
Please see the remarks in SetYesNoLabels() documentation.
|
2008-03-08 08:52:38 -05:00
|
|
|
*/
|
2008-10-27 17:26:54 -04:00
|
|
|
virtual bool SetYesNoCancelLabels(const ButtonLabel& yes,
|
|
|
|
const ButtonLabel& no,
|
|
|
|
const ButtonLabel& cancel);
|
2008-03-08 08:52:38 -05:00
|
|
|
|
|
|
|
/**
|
|
|
|
Overrides the default labels of the Yes and No buttons.
|
2008-06-21 19:05:38 -04:00
|
|
|
|
2008-09-05 14:02:49 -04:00
|
|
|
The arguments of this function can be either strings or one of the
|
|
|
|
standard identifiers, such as @c wxID_APPLY or @c wxID_OPEN. Notice
|
|
|
|
that even if the label is specified as an identifier, the return value
|
|
|
|
of the dialog ShowModal() method still remains one of @c wxID_OK, @c
|
|
|
|
wxID_CANCEL, @c wxID_YES or @c wxID_NO values, i.e. this identifier
|
|
|
|
changes only the label appearance but not the return code generated by
|
|
|
|
the button. It is possible to mix stock identifiers and string labels
|
|
|
|
in the same function call, for example:
|
|
|
|
@code
|
|
|
|
wxMessageDialog dlg(...);
|
|
|
|
dlg.SetYesNoLabels(wxID_SAVE, _("&Don't save"));
|
|
|
|
@endcode
|
|
|
|
|
|
|
|
Also notice that this function is not currently available on all
|
|
|
|
platforms (although as of wxWidgets 2.9.0 it is implemented in all
|
|
|
|
major ports), so it may return @false to indicate that the labels
|
|
|
|
couldn't be changed. If it returns @true (currently only under wxMac),
|
|
|
|
the labels were set successfully. Typically, if the function was used
|
2008-06-21 19:05:38 -04:00
|
|
|
successfully, the main dialog message may need to be changed, e.g.:
|
|
|
|
@code
|
|
|
|
wxMessageDialog dlg(...);
|
|
|
|
if ( dlg.SetYesNoLabels(_("&Quit"), _("&Don't quit")) )
|
|
|
|
dlg.SetMessage(_("What do you want to do?"));
|
|
|
|
else // buttons have standard "Yes"/"No" values, so rephrase the question
|
|
|
|
dlg.SetMessage(_("Do you really want to quit?"));
|
|
|
|
@endcode
|
2008-03-08 08:52:38 -05:00
|
|
|
*/
|
2008-09-27 07:21:10 -04:00
|
|
|
virtual bool SetYesNoLabels(const ButtonLabel& yes, const ButtonLabel& no);
|
2008-03-08 08:52:38 -05:00
|
|
|
|
|
|
|
/**
|
2008-10-11 09:10:48 -04:00
|
|
|
Shows the dialog, returning one of wxID_OK, wxID_CANCEL, wxID_YES, wxID_NO.
|
2008-06-21 19:05:38 -04:00
|
|
|
|
|
|
|
Notice that this method returns the identifier of the button which was
|
|
|
|
clicked unlike wxMessageBox() function.
|
2008-03-08 08:52:38 -05:00
|
|
|
*/
|
2008-09-27 07:21:10 -04:00
|
|
|
virtual int ShowModal();
|
2008-03-08 08:52:38 -05:00
|
|
|
};
|
|
|
|
|
|
|
|
|
2008-03-10 11:24:38 -04:00
|
|
|
|
2008-03-08 08:52:38 -05:00
|
|
|
// ============================================================================
|
|
|
|
// Global functions/macros
|
|
|
|
// ============================================================================
|
|
|
|
|
2009-01-05 15:48:06 -05:00
|
|
|
/** @addtogroup group_funcmacro_dialog */
|
2008-03-18 15:30:01 -04:00
|
|
|
//@{
|
|
|
|
|
2008-03-08 08:52:38 -05:00
|
|
|
/**
|
2008-06-21 19:05:38 -04:00
|
|
|
Show a general purpose message dialog.
|
|
|
|
|
|
|
|
This is a convenient function which is usually used instead of using
|
|
|
|
wxMessageDialog directly. Notice however that some of the features, such as
|
|
|
|
extended text and custom labels for the message box buttons, are not
|
|
|
|
provided by this function but only by wxMessageDialog.
|
|
|
|
|
|
|
|
The return value is one of: @c wxYES, @c wxNO, @c wxCANCEL or @c wxOK
|
|
|
|
(notice that this return value is @b different from the return value of
|
|
|
|
wxMessageDialog::ShowModal()).
|
2008-03-09 08:33:59 -04:00
|
|
|
|
2008-06-21 19:05:38 -04:00
|
|
|
For example:
|
2008-03-08 08:52:38 -05:00
|
|
|
@code
|
2008-03-18 15:30:01 -04:00
|
|
|
int answer = wxMessageBox("Quit program?", "Confirm",
|
|
|
|
wxYES_NO | wxCANCEL, main_frame);
|
|
|
|
if (answer == wxYES)
|
|
|
|
main_frame->Close();
|
2008-03-08 08:52:38 -05:00
|
|
|
@endcode
|
2008-03-08 09:43:31 -05:00
|
|
|
|
2008-03-18 15:30:01 -04:00
|
|
|
@a message may contain newline characters, in which case the message will
|
|
|
|
be split into separate lines, to cater for large messages.
|
|
|
|
|
2008-06-21 19:05:38 -04:00
|
|
|
@param message
|
|
|
|
Message to show in the dialog.
|
|
|
|
@param caption
|
|
|
|
The dialog title.
|
|
|
|
@param parent
|
|
|
|
Parent window.
|
|
|
|
@param style
|
|
|
|
Combination of style flags described in wxMessageDialog documentation.
|
|
|
|
@param x
|
2009-03-13 20:49:24 -04:00
|
|
|
Horizontal dialog position (ignored under MSW). Use ::wxDefaultCoord
|
2008-06-21 19:05:38 -04:00
|
|
|
for @a x and @a y to let the system position the window.
|
|
|
|
@param y
|
|
|
|
Vertical dialog position (ignored under MSW).
|
2008-03-18 15:30:01 -04:00
|
|
|
@header{wx/msgdlg.h}
|
2008-03-08 08:52:38 -05:00
|
|
|
*/
|
|
|
|
int wxMessageBox(const wxString& message,
|
|
|
|
const wxString& caption = "Message",
|
|
|
|
int style = wxOK,
|
2008-03-09 08:33:59 -04:00
|
|
|
wxWindow* parent = NULL,
|
2008-06-21 19:05:38 -04:00
|
|
|
int x = wxDefaultCoord,
|
|
|
|
int y = wxDefaultCoord);
|
2008-03-08 08:52:38 -05:00
|
|
|
|
2008-03-18 15:30:01 -04:00
|
|
|
//@}
|
|
|
|
|