This class represents a dialog that shows a single or multi-line message,
with a choice of OK, Yes, No and Cancel buttons.
+ @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_NONE}
+ Displays no icon in the dialog if possible (an icon might still be
+ displayed if the current platform mandates its use). This style may be
+ used to prevent the dialog from using the default icon based on @c
+ wxYES_NO presence as explained in @c wxICON_QUESTION and @c
+ wxICON_INFORMATION documentation below.
+ @style{wxICON_EXCLAMATION}
+ Displays an exclamation, or warning, icon in the dialog.
+ @style{wxICON_ERROR}
+ Displays an error icon in the dialog.
+ @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 and not only
+ just its parent (currently implemented only under MSW and GTK).
+ @endStyleTable
+
@library{wxcore}
@category{cmndlg}
Constructor specifying the message box properties.
Use ShowModal() to show the dialog.
- @a style may be a bit list of the following identifiers:
-
- @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
+ @a style may be a bit list of the identifiers described above.
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
Dialog position (ignored under MSW).
*/
wxMessageDialog(wxWindow* parent, const wxString& message,
- const wxString& caption = "Message box",
+ const wxString& caption = wxMessageBoxCaptionStr,
long style = wxOK | wxCENTRE,
const wxPoint& pos = wxDefaultPosition);
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
- successfully, the main dialog message may need to be changed, e.g.:
+ couldn't be changed. If it returns @true, the labels were set
+ successfully.
+
+ Typically, if the function was used successfully, the main dialog
+ message may need to be changed, e.g.:
@code
wxMessageDialog dlg(...);
if ( dlg.SetYesNoLabels(_("&Quit"), _("&Don't quit")) )
// Global functions/macros
// ============================================================================
-/** @ingroup group_funcmacro_dialog */
+/** @addtogroup group_funcmacro_dialog */
//@{
/**
@param style
Combination of style flags described in wxMessageDialog documentation.
@param x
- Horizontal dialog position (ignored under MSW). Use @c wxDefaultCoord
+ Horizontal dialog position (ignored under MSW). Use ::wxDefaultCoord
for @a x and @a y to let the system position the window.
@param y
Vertical dialog position (ignored under MSW).
projects / wxWidgets.git / blobdiff