1QMessageBox(3qt) QMessageBox(3qt)
2
6 QMessageBox - Modal dialog with a short message, an icon, and some
7 buttons
8
10 #include <qmessagebox.h>
11 Inherits QDialog.
13 Public Members
15 enum Icon { NoIcon = 0, Information = 1, Warning = 2, Critical = 3,
16 Question = 4 }
17 QMessageBox ( QWidget * parent = 0, const char * name = 0 )
18 QMessageBox ( const QString & caption, const QString & text, Icon icon,
19 int button0, int button1, int button2, QWidget * parent = 0, const
20 char * name = 0, bool modal = TRUE, WFlags f = WStyle_DialogBorder
21 )
22 ~QMessageBox ()
23 QString text () const
24 void setText ( const QString & )
25 Icon icon () const
26 void setIcon ( Icon )
27 const QPixmap * iconPixmap () const
28 void setIconPixmap ( const QPixmap & )
29 QString buttonText ( int button ) const
30 void setButtonText ( int button, const QString & text )
31 virtual void adjustSize ()
32 TextFormat textFormat () const
33 void setTextFormat ( TextFormat )
34 Static Public Members
36 int information ( QWidget * parent, const QString & caption, const
37 QString & text, int button0, int button1 = 0, int button2 = 0 )
38 int information ( QWidget * parent, const QString & caption, const
39 QString & text, const QString & button0Text = QString::null, const
40 QString & button1Text = QString::null, const QString & button2Text
41 = QString::null, int defaultButtonNumber = 0, int
42 escapeButtonNumber = -1 )
43 int question ( QWidget * parent, const QString & caption, const QString
44 & text, int button0, int button1 = 0, int button2 = 0 )
45 int question ( QWidget * parent, const QString & caption, const QString
46 & text, const QString & button0Text = QString::null, const QString
47 & button1Text = QString::null, const QString & button2Text =
48 QString::null, int defaultButtonNumber = 0, int escapeButtonNumber
49 = -1 )
50 int warning ( QWidget * parent, const QString & caption, const QString
51 & text, int button0, int button1, int button2 = 0 )
52 int warning ( QWidget * parent, const QString & caption, const QString
53 & text, const QString & button0Text = QString::null, const QString
54 & button1Text = QString::null, const QString & button2Text =
55 QString::null, int defaultButtonNumber = 0, int escapeButtonNumber
56 = -1 )
57 int critical ( QWidget * parent, const QString & caption, const QString
58 & text, int button0, int button1, int button2 = 0 )
59 int critical ( QWidget * parent, const QString & caption, const QString
60 & text, const QString & button0Text = QString::null, const QString
61 & button1Text = QString::null, const QString & button2Text =
62 QString::null, int defaultButtonNumber = 0, int escapeButtonNumber
63 = -1 )
64 void about ( QWidget * parent, const QString & caption, const QString &
65 text )
66 void aboutQt ( QWidget * parent, const QString & caption =
67 QString::null )
68 int message ( const QString & caption, const QString & text, const
69 QString & buttonText = QString::null, QWidget * parent = 0, const
70 char * = 0 ) (obsolete)
71 bool query ( const QString & caption, const QString & text, const
72 QString & yesButtonText = QString::null, const QString &
73 noButtonText = QString::null, QWidget * parent = 0, const char * =
74 0 ) (obsolete)
75 QPixmap standardIcon ( Icon icon, GUIStyle style ) (obsolete)
76 QPixmap standardIcon ( Icon icon )
77 Properties
79 Icon icon - the message box's icon
80 QPixmap iconPixmap - the current icon
81 QString text - the message box text to be displayed
82 TextFormat textFormat - the format of the text displayed by the message
83 box
84
86 The QMessageBox class provides a modal dialog with a short message, an
87 icon, and some buttons.
88 Message boxes are used to provide informative messages and to ask
90 simple questions.
91 QMessageBox provides a range of different messages, arranged roughly
93 along two axes: severity and complexity.
94 Severity is <center>.nf
96 </center>
98 The message box has a different icon for each of the severity levels.
100 Complexity is one button (OK) for simple messages, or two or even three
102 buttons for questions.
103 There are static functions for the most common cases.
105 Examples:
107 If a program is unable to find a supporting file, but can do perfectly
109 well without it:
110 QMessageBox::information( this, "Application name",
112 "Unable to find the user preferences file.\n"
113 "The factory default will be used instead." );
114 question() is useful for simple yes/no questions:
116 if ( QFile::exists( filename ) &&
118 QMessageBox::question(
119 this,
120 tr("Overwrite File? -- Application Name"),
121 tr("A file called %1 already exists."
122 "Do you want to overwrite it?")
123 .arg( filename ),
124 tr("&Yes"), tr("&No"),
125 QString::null, 0, 1 ) )
126 return false;
127 warning() can be used to tell the user about unusual errors, or errors
129 which can't be easily fixed:
130 switch( QMessageBox::warning( this, "Application name",
132 "Could not connect to the <mumble> server.\n"
133 "This program can't function correctly "
134 "without the server.\n\n",
135 "Retry",
136 "Quit", 0, 0, 1 ) ) {
137 case 0: // The user clicked the Retry again button or pressed Enter
138 // try again
139 break;
140 case 1: // The user clicked the Quit or pressed Escape
141 // exit
142 break;
143 }
144 The text part of all message box messages can be either rich text or
146 plain text. If you specify a rich text formatted string, it will be
147 rendered using the default stylesheet. See QStyleSheet::defaultSheet()
148 for details. With certain strings that contain XML meta characters, the
149 auto-rich text detection may fail, interpreting plain text incorrectly
150 as rich text. In these rare cases, use
151 QStyleSheet::convertFromPlainText() to convert your plain text string
152 to a visually equivalent rich text string or set the text format
153 explicitly with setTextFormat().
154 Note that the Microsoft Windows User Interface Guidelines recommend
156 using the application name as the window's caption.
157 Below are more examples of how to use the static member functions.
159 After these examples you will find an overview of the non-static member
160 functions.
161 Exiting a program is part of its normal operation. If there is unsaved
163 data the user probably should be asked if they want to save the data.
164 For example:
165 switch( QMessageBox::information( this, "Application name here",
167 "The document contains unsaved changes\n"
168 "Do you want to save the changes before exiting?",
169 "&Save", "&Discard", "Cancel",
170 0, // Enter == button 0
171 2 ) ) { // Escape == button 2
172 case 0: // Save clicked or Alt+S pressed or Enter pressed.
173 // save
174 break;
175 case 1: // Discard clicked or Alt+D pressed
176 // don't save but exit
177 break;
178 case 2: // Cancel clicked or Escape pressed
179 // don't exit
180 break;
181 }
182 The Escape button cancels the entire exit operation, and pressing Enter
184 causes the changes to be saved before the exit occurs.
185 Disk full errors are unusual and they certainly can be hard to correct.
187 This example uses predefined buttons instead of hard-coded button
188 texts:
189 switch( QMessageBox::warning( this, "Application name here",
191 "Could not save the user preferences,\n"
192 "because the disk is full. You can delete\n"
193 "some files and press Retry, or you can\n"
194 "abort the Save Preferences operation.",
195 QMessageBox::Retry | QMessageBox::Default,
196 QMessageBox::Abort | QMessageBox::Escape )) {
197 case QMessageBox::Retry: // Retry clicked or Enter pressed
198 // try again
199 break;
200 case QMessageBox::Abort: // Abort clicked or Escape pressed
201 // abort
202 break;
203 }
204 The critical() function should be reserved for critical errors. In this
206 example errorDetails is a QString or const char*, and QString is used
207 to concatenate several strings:
208 QMessageBox::critical( 0, "Application name here",
210 QString("An internal error occurred. Please ") +
211 "call technical support at 1234-56789 and report\n"+
212 "these numbers:\n\n" + errorDetails +
213 "\n\nApplication will now exit." );
214 In this example an OK button is displayed.
216 QMessageBox provides a very simple About box which displays an
218 appropriate icon and the string you provide:
219 QMessageBox::about( this, "About <Application>",
221 "<Application> is a <one-paragraph blurb>\n\n"
222 "Copyright 1991-2003 Such-and-such. "
223 "<License words here.>\n\n"
224 "For technical support, call 1234-56789 or see\n"
225 "http://www.such-and-such.com/Application/\n" );
226 See about() for more information.
228 If you want your users to know that the application is built using Qt
230 (so they know that you use high quality tools) you might like to add an
231 "About Qt" menu option under the Help menu to invoke aboutQt().
232 If none of the standard message boxes is suitable, you can create a
234 QMessageBox from scratch and use custom button texts:
235 QMessageBox mb( "Application name here",
237 "Saving the file will overwrite the original file on the disk.\n"
238 "Do you really want to save?",
239 QMessageBox::Information,
240 QMessageBox::Yes | QMessageBox::Default,
241 QMessageBox::No,
242 QMessageBox::Cancel | QMessageBox::Escape );
243 mb.setButtonText( QMessageBox::Yes, "Save" );
244 mb.setButtonText( QMessageBox::No, "Discard" );
245 switch( mb.exec() ) {
246 case QMessageBox::Yes:
247 // save and exit
248 break;
249 case QMessageBox::No:
250 // exit without saving
251 break;
252 case QMessageBox::Cancel:
253 // don't save and don't exit
254 break;
255 }
256 QMessageBox defines two enum types: Icon and an unnamed button type.
258 Icon defines the Question, Information, Warning, and Critical icons for
259 each GUI style. It is used by the constructor and by the static member
260 functions question(), information(), warning() and critical(). A
261 function called standardIcon() gives you access to the various icons.
262 The button types are:
264 Ok - the default for single-button message boxes
266 Cancel - note that this is not automatically Escape
268 Yes
270 No
272 Abort
274 Retry
276 Ignore
278 YesAll
280 NoAll
282 Button types can be combined with two modifiers by using OR, '|':
284 Default - makes pressing Enter equivalent to clicking this button.
286 Normally used with Ok, Yes or similar.
287 Escape - makes pressing Escape equivalent to clicking this button.
289 Normally used with Abort, Cancel or similar.
290 The text(), icon() and iconPixmap() functions provide access to the
292 current text and pixmap of the message box. The setText(), setIcon()
293 and setIconPixmap() let you change it. The difference between setIcon()
294 and setIconPixmap() is that the former accepts a QMessageBox::Icon and
295 can be used to set standard icons, whereas the latter accepts a QPixmap
296 and can be used to set custom icons.
297 setButtonText() and buttonText() provide access to the buttons.
299 QMessageBox has no signals or slots.
301 [Image Omitted]
303 [Image Omitted]
305 See also QDialog, Isys on error messages, GUI Design Handbook: Message
307 Box, and Dialog Classes.
308 Member Type Documentation
311 This enum has the following values:
312 QMessageBox::NoIcon - the message box does not have any icon.
314 QMessageBox::Question - an icon indicating that the message is asking a
316 question.
317 QMessageBox::Information - an icon indicating that the message is
319 nothing out of the ordinary.
320 QMessageBox::Warning - an icon indicating that the message is a
322 warning, but can be dealt with.
323 QMessageBox::Critical - an icon indicating that the message represents
325 a critical problem.
326
329 Constructs a message box with no text and a button with the label" OK".
330 If parent is 0, the message box becomes an application-global modal
332 dialog box. If parent is a widget, the message box becomes modal
333 relative to parent.
334 The parent and name arguments are passed to the QDialog constructor.
336
338 icon, int button0, int button1, int button2, QWidget * parent = 0,
339 const char * name = 0, bool modal = TRUE, WFlags f =
340 WStyle_DialogBorder )
341 Constructs a message box with a caption, a text, an icon, and up to
342 three buttons.
343 The icon must be one of the following:
345 QMessageBox::NoIcon
347 QMessageBox::Question
349 QMessageBox::Information
351 QMessageBox::Warning
353 QMessageBox::Critical
355 Each button, button0, button1 and button2, can have one of the
357 following values:
358 QMessageBox::NoButton
360 QMessageBox::Ok
362 QMessageBox::Cancel
364 QMessageBox::Yes
366 QMessageBox::No
368 QMessageBox::Abort
370 QMessageBox::Retry
372 QMessageBox::Ignore
374 QMessageBox::YesAll
376 QMessageBox::NoAll
378 Use QMessageBox::NoButton for the later parameters to have fewer than
380 three buttons in your message box. If you don't specify any buttons at
381 all, QMessageBox will provide an Ok button.
382 One of the buttons can be OR-ed with the QMessageBox::Default flag to
384 make it the default button (clicked when Enter is pressed).
385 One of the buttons can be OR-ed with the QMessageBox::Escape flag to
387 make it the cancel or close button (clicked when Escape is pressed).
388 Example:
390 QMessageBox mb( "Application Name",
392 "Hardware failure.\n\nDisk error detected\nDo you want to stop?",
393 QMessageBox::Question,
394 QMessageBox::Yes | QMessageBox::Default,
395 QMessageBox::No | QMessageBox::Escape,
396 QMessageBox::NoButton );
397 if ( mb.exec() == QMessageBox::No )
398 // try again
399 If parent is 0, the message box becomes an application-global modal
401 dialog box. If parent is a widget, the message box becomes modal
402 relative to parent.
403 If modal is TRUE the message box is modal; otherwise it is modeless.
405 The parent, name, modal, and f arguments are passed to the QDialog
407 constructor.
408 See also caption, text, and icon.
410
412 Destroys the message box.
413
415 QString & text ) [static]
416 Displays a simple about box with caption caption and text text. The
417 about box's parent is parent.
418 about() looks for a suitable icon in four locations: <ol type=1>
420 It prefers parent->icon() if that exists.
422 If not, it tries the top-level widget containing parent.
424 If that fails, it tries the main widget.
426 As a last resort it uses the Information icon.
428 The about box has a single button labelled "OK".
430 See also QWidget::icon and QApplication::mainWidget().
432 Examples:
434
436 QString::null ) [static]
437 Displays a simple message box about Qt, with caption caption and
438 centered over parent (if parent is not 0). The message includes the
439 version number of Qt being used by the application.
440 This is useful for inclusion in the Help menu of an application. See
442 the examples/menu/menu.cpp example.
443 QApplication provides this functionality as a slot.
445 See also QApplication::aboutQt().
447 Examples:
449
451 Adjusts the size of the message box to fit the contents just before
452 QDialog::exec() or QDialog::show() is called.
453 This function will not be called if the message box has been explicitly
455 resized before showing it.
456 Reimplemented from QWidget.
458
460 Returns the text of the message box button button, or QString::null if
461 the message box does not contain the button.
462 See also setButtonText().
464
466 QString & text, int button0, int button1, int button2 = 0 ) [static]
467 Opens a critical message box with the caption caption and the text
468 text. The dialog may have up to three buttons. Each of the button
469 parameters, button0, button1 and button2 may be set to one of the
470 following values:
471 QMessageBox::NoButton
473 QMessageBox::Ok
475 QMessageBox::Cancel
477 QMessageBox::Yes
479 QMessageBox::No
481 QMessageBox::Abort
483 QMessageBox::Retry
485 QMessageBox::Ignore
487 QMessageBox::YesAll
489 QMessageBox::NoAll
491 If you don't want all three buttons, set the last button, or last two
493 buttons to QMessageBox::NoButton.
494 One button can be OR-ed with QMessageBox::Default, and one button can
496 be OR-ed with QMessageBox::Escape.
497 Returns the identity (QMessageBox::Ok, or QMessageBox::No, etc.) of the
499 button that was clicked.
500 If parent is 0, the message box becomes an application-global modal
502 dialog box. If parent is a widget, the message box becomes modal
503 relative to parent.
504 See also information(), question(), and warning().
506 Examples:
508
510 QString & text, const QString & button0Text = QString::null, const
511 QString & button1Text = QString::null, const QString & button2Text =
512 QString::null, int defaultButtonNumber = 0, int escapeButtonNumber = -1
513 ) [static]
514 This is an overloaded member function, provided for convenience. It
515 behaves essentially like the above function.
516 Displays a critical error message box with a caption, a text, and 1, 2
518 or 3 buttons. Returns the number of the button that was clicked (0, 1
519 or 2).
520 button0Text is the text of the first button, and is optional. If
522 button0Text is not supplied, "OK" (translated) will be used.
523 button1Text is the text of the second button, and is optional, and
524 button2Text is the text of the third button, and is optional.
525 defaultButtonNumber (0, 1 or 2) is the index of the default button;
526 pressing Return or Enter is the same as clicking the default button. It
527 defaults to 0 (the first button). escapeButtonNumber is the index of
528 the Escape button; pressing Escape is the same as clicking this button.
529 It defaults to -1; supply 0, 1, or 2 to make pressing Escape equivalent
530 to clicking the relevant button.
531 If parent is 0, the message box becomes an application-global modal
533 dialog box. If parent is a widget, the message box becomes modal
534 relative to parent.
535 See also information(), question(), and warning().
537
539 Returns the message box's icon. See the "icon" property for details.
540
542 Returns the current icon. See the "iconPixmap" property for details.
543
545 const QString & text, int button0, int button1 = 0, int button2 = 0 )
546 [static]
547 Opens an information message box with the caption caption and the text
548 text. The dialog may have up to three buttons. Each of the buttons,
549 button0, button1 and button2 may be set to one of the following values:
550 QMessageBox::NoButton
552 QMessageBox::Ok
554 QMessageBox::Cancel
556 QMessageBox::Yes
558 QMessageBox::No
560 QMessageBox::Abort
562 QMessageBox::Retry
564 QMessageBox::Ignore
566 QMessageBox::YesAll
568 QMessageBox::NoAll
570 If you don't want all three buttons, set the last button, or last two
572 buttons to QMessageBox::NoButton.
573 One button can be OR-ed with QMessageBox::Default, and one button can
575 be OR-ed with QMessageBox::Escape.
576 Returns the identity (QMessageBox::Ok, or QMessageBox::No, etc.) of the
578 button that was clicked.
579 If parent is 0, the message box becomes an application-global modal
581 dialog box. If parent is a widget, the message box becomes modal
582 relative to parent.
583 See also question(), warning(), and critical().
585 Examples:
587
589 const QString & text, const QString & button0Text = QString::null,
590 const QString & button1Text = QString::null, const QString &
591 button2Text = QString::null, int defaultButtonNumber = 0, int
592 escapeButtonNumber = -1 ) [static]
593 This is an overloaded member function, provided for convenience. It
594 behaves essentially like the above function.
595 Displays an information message box with caption caption, text text and
597 one, two or three buttons. Returns the index of the button that was
598 clicked (0, 1 or 2).
599 button0Text is the text of the first button, and is optional. If
601 button0Text is not supplied, "OK" (translated) will be used.
602 button1Text is the text of the second button, and is optional.
603 button2Text is the text of the third button, and is optional.
604 defaultButtonNumber (0, 1 or 2) is the index of the default button;
605 pressing Return or Enter is the same as clicking the default button. It
606 defaults to 0 (the first button). escapeButtonNumber is the index of
607 the Escape button; pressing Escape is the same as clicking this button.
608 It defaults to -1; supply 0, 1 or 2 to make pressing Escape equivalent
609 to clicking the relevant button.
610 If parent is 0, the message box becomes an application-global modal
612 dialog box. If parent is a widget, the message box becomes modal
613 relative to parent.
614 Note: If you do not specify an Escape button then if the Escape button
616 is pressed then -1 will be returned. It is suggested that you specify
617 an Escape button to prevent this from happening.
618 See also question(), warning(), and critical().
620
622 const QString & buttonText = QString::null, QWidget * parent = 0, const
623 char * = 0 ) [static]
624 This function is obsolete. It is provided to keep old source working.
625 We strongly advise against using it in new code.
626 Opens a modal message box directly using the specified parameters.
628 Please use information(), warning(), question(), or critical() instead.
630 Example: grapher/grapher.cpp.
632
634 QString & yesButtonText = QString::null, const QString & noButtonText =
635 QString::null, QWidget * parent = 0, const char * = 0 ) [static]
636 This function is obsolete. It is provided to keep old source working.
637 We strongly advise against using it in new code.
638 Queries the user using a modal message box with two buttons. Note that
640 caption is not always shown, it depends on the window manager.
641 Please use information(), question(), warning(), or critical() instead.
643
645 QString & text, int button0, int button1 = 0, int button2 = 0 )
646 [static]
647 Opens a question message box with the caption caption and the text
648 text. The dialog may have up to three buttons. Each of the buttons,
649 button0, button1 and button2 may be set to one of the following values:
650 QMessageBox::NoButton
652 QMessageBox::Ok
654 QMessageBox::Cancel
656 QMessageBox::Yes
658 QMessageBox::No
660 QMessageBox::Abort
662 QMessageBox::Retry
664 QMessageBox::Ignore
666 QMessageBox::YesAll
668 QMessageBox::NoAll
670 If you don't want all three buttons, set the last button, or last two
672 buttons to QMessageBox::NoButton.
673 One button can be OR-ed with QMessageBox::Default, and one button can
675 be OR-ed with QMessageBox::Escape.
676 Returns the identity (QMessageBox::Yes, or QMessageBox::No, etc.) of
678 the button that was clicked.
679 If parent is 0, the message box becomes an application-global modal
681 dialog box. If parent is a widget, the message box becomes modal
682 relative to parent.
683 See also information(), warning(), and critical().
685
687 QString & text, const QString & button0Text = QString::null, const
688 QString & button1Text = QString::null, const QString & button2Text =
689 QString::null, int defaultButtonNumber = 0, int escapeButtonNumber = -1
690 ) [static]
691 This is an overloaded member function, provided for convenience. It
692 behaves essentially like the above function.
693 Displays a question message box with caption caption, text text and
695 one, two or three buttons. Returns the index of the button that was
696 clicked (0, 1 or 2).
697 button0Text is the text of the first button, and is optional. If
699 button0Text is not supplied, "OK" (translated) will be used.
700 button1Text is the text of the second button, and is optional.
701 button2Text is the text of the third button, and is optional.
702 defaultButtonNumber (0, 1 or 2) is the index of the default button;
703 pressing Return or Enter is the same as clicking the default button. It
704 defaults to 0 (the first button). escapeButtonNumber is the index of
705 the Escape button; pressing Escape is the same as clicking this button.
706 It defaults to -1; supply 0, 1 or 2 to make pressing Escape equivalent
707 to clicking the relevant button.
708 If parent is 0, the message box becomes an application-global modal
710 dialog box. If parent is a widget, the message box becomes modal
711 relative to parent.
712 Note: If you do not specify an Escape button then if the Escape button
714 is pressed then -1 will be returned. It is suggested that you specify
715 an Escape button to prevent this from happening.
716 See also information(), warning(), and critical().
718
720 Sets the text of the message box button button to text. Setting the
721 text of a button that is not in the message box is silently ignored.
722 See also buttonText().
724
726 Sets the message box's icon. See the "icon" property for details.
727
729 Sets the current icon. See the "iconPixmap" property for details.
730
732 Sets the message box text to be displayed. See the "text" property for
733 details.
734
736 Sets the format of the text displayed by the message box. See the
737 "textFormat" property for details.
738
740 Returns the pixmap used for a standard icon. This allows the pixmaps to
741 be used in more complex message boxes. icon specifies the required
742 icon, e.g. QMessageBox::Question, QMessageBox::Information,
743 QMessageBox::Warning or QMessageBox::Critical.
744
746 This function is obsolete. It is provided to keep old source working.
747 We strongly advise against using it in new code.
748 Returns the pixmap used for a standard icon. This allows the pixmaps to
750 be used in more complex message boxes. icon specifies the required
751 icon, e.g. QMessageBox::Information, QMessageBox::Warning or
752 QMessageBox::Critical.
753 style is unused.
755
757 Returns the message box text to be displayed. See the "text" property
758 for details.
759
761 Returns the format of the text displayed by the message box. See the
762 "textFormat" property for details.
763
765 QString & text, int button0, int button1, int button2 = 0 ) [static]
766 Opens a warning message box with the caption caption and the text text.
767 The dialog may have up to three buttons. Each of the button parameters,
768 button0, button1 and button2 may be set to one of the following values:
769 QMessageBox::NoButton
771 QMessageBox::Ok
773 QMessageBox::Cancel
775 QMessageBox::Yes
777 QMessageBox::No
779 QMessageBox::Abort
781 QMessageBox::Retry
783 QMessageBox::Ignore
785 QMessageBox::YesAll
787 QMessageBox::NoAll
789 If you don't want all three buttons, set the last button, or last two
791 buttons to QMessageBox::NoButton.
792 One button can be OR-ed with QMessageBox::Default, and one button can
794 be OR-ed with QMessageBox::Escape.
795 Returns the identity (QMessageBox::Ok, or QMessageBox::No, etc.) of the
797 button that was clicked.
798 If parent is 0, the message box becomes an application-global modal
800 dialog box. If parent is a widget, the message box becomes modal
801 relative to parent.
802 See also information(), question(), and critical().
804 Examples:
806
808 QString & text, const QString & button0Text = QString::null, const
809 QString & button1Text = QString::null, const QString & button2Text =
810 QString::null, int defaultButtonNumber = 0, int escapeButtonNumber = -1
811 ) [static]
812 This is an overloaded member function, provided for convenience. It
813 behaves essentially like the above function.
814 Displays a warning message box with a caption, a text, and 1, 2 or 3
816 buttons. Returns the number of the button that was clicked (0, 1, or
817 2).
818 button0Text is the text of the first button, and is optional. If
820 button0Text is not supplied, "OK" (translated) will be used.
821 button1Text is the text of the second button, and is optional, and
822 button2Text is the text of the third button, and is optional.
823 defaultButtonNumber (0, 1 or 2) is the index of the default button;
824 pressing Return or Enter is the same as clicking the default button. It
825 defaults to 0 (the first button). escapeButtonNumber is the index of
826 the Escape button; pressing Escape is the same as clicking this button.
827 It defaults to -1; supply 0, 1, or 2 to make pressing Escape equivalent
828 to clicking the relevant button.
829 If parent is 0, the message box becomes an application-global modal
831 dialog box. If parent is a widget, the message box becomes modal
832 relative to parent.
833 Note: If you do not specify an Escape button then if the Escape button
835 is pressed then -1 will be returned. It is suggested that you specify
836 an Escape button to prevent this from happening.
837 See also information(), question(), and critical().
839 Property Documentation
842 This property holds the message box's icon.
843 The icon of the message box can be one of the following predefined
845 icons:
846 QMessageBox::NoIcon
848 QMessageBox::Question
850 QMessageBox::Information
852 QMessageBox::Warning
854 QMessageBox::Critical
856 The actual pixmap used for displaying the icon depends on the current
858 GUI style. You can also set a custom pixmap icon using the
859 QMessageBox::iconPixmap property. The default icon is
860 QMessageBox::NoIcon.
861 See also iconPixmap.
863 Set this property's value with setIcon() and get this property's value
865 with icon().
866
868 This property holds the current icon.
869 The icon currently used by the message box. Note that it's often hard
871 to draw one pixmap that looks appropriate in both Motif and Windows GUI
872 styles; you may want to draw two pixmaps.
873 See also icon.
875 Set this property's value with setIconPixmap() and get this property's
877 value with iconPixmap().
878
880 This property holds the message box text to be displayed.
881 The text will be interpreted either as a plain text or as rich text,
883 depending on the text format setting (QMessageBox::textFormat). The
884 default setting is AutoText, i.e. the message box will try to auto-
885 detect the format of the text.
886 The default value of this property is QString::null.
888 See also textFormat.
890 Set this property's value with setText() and get this property's value
892 with text().
893
895 This property holds the format of the text displayed by the message
896 box.
897 The current text format used by the message box. See the Qt::TextFormat
899 enum for an explanation of the possible options.
900 The default format is AutoText.
902 See also text.
904 Set this property's value with setTextFormat() and get this property's
906 value with textFormat().
907
910 http://doc.trolltech.com/qmessagebox.html
911 http://www.trolltech.com/faq/tech.html
912
914 Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the
915 license file included in the distribution for a complete license
916 statement.
917
919 Generated automatically from the source code.
920
922 If you find a bug in Qt, please report it as described in
923 http://doc.trolltech.com/bughowto.html. Good bug reports help us to
924 help you. Thank you.
925 The definitive Qt documentation is provided in HTML format; it is
927 located at $QTDIR/doc/html and can be read using Qt Assistant or with a
928 web browser. This man page is provided as a convenience for those users
929 who prefer man pages, although this format is not officially supported
930 by Trolltech.
931 If you find errors in this manual page, please report them to qt-
933 bugs@trolltech.com. Please include the name of the manual page
934 (qmessagebox.3qt) and the Qt version (3.3.8).
935Trolltech AS 2 February 2007 QMessageBox(3qt)