Context Navigation

← Previous Revision
Next Revision →
Blame
Revision Log

qmessagebox.cpp

Last change on this file was 21, checked in by dmik, 20 years ago
Fixed one more compiler warning
Property svn:keywords set to `Id`
File size: 52.6 KB

Line
1	/****************************************************************************
2	** $Id: qmessagebox.cpp 21 2005-11-17 19:51:23Z dmik $
3	**
4	** Implementation of QMessageBox class
5	**
6	** Created : 950503
7	**
8	** Copyright (C) 1992-2003 Trolltech AS. All rights reserved.
9	**
10	** This file is part of the dialogs module of the Qt GUI Toolkit.
11	**
12	** This file may be distributed under the terms of the Q Public License
13	** as defined by Trolltech AS of Norway and appearing in the file
14	** LICENSE.QPL included in the packaging of this file.
15	**
16	** This file may be distributed and/or modified under the terms of the
17	** GNU General Public License version 2 as published by the Free Software
18	** Foundation and appearing in the file LICENSE.GPL included in the
19	** packaging of this file.
20	**
21	** Licensees holding valid Qt Enterprise Edition or Qt Professional Edition
22	** licenses may use this file in accordance with the Qt Commercial License
23	** Agreement provided with the Software.
24	**
25	** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
26	** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
27	**
28	** See http://www.trolltech.com/pricing.html or email sales@trolltech.com for
29	** information about Qt Commercial License Agreements.
30	** See http://www.trolltech.com/qpl/ for QPL licensing information.
31	** See http://www.trolltech.com/gpl/ for GPL licensing information.
32	**
33	** Contact info@trolltech.com if any conditions of this licensing are
34	** not clear to you.
35	**
36	**********************************************************************/
37
38	#include "qmessagebox.h"
39
40	#ifndef QT_NO_MESSAGEBOX
41
42	#include "qaccel.h"
43	#include "qlabel.h"
44	#include "qpushbutton.h"
45	#include "qimage.h"
46	#include "qapplication.h"
47	#include "qstyle.h"
48	#include "qobjectlist.h"
49	#if defined(QT_ACCESSIBILITY_SUPPORT)
50	#include "qaccessible.h"
51	#endif
52	#if defined QT_NON_COMMERCIAL
53	#include "qnc_win.h"
54	#endif
55	#if defined(Q_WS_PM)
56	//@@TODO (dmik): this is necessary for WinAlarm() which will be
57	// probably removed from here later.
58	#include "qt_os2.h"
59	#endif
60
61	// Internal class - don't touch
62
63	class QMessageBoxLabel : public QLabel
64	{
65	Q_OBJECT
66	public:
67	QMessageBoxLabel( QWidget* parent ) : QLabel( parent, "messageBoxText")
68	{
69	setAlignment( AlignAuto\|ExpandTabs );
70	}
71	};
72	#include "qmessagebox.moc"
73
74
75
76	// the Qt logo, for aboutQt
77	/* XPM */
78	static const char * const qtlogo_xpm[] = {
79	/* width height ncolors chars_per_pixel */
80	"50 50 17 1",
81	/* colors */
82	" c #000000",
83	". c #495808",
84	"X c #2A3304",
85	"o c #242B04",
86	"O c #030401",
87	"+ c #9EC011",
88	"@ c #93B310",
89	"# c #748E0C",
90	"$ c #A2C511",
91	"% c #8BA90E",
92	"& c #99BA10",
93	"* c #060701",
94	"= c #181D02",
95	"- c #212804",
96	"; c #61770A",
97	": c #0B0D01",
98	"/ c None",
99	/* pixels */
100	"/$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$/",
101	"$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$",
102	"$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$",
103	"$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$",
104	"$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$",
105	"$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$",
106	"$$$$$$$$$$$$$$$$$$$$$$$+++$$$$$$$$$$$$$$$$$$$$$$$$",
107	"$$$$$$$$$$$$$$$$$$$@;.o=::=o.;@$$$$$$$$$$$$$$$$$$$",
108	"$$$$$$$$$$$$$$$$+#X* **X#+$$$$$$$$$$$$$$$$",
109	"$$$$$$$$$$$$$$$#oO* O **o#+$$$$$$$$$$$$$$",
110	"$$$$$$$$$$$$$&.* OO O*.&$$$$$$$$$$$$$",
111	"$$$$$$$$$$$$@XOO * OO X&$$$$$$$$$$$$",
112	"$$$$$$$$$$$@XO OO O **:::OOO OOO X@$$$$$$$$$$$",
113	"$$$$$$$$$$&XO O-;#@++@%.oOO X&$$$$$$$$$$",
114	"$$$$$$$$$$.O : -#+$$$$$$$$+#- : O O.$$$$$$$$$$",
115	"$$$$$$$$$#OO O.&$$$$$$$$$$$$+.OOOO **#$$$$$$$$$",
116	"$$$$$$$$+-OO O ;$$$$$$$$$$$&$$$$; o+$$$$$$$$",
117	"$$$$$$$$#O* O .+$$$$$$$$$$@X;$$$+.O *#$$$$$$$$",
118	"$$$$$$$$X* -&$$$$$$$$$$@- :;$$$&- OX$$$$$$$$",
119	"$$$$$$$@O O#$$$$$$$$$$@oOO*;$$$# O%$$$$$$$",
120	"$$$$$$$; -+$$$$$$$$$@o O OO ;+$$-O *;$$$$$$$",
121	"$$$$$$$. ;$$$$$$$$$@-OO OO X&$$;O .$$$$$$$",
122	"$$$$$$$o #$$$$$$$$@o O O O-@$$$#O o$$$$$$$",
123	"$$$$$$+= @$$$$$$$@o OO -@$$$$&: =$$$$$$$",
124	"$$$$$$+: :+$$$$$$@- *-@$$$$$$: :+$$$$$$",
125	"$$$$$$+: :+$$$$$@o* O *-@$$$$$$: :+$$$$$$",
126	"$$$$$$$= :@$$$$@o*OOO -@$$$$@: =+$$$$$$",
127	"$$$$$$$- O%$$$@o* O O O O-@$$$#* OX$$$$$$$",
128	"$$$$$$$. O O;$$&o OO* *O -@$$; O.$$$$$$$",
129	"$$$$$$$;* Oo+$$;OO:OO-- Oo@+= ;$$$$$$$",
130	"$$$$$$$@* O O#$$$;OOOo@@-O Oo;O **@$$$$$$$",
131	"$$$$$$$$X* OOO-+$$$;O o@$$@- O O OX$$$$$$$$",
132	"$$$$$$$$#* * O.$$$$;X@$$$$@-O O O#$$$$$$$$",
133	"$$$$$$$$+oO O OO.+$$+&$$$$$$@-O o+$$$$$$$$",
134	"$$$$$$$$$#* **.&$$$$$$$$$$@o OO:#$$$$$$$$$",
135	"$$$$$$$$$+. O* O-#+$$$$$$$$+;O OOO:@$$$$$$$$$",
136	"$$$$$$$$$$&X *O -;#@++@#;=O O -@$$$$$$$$",
137	"$$$$$$$$$$$&X O O*O::::O OO Oo@$$$$$$$",
138	"$$$$$$$$$$$$@XOO OO O*X+$$$$$$",
139	"$$$$$$$$$$$$$&.* ** O :: *:#$$$$$$$",
140	"$$$$$$$$$$$$$$$#o*OO O Oo#@-OOO=#$$$$$$$$",
141	"$$$$$$$$$$$$$$$$+#X:* * O*X#+$$@-:#$$$$$$$$$",
142	"$$$$$$$$$$$$$$$$$$$%;.o=::=o.#@$$$$$$@X#$$$$$$$$$$",
143	"$$$$$$$$$$$$$$$$$$$$$$$$+++$$$$$$$$$$$+$$$$$$$$$$$",
144	"$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$",
145	"$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$",
146	"$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$",
147	"$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$",
148	"$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$",
149	"/$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$/",
150	};
151
152
153	/*!
154	\class QMessageBox
155	\brief The QMessageBox class provides a modal dialog with a short message, an icon, and some buttons.
156	\ingroup dialogs
157	\mainclass
158
159	Message boxes are used to provide informative messages and to ask
160	simple questions.
161
162	QMessageBox provides a range of different messages, arranged
163	roughly along two axes: severity and complexity.
164
165	Severity is
166	\table
167	\row
168	\i \img qmessagebox-quest.png
169	\i Question
170	\i For message boxes that ask a question as part of normal
171	operation. Some style guides recommend using Information for this
172	purpose.
173	\row
174	\i \img qmessagebox-info.png
175	\i Information
176	\i For message boxes that are part of normal operation.
177	\row
178	\i \img qmessagebox-warn.png
179	\i Warning
180	\i For message boxes that tell the user about unusual errors.
181	\row
182	\i \img qmessagebox-crit.png
183	\i Critical
184	\i For message boxes that tell the user about critical errors.
185	\endtable
186
187	The message box has a different icon for each of the severity levels.
188
189	Complexity is one button (OK) for simple messages, or two or even
190	three buttons for questions.
191
192	There are static functions for the most common cases.
193
194	Examples:
195
196	If a program is unable to find a supporting file, but can do perfectly
197	well without it:
198
199	\code
200	QMessageBox::information( this, "Application name",
201	"Unable to find the user preferences file.\n"
202	"The factory default will be used instead." );
203	\endcode
204
205	question() is useful for simple yes/no questions:
206
207	\code
208	if ( QFile::exists( filename ) &&
209	QMessageBox::question(
210	this,
211	tr("Overwrite File? -- Application Name"),
212	tr("A file called %1 already exists."
213	"Do you want to overwrite it?")
214	.arg( filename ),
215	tr("&Yes"), tr("&No"),
216	QString::null, 0, 1 ) )
217	return false;
218	\endcode
219
220	warning() can be used to tell the user about unusual errors, or
221	errors which can't be easily fixed:
222
223	\code
224	switch( QMessageBox::warning( this, "Application name",
225	"Could not connect to the <mumble> server.\n"
226	"This program can't function correctly "
227	"without the server.\n\n",
228	"Retry",
229	"Quit", 0, 0, 1 ) ) {
230	case 0: // The user clicked the Retry again button or pressed Enter
231	// try again
232	break;
233	case 1: // The user clicked the Quit or pressed Escape
234	// exit
235	break;
236	}
237	\endcode
238
239	The text part of all message box messages can be either rich text
240	or plain text. If you specify a rich text formatted string, it
241	will be rendered using the default stylesheet. See
242	QStyleSheet::defaultSheet() for details. With certain strings that
243	contain XML meta characters, the auto-rich text detection may
244	fail, interpreting plain text incorrectly as rich text. In these
245	rare cases, use QStyleSheet::convertFromPlainText() to convert
246	your plain text string to a visually equivalent rich text string
247	or set the text format explicitly with setTextFormat().
248
249	Note that the Microsoft Windows User Interface Guidelines
250	recommend using the application name as the window's caption.
251
252	Below are more examples of how to use the static member functions.
253	After these examples you will find an overview of the non-static
254	member functions.
255
256	Exiting a program is part of its normal operation. If there is
257	unsaved data the user probably should be asked if they want to
258	save the data. For example:
259
260	\code
261	switch( QMessageBox::information( this, "Application name here",
262	"The document contains unsaved changes\n"
263	"Do you want to save the changes before exiting?",
264	"&Save", "&Discard", "Cancel",
265	0, // Enter == button 0
266	2 ) ) { // Escape == button 2
267	case 0: // Save clicked or Alt+S pressed or Enter pressed.
268	// save
269	break;
270	case 1: // Discard clicked or Alt+D pressed
271	// don't save but exit
272	break;
273	case 2: // Cancel clicked or Escape pressed
274	// don't exit
275	break;
276	}
277	\endcode
278
279	The Escape button cancels the entire exit operation, and pressing
280	Enter causes the changes to be saved before the exit occurs.
281
282	Disk full errors are unusual and they certainly can be hard to
283	correct. This example uses predefined buttons instead of
284	hard-coded button texts:
285
286	\code
287	switch( QMessageBox::warning( this, "Application name here",
288	"Could not save the user preferences,\n"
289	"because the disk is full. You can delete\n"
290	"some files and press Retry, or you can\n"
291	"abort the Save Preferences operation.",
292	QMessageBox::Retry \| QMessageBox::Default,
293	QMessageBox::Abort \| QMessageBox::Escape )) {
294	case QMessageBox::Retry: // Retry clicked or Enter pressed
295	// try again
296	break;
297	case QMessageBox::Abort: // Abort clicked or Escape pressed
298	// abort
299	break;
300	}
301	\endcode
302
303	The critical() function should be reserved for critical errors. In
304	this example errorDetails is a QString or const char*, and QString
305	is used to concatenate several strings:
306
307	\code
308	QMessageBox::critical( 0, "Application name here",
309	QString("An internal error occurred. Please ") +
310	"call technical support at 1234-56789 and report\n"+
311	"these numbers:\n\n" + errorDetails +
312	"\n\nApplication will now exit." );
313	\endcode
314
315	In this example an OK button is displayed.
316
317	QMessageBox provides a very simple About box which displays an
318	appropriate icon and the string you provide:
319
320	\code
321	QMessageBox::about( this, "About <Application>",
322	"<Application> is a <one-paragraph blurb>\n\n"
323	"Copyright 1991-2003 Such-and-such. "
324	"<License words here.>\n\n"
325	"For technical support, call 1234-56789 or see\n"
326	"http://www.such-and-such.com/Application/\n" );
327	\endcode
328
329	See about() for more information.
330
331	If you want your users to know that the application is built using
332	Qt (so they know that you use high quality tools) you might like
333	to add an "About Qt" menu option under the Help menu to invoke
334	aboutQt().
335
336	If none of the standard message boxes is suitable, you can create a
337	QMessageBox from scratch and use custom button texts:
338
339	\code
340	QMessageBox mb( "Application name here",
341	"Saving the file will overwrite the original file on the disk.\n"
342	"Do you really want to save?",
343	QMessageBox::Information,
344	QMessageBox::Yes \| QMessageBox::Default,
345	QMessageBox::No,
346	QMessageBox::Cancel \| QMessageBox::Escape );
347	mb.setButtonText( QMessageBox::Yes, "Save" );
348	mb.setButtonText( QMessageBox::No, "Discard" );
349	switch( mb.exec() ) {
350	case QMessageBox::Yes:
351	// save and exit
352	break;
353	case QMessageBox::No:
354	// exit without saving
355	break;
356	case QMessageBox::Cancel:
357	// don't save and don't exit
358	break;
359	}
360	\endcode
361
362	QMessageBox defines two enum types: Icon and an unnamed button type.
363	Icon defines the \c Question, \c Information, \c Warning, and \c
364	Critical icons for each GUI style. It is used by the constructor
365	and by the static member functions question(), information(),
366	warning() and critical(). A function called standardIcon() gives
367	you access to the various icons.
368
369	The button types are:
370	\list
371	\i Ok - the default for single-button message boxes
372	\i Cancel - note that this is \e not automatically Escape
373	\i Yes
374	\i No
375	\i Abort
376	\i Retry
377	\i Ignore
378	\i YesAll
379	\i NoAll
380	\endlist
381
382	Button types can be combined with two modifiers by using OR, '\|':
383	\list
384	\i Default - makes pressing Enter equivalent to
385	clicking this button. Normally used with Ok, Yes or similar.
386	\i Escape - makes pressing Escape equivalent to clicking this button.
387	Normally used with Abort, Cancel or similar.
388	\endlist
389
390	The text(), icon() and iconPixmap() functions provide access to the
391	current text and pixmap of the message box. The setText(), setIcon()
392	and setIconPixmap() let you change it. The difference between
393	setIcon() and setIconPixmap() is that the former accepts a
394	QMessageBox::Icon and can be used to set standard icons, whereas the
395	latter accepts a QPixmap and can be used to set custom icons.
396
397	setButtonText() and buttonText() provide access to the buttons.
398
399	QMessageBox has no signals or slots.
400
401	<img src=qmsgbox-m.png> <img src=qmsgbox-w.png>
402
403	\sa QDialog,
404	\link http://www.iarchitect.com/errormsg.htm
405	Isys on error messages \endlink,
406	\link guibooks.html#fowler GUI Design Handbook: Message Box \endlink
407	*/
408
409
410	/*!
411	\enum QMessageBox::Icon
412
413	This enum has the following values:
414
415	\value NoIcon the message box does not have any icon.
416
417	\value Question an icon indicating that
418	the message is asking a question.
419
420	\value Information an icon indicating that
421	the message is nothing out of the ordinary.
422
423	\value Warning an icon indicating that the
424	message is a warning, but can be dealt with.
425
426	\value Critical an icon indicating that
427	the message represents a critical problem.
428
429	*/
430
431
432	struct QMessageBoxData {
433	QMessageBoxData(QMessageBox* parent) :
434	iconLabel( parent, "icon" )
435	{
436	}
437
438	int numButtons; // number of buttons
439	QMessageBox::Icon icon; // message box icon
440	QLabel iconLabel; // label holding any icon
441	int button[3]; // button types
442	int defButton; // default button (index)
443	int escButton; // escape button (index)
444	QSize buttonSize; // button size
445	QPushButton *pb[3]; // buttons
446	};
447
448	static const int LastButton = QMessageBox::NoAll;
449
450	/*
451	NOTE: The table of button texts correspond to the button enum.
452	*/
453
454	#ifndef Q_OS_TEMP
455	static const char * const mb_texts[] = {
456	#else
457	const char * mb_texts[] = {
458	#endif
459	0,
460	QT_TRANSLATE_NOOP("QMessageBox","OK"),
461	QT_TRANSLATE_NOOP("QMessageBox","Cancel"),
462	QT_TRANSLATE_NOOP("QMessageBox","&Yes"),
463	QT_TRANSLATE_NOOP("QMessageBox","&No"),
464	QT_TRANSLATE_NOOP("QMessageBox","&Abort"),
465	QT_TRANSLATE_NOOP("QMessageBox","&Retry"),
466	QT_TRANSLATE_NOOP("QMessageBox","&Ignore"),
467	QT_TRANSLATE_NOOP("QMessageBox","Yes to &All"),
468	QT_TRANSLATE_NOOP("QMessageBox","N&o to All"),
469	0
470	};
471
472	/*!
473	Constructs a message box with no text and a button with the label
474	"OK".
475
476	If \a parent is 0, the message box becomes an application-global
477	modal dialog box. If \a parent is a widget, the message box
478	becomes modal relative to \a parent.
479
480	The \a parent and \a name arguments are passed to the QDialog
481	constructor.
482	*/
483
484	QMessageBox::QMessageBox( QWidget parent, const char name )
485	: QDialog( parent, name, TRUE, WStyle_Customize \| WStyle_DialogBorder \| WStyle_Title \| WStyle_SysMenu )
486	{
487	init( Ok, 0, 0 );
488	}
489
490
491	/*!
492	Constructs a message box with a \a caption, a \a text, an \a icon,
493	and up to three buttons.
494
495	The \a icon must be one of the following:
496	\list
497	\i QMessageBox::NoIcon
498	\i QMessageBox::Question
499	\i QMessageBox::Information
500	\i QMessageBox::Warning
501	\i QMessageBox::Critical
502	\endlist
503
504	Each button, \a button0, \a button1 and \a button2, can have one
505	of the following values:
506	\list
507	\i QMessageBox::NoButton
508	\i QMessageBox::Ok
509	\i QMessageBox::Cancel
510	\i QMessageBox::Yes
511	\i QMessageBox::No
512	\i QMessageBox::Abort
513	\i QMessageBox::Retry
514	\i QMessageBox::Ignore
515	\i QMessageBox::YesAll
516	\i QMessageBox::NoAll
517	\endlist
518
519	Use QMessageBox::NoButton for the later parameters to have fewer
520	than three buttons in your message box. If you don't specify any
521	buttons at all, QMessageBox will provide an Ok button.
522
523	One of the buttons can be OR-ed with the \c QMessageBox::Default
524	flag to make it the default button (clicked when Enter is
525	pressed).
526
527	One of the buttons can be OR-ed with the \c QMessageBox::Escape
528	flag to make it the cancel or close button (clicked when Escape is
529	pressed).
530
531	Example:
532	\code
533	QMessageBox mb( "Application Name",
534	"Hardware failure.\n\nDisk error detected\nDo you want to stop?",
535	QMessageBox::Question,
536	QMessageBox::Yes \| QMessageBox::Default,
537	QMessageBox::No \| QMessageBox::Escape
538	QMessageBox::NoButton );
539	if ( mb.exec() == QMessageBox::No )
540	// try again
541	\endcode
542
543	If \a parent is 0, the message box becomes an application-global
544	modal dialog box. If \a parent is a widget, the message box
545	becomes modal relative to \a parent.
546
547	If \a modal is TRUE the message box is modal; otherwise it
548	is modeless.
549
550	The \a parent, \a name, \a modal, and \a f arguments are passed to
551	the QDialog constructor.
552
553	\sa setCaption(), setText(), setIcon()
554	*/
555
556	QMessageBox::QMessageBox( const QString& caption,
557	const QString &text, Icon icon,
558	int button0, int button1, int button2,
559	QWidget parent, const char name,
560	bool modal, WFlags f )
561	: QDialog( parent, name, modal, f \| WStyle_Customize \| WStyle_DialogBorder \| WStyle_Title \| WStyle_SysMenu )
562	{
563	init( button0, button1, button2 );
564	#ifndef QT_NO_WIDGET_TOPEXTRA
565	setCaption( caption );
566	#endif
567	setText( text );
568	setIcon( icon );
569	}
570
571
572	/*!
573	Destroys the message box.
574	*/
575
576	QMessageBox::~QMessageBox()
577	{
578	delete mbd;
579	}
580
581	static QString * translatedTextAboutQt = 0;
582
583	void QMessageBox::init( int button0, int button1, int button2 )
584	{
585	if ( !translatedTextAboutQt ) {
586	translatedTextAboutQt = new QString;
587
588	#if defined(QT_NON_COMMERCIAL)
589	QT_NC_MSGBOX
590	#else
591	*translatedTextAboutQt = tr(
592	"<h3>About Qt</h3>"
593	"<p>This program uses Qt version %1.</p>"
594	"<p>Qt is a C++ toolkit for multiplatform GUI & "
595	"application development.</p>"
596	"<p>Qt provides single-source "
597	"portability across MS Windows, Mac OS X, "
598	"IBM OS/2 Warp and eComStation, "
599	"Linux, and all major commercial Unix variants."
600	"<br>Qt is also available for embedded devices.</p>"
601	"<p>Qt is a Trolltech product. "
602	"See <tt>http://www.trolltech.com/qt/</tt> "
603	"for more information.</p>"
604	).arg( QT_VERSION_STR );
605	#endif
606
607	}
608	label = new QMessageBoxLabel( this );
609	Q_CHECK_PTR( label );
610
611	if ( (button2 && !button1) \|\| (button1 && !button0) ) {
612	#if defined(QT_CHECK_RANGE)
613	qWarning( "QMessageBox: Inconsistent button parameters" );
614	#endif
615	button0 = button1 = button2 = 0;
616	}
617	mbd = new QMessageBoxData(this);
618	Q_CHECK_PTR( mbd );
619	mbd->icon = NoIcon;
620	mbd->iconLabel.setPixmap( QPixmap() );
621	mbd->numButtons = 0;
622	mbd->button[0] = button0;
623	mbd->button[1] = button1;
624	mbd->button[2] = button2;
625	mbd->defButton = -1;
626	mbd->escButton = -1;
627	int i;
628	for ( i=0; i<3; i++ ) {
629	int b = mbd->button[i];
630	if ( (b & Default) ) {
631	if ( mbd->defButton >= 0 ) {
632	#if defined(QT_CHECK_RANGE)
633	qWarning( "QMessageBox: There can be at most one "
634	"default button" );
635	#endif
636	} else {
637	mbd->defButton = i;
638	}
639	}
640	if ( (b & Escape) ) {
641	if ( mbd->escButton >= 0 ) {
642	#if defined(QT_CHECK_RANGE)
643	qWarning( "QMessageBox: There can be at most one "
644	"escape button" );
645	#endif
646	} else {
647	mbd->escButton = i;
648	}
649	}
650	b &= ButtonMask;
651	if ( b == 0 ) {
652	if ( i == 0 ) // no buttons, add an Ok button
653	b = Ok;
654	} else if ( b < 0 \|\| b > LastButton ) {
655	#if defined(QT_CHECK_RANGE)
656	qWarning( "QMessageBox: Invalid button specifier" );
657	#endif
658	b = Ok;
659	} else {
660	if ( i > 0 && mbd->button[i-1] == 0 ) {
661	#if defined(QT_CHECK_RANGE)
662	qWarning( "QMessageBox: Inconsistent button parameters; "
663	"button %d defined but not button %d",
664	i+1, i );
665	#endif
666	b = 0;
667	}
668	}
669	mbd->button[i] = b;
670	if ( b )
671	mbd->numButtons++;
672	}
673	for ( i=0; i<3; i++ ) {
674	if ( i >= mbd->numButtons ) {
675	mbd->pb[i] = 0;
676	} else {
677	QCString buttonName;
678	buttonName.sprintf( "button%d", i+1 );
679	mbd->pb[i] = new QPushButton(
680	tr(mb_texts[mbd->button[i]]),
681	this, buttonName );
682	if ( mbd->defButton == i ) {
683	mbd->pb[i]->setDefault( TRUE );
684	mbd->pb[i]->setFocus();
685	}
686	mbd->pb[i]->setAutoDefault( TRUE );
687	mbd->pb[i]->setFocusPolicy( QWidget::StrongFocus );
688	connect( mbd->pb[i], SIGNAL(clicked()), SLOT(buttonClicked()) );
689	}
690	}
691	resizeButtons();
692	reserved1 = reserved2 = 0;
693	}
694
695
696	int QMessageBox::indexOf( int button ) const
697	{
698	int index = -1;
699	for ( int i=0; i<mbd->numButtons; i++ ) {
700	if ( mbd->button[i] == button ) {
701	index = i;
702	break;
703	}
704	}
705	return index;
706	}
707
708
709	void QMessageBox::resizeButtons()
710	{
711	int i;
712	QSize maxSize;
713	for ( i=0; i<mbd->numButtons; i++ ) {
714	QSize s = mbd->pb[i]->sizeHint();
715	maxSize.setWidth( QMAX(maxSize.width(), s.width()) );
716	maxSize.setHeight( QMAX(maxSize.height(),s.height()) );
717	}
718	mbd->buttonSize = maxSize;
719	for ( i=0; i<mbd->numButtons; i++ )
720	mbd->pb[i]->resize( maxSize );
721	}
722
723
724	/*!
725	\property QMessageBox::text
726	\brief the message box text to be displayed.
727
728	The text will be interpreted either as a plain text or as rich
729	text, depending on the text format setting (\l
730	QMessageBox::textFormat). The default setting is \c AutoText, i.e.
731	the message box will try to auto-detect the format of the text.
732
733	The default value of this property is QString::null.
734
735	\sa textFormat
736	*/
737	QString QMessageBox::text() const
738	{
739	return label->text();
740	}
741
742
743	void QMessageBox::setText( const QString &text )
744	{
745	label->setText( text );
746	}
747
748
749	/*!
750	\property QMessageBox::icon
751	\brief the message box's icon
752
753	The icon of the message box can be one of the following predefined
754	icons:
755	\list
756	\i QMessageBox::NoIcon
757	\i QMessageBox::Question
758	\i QMessageBox::Information
759	\i QMessageBox::Warning
760	\i QMessageBox::Critical
761	\endlist
762
763	The actual pixmap used for displaying the icon depends on the
764	current \link QWidget::style() GUI style\endlink. You can also set
765	a custom pixmap icon using the \l QMessageBox::iconPixmap
766	property. The default icon is QMessageBox::NoIcon.
767
768	\sa iconPixmap
769	*/
770
771	QMessageBox::Icon QMessageBox::icon() const
772	{
773	return mbd->icon;
774	}
775
776	void QMessageBox::setIcon( Icon icon )
777	{
778	setIconPixmap( standardIcon(icon) );
779	mbd->icon = icon;
780	}
781
782	/*!
783	\obsolete
784
785	Returns the pixmap used for a standard icon. This
786	allows the pixmaps to be used in more complex message boxes.
787	\a icon specifies the required icon, e.g. QMessageBox::Information,
788	QMessageBox::Warning or QMessageBox::Critical.
789
790	\a style is unused.
791	*/
792
793	QPixmap QMessageBox::standardIcon( Icon icon, GUIStyle style)
794	{
795	Q_UNUSED(style);
796	return QMessageBox::standardIcon(icon);
797	}
798
799
800	/*!
801	Returns the pixmap used for a standard icon. This allows the
802	pixmaps to be used in more complex message boxes. \a icon
803	specifies the required icon, e.g. QMessageBox::Question,
804	QMessageBox::Information, QMessageBox::Warning or
805	QMessageBox::Critical.
806	*/
807
808	QPixmap QMessageBox::standardIcon( Icon icon )
809	{
810	QPixmap pm;
811	switch ( icon ) {
812	case Information:
813	pm = QApplication::style().stylePixmap( QStyle::SP_MessageBoxInformation );
814	break;
815	case Warning:
816	pm = QApplication::style().stylePixmap( QStyle::SP_MessageBoxWarning );
817	break;
818	case Critical:
819	pm = QApplication::style().stylePixmap( QStyle::SP_MessageBoxCritical );
820	break;
821	case Question:
822	pm = QApplication::style().stylePixmap( QStyle::SP_MessageBoxQuestion );
823	default:
824	break;
825	}
826	return pm;
827	}
828
829
830	/*!
831	\property QMessageBox::iconPixmap
832	\brief the current icon
833
834	The icon currently used by the message box. Note that it's often
835	hard to draw one pixmap that looks appropriate in both Motif and
836	Windows GUI styles; you may want to draw two pixmaps.
837
838	\sa icon
839	*/
840
841	const QPixmap *QMessageBox::iconPixmap() const
842	{
843	return mbd->iconLabel.pixmap();
844	}
845
846
847	void QMessageBox::setIconPixmap( const QPixmap &pixmap )
848	{
849	mbd->iconLabel.setPixmap(pixmap);
850	mbd->icon = NoIcon;
851	}
852
853
854	/*!
855	Returns the text of the message box button \a button, or
856	QString::null if the message box does not contain the button.
857
858	\sa setButtonText()
859	*/
860
861	QString QMessageBox::buttonText( int button ) const
862	{
863	int index = indexOf(button);
864	return index >= 0 && mbd->pb[index]
865	? mbd->pb[index]->text()
866	: QString::null;
867	}
868
869
870	/*!
871	Sets the text of the message box button \a button to \a text.
872	Setting the text of a button that is not in the message box is
873	silently ignored.
874
875	\sa buttonText()
876	*/
877
878	void QMessageBox::setButtonText( int button, const QString &text )
879	{
880	int index = indexOf(button);
881	if ( index >= 0 && mbd->pb[index] ) {
882	mbd->pb[index]->setText( text );
883	resizeButtons();
884	}
885	}
886
887
888	/*!
889	\internal
890	Internal slot to handle button clicks.
891	*/
892
893	void QMessageBox::buttonClicked()
894	{
895	int reply = 0;
896	const QObject *s = sender();
897	for ( int i=0; i<mbd->numButtons; i++ ) {
898	if ( mbd->pb[i] == s )
899	reply = mbd->button[i];
900	}
901	done( reply );
902	}
903
904
905	/*!
906	Adjusts the size of the message box to fit the contents just before
907	QDialog::exec() or QDialog::show() is called.
908
909	This function will not be called if the message box has been explicitly
910	resized before showing it.
911	*/
912	void QMessageBox::adjustSize()
913	{
914	if ( !testWState(WState_Polished) )
915	polish();
916	resizeButtons();
917	label->adjustSize();
918	QSize labelSize( label->size() );
919	int n = mbd->numButtons;
920	int bw = mbd->buttonSize.width();
921	int bh = mbd->buttonSize.height();
922	int border = bh / 2 - style().pixelMetric(QStyle::PM_ButtonDefaultIndicator);
923	if ( border <= 0 )
924	border = 10;
925	int btn_spacing = 7;
926	if ( style().styleHint(QStyle::SH_GUIStyle) == MotifStyle )
927	btn_spacing = border;
928	#ifndef Q_OS_TEMP
929	int buttons = mbd->numButtons * bw + (n-1) * btn_spacing;
930	int h = bh;
931	#else
932	int visibleButtons = 0;
933	for ( int i = 0; i < mbd->numButtons; ++i )
934	visibleButtons += mbd->pb[i]->isVisible() ? 1 : 0;
935	int buttons = visibleButtons == 0 ? 0 : visibleButtons * bw + (visibleButtons-1) * btn_spacing;
936	int h = visibleButtons == 0 ? 0 : bh;
937	n = visibleButtons;
938	#endif
939	if ( labelSize.height() )
940	h += labelSize.height() + 3*border;
941	else
942	h += 2*border;
943	int lmargin = 0;
944	if ( mbd->iconLabel.pixmap() && mbd->iconLabel.pixmap()->width() ) {
945	mbd->iconLabel.adjustSize();
946	lmargin += mbd->iconLabel.width() + border;
947	if ( h < mbd->iconLabel.height() + 3*border + bh && n )
948	h = mbd->iconLabel.height() + 3*border + bh;
949	}
950	int w = QMAX( buttons, labelSize.width() + lmargin ) + 2*border;
951	QRect screen = QApplication::desktop()->screenGeometry( pos() );
952	if ( w > screen.width() )
953	w = screen.width();
954	resize( w, h );
955	setMinimumSize( size() );
956	}
957
958
959	/*!\reimp
960	*/
961	void QMessageBox::resizeEvent( QResizeEvent * )
962	{
963	int i;
964	int n = mbd->numButtons;
965	int bw = mbd->buttonSize.width();
966	int bh = mbd->buttonSize.height();
967	#ifdef Q_OS_TEMP
968	int visibleButtons = 0;
969	for ( i = 0; i < n; ++i )
970	visibleButtons += mbd->pb[i]->isVisible() ? 1 : 0;
971	n = visibleButtons;
972	bw = visibleButtons == 0 ? 0 : bw;
973	bh = visibleButtons == 0 ? 0 : bh;
974	#endif
975	int border = bh / 2 - style().pixelMetric(QStyle::PM_ButtonDefaultIndicator);
976	if ( border <= 0 )
977	border = 10;
978	int btn_spacing = 7;
979	if ( style().styleHint(QStyle::SH_GUIStyle) == MotifStyle )
980	btn_spacing = border;
981	int lmargin = 0;
982	mbd->iconLabel.adjustSize();
983	mbd->iconLabel.move( border, border );
984	if ( mbd->iconLabel.pixmap() && mbd->iconLabel.pixmap()->width() )
985	lmargin += mbd->iconLabel.width() + border;
986	label->setGeometry( lmargin+border,
987	border,
988	width() - lmargin -2*border,
989	height() - 3*border - bh );
990	int extra_space = (width() - bwn - 2border - (n-1)*btn_spacing);
991	if ( style().styleHint(QStyle::SH_GUIStyle) == MotifStyle )
992	for ( i=0; i<n; i++ )
993	mbd->pb[i]->move( border + ibw + ibtn_spacing + extra_space*(i+1)/(n+1),
994	height() - border - bh );
995	else
996	for ( i=0; i<n; i++ )
997	mbd->pb[i]->move( border + ibw + extra_space/2 + ibtn_spacing,
998	height() - border - bh );
999	}
1000
1001
1002	/*!\reimp
1003	*/
1004	void QMessageBox::keyPressEvent( QKeyEvent *e )
1005	{
1006	if ( e->key() == Key_Escape ) {
1007	if ( mbd->escButton >= 0 ) {
1008	QPushButton *pb = mbd->pb[mbd->escButton];
1009	pb->animateClick();
1010	e->accept();
1011	return;
1012	}
1013	}
1014	#ifndef QT_NO_ACCEL
1015	if ( !( e->state() & AltButton ) ) {
1016	QObjectList *list = queryList( "QPushButton" );
1017	QObjectListIt it( *list );
1018	QPushButton *pb;
1019	while ( (pb = (QPushButton*)it.current()) ) {
1020	int key = e->key() & ~(MODIFIER_MASK\|UNICODE_ACCEL);
1021	int acc = pb->accel() & ~(MODIFIER_MASK\|UNICODE_ACCEL);
1022	if ( key && acc && acc == key ) {
1023	delete list;
1024	emit pb->animateClick();
1025	return;
1026	}
1027	++it;
1028	}
1029	delete list;
1030	}
1031	#endif
1032	QDialog::keyPressEvent( e );
1033	}
1034
1035	/*!\reimp
1036	*/
1037	void QMessageBox::showEvent( QShowEvent *e )
1038	{
1039	#if defined(QT_ACCESSIBILITY_SUPPORT)
1040	QAccessible::updateAccessibility( this, 0, QAccessible::Alert );
1041	#else
1042	#if defined(Q_WS_PM)
1043	//@@TODO (dmik): currently, the accessibility support is not implemented
1044	// on OS/2, but we still need to play a sound when QMessageBox is opened.
1045	ULONG alarmStyle = 0;
1046	bool playAlarm = TRUE;
1047	switch ( icon() ) {
1048	case Warning:
1049	alarmStyle = WA_WARNING;
1050	break;
1051	case Critical:
1052	alarmStyle = WA_ERROR;
1053	break;
1054	case Information:
1055	alarmStyle = WA_NOTE;
1056	break;
1057	default:
1058	playAlarm = FALSE;
1059	break;
1060	}
1061	if ( playAlarm )
1062	WinAlarm( HWND_DESKTOP, alarmStyle );
1063	#endif
1064	#endif
1065	QDialog::showEvent( e );
1066	}
1067
1068	/*!\reimp
1069	*/
1070	void QMessageBox::closeEvent( QCloseEvent *e )
1071	{
1072	QDialog::closeEvent( e );
1073	if ( mbd->escButton != -1 )
1074	setResult( mbd->button[mbd->escButton] );
1075	}
1076
1077	/*****************************************************************************
1078	Static QMessageBox functions
1079	*****************************************************************************/
1080
1081	/!\fn int QMessageBox::message( const QString &,const QString&,const QString&,QWidget,const char * )
1082	\obsolete
1083	Opens a modal message box directly using the specified parameters.
1084
1085	Please use information(), warning(), question(), or critical() instead.
1086	*/
1087
1088	/! \fn bool QMessageBox::query( const QString &,const QString&,const QString&,const QString&,QWidget , const char * )
1089	\obsolete
1090	Queries the user using a modal message box with two buttons.
1091	Note that \a caption is not always shown, it depends on the window manager.
1092
1093	Please use information(), question(), warning(), or critical() instead.
1094	*/
1095
1096	/*!
1097	Opens an information message box with the caption \a caption and
1098	the text \a text. The dialog may have up to three buttons. Each of
1099	the buttons, \a button0, \a button1 and \a button2 may be set to
1100	one of the following values:
1101
1102	\list
1103	\i QMessageBox::NoButton
1104	\i QMessageBox::Ok
1105	\i QMessageBox::Cancel
1106	\i QMessageBox::Yes
1107	\i QMessageBox::No
1108	\i QMessageBox::Abort
1109	\i QMessageBox::Retry
1110	\i QMessageBox::Ignore
1111	\i QMessageBox::YesAll
1112	\i QMessageBox::NoAll
1113	\endlist
1114
1115	If you don't want all three buttons, set the last button, or last
1116	two buttons to QMessageBox::NoButton.
1117
1118	One button can be OR-ed with \c QMessageBox::Default, and one
1119	button can be OR-ed with \c QMessageBox::Escape.
1120
1121	Returns the identity (QMessageBox::Ok, or QMessageBox::No, etc.)
1122	of the button that was clicked.
1123
1124	If \a parent is 0, the message box becomes an application-global
1125	modal dialog box. If \a parent is a widget, the message box
1126	becomes modal relative to \a parent.
1127
1128	\sa question(), warning(), critical()
1129	*/
1130
1131	int QMessageBox::information( QWidget *parent,
1132	const QString& caption, const QString& text,
1133	int button0, int button1, int button2 )
1134	{
1135	QMessageBox *mb = new QMessageBox( caption, text, Information,
1136	button0, button1, button2,
1137	parent, "qt_msgbox_information", TRUE,
1138	WDestructiveClose);
1139	Q_CHECK_PTR( mb );
1140	return mb->exec();
1141	}
1142
1143	/*!
1144	Opens a question message box with the caption \a caption and the
1145	text \a text. The dialog may have up to three buttons. Each of the
1146	buttons, \a button0, \a button1 and \a button2 may be set to one
1147	of the following values:
1148
1149	\list
1150	\i QMessageBox::NoButton
1151	\i QMessageBox::Ok
1152	\i QMessageBox::Cancel
1153	\i QMessageBox::Yes
1154	\i QMessageBox::No
1155	\i QMessageBox::Abort
1156	\i QMessageBox::Retry
1157	\i QMessageBox::Ignore
1158	\i QMessageBox::YesAll
1159	\i QMessageBox::NoAll
1160	\endlist
1161
1162	If you don't want all three buttons, set the last button, or last
1163	two buttons to QMessageBox::NoButton.
1164
1165	One button can be OR-ed with \c QMessageBox::Default, and one
1166	button can be OR-ed with \c QMessageBox::Escape.
1167
1168	Returns the identity (QMessageBox::Yes, or QMessageBox::No, etc.)
1169	of the button that was clicked.
1170
1171	If \a parent is 0, the message box becomes an application-global
1172	modal dialog box. If \a parent is a widget, the message box
1173	becomes modal relative to \a parent.
1174
1175	\sa information(), warning(), critical()
1176	*/
1177
1178	int QMessageBox::question( QWidget *parent,
1179	const QString& caption, const QString& text,
1180	int button0, int button1, int button2 )
1181	{
1182	QMessageBox *mb = new QMessageBox( caption, text, Question,
1183	button0, button1, button2,
1184	parent, "qt_msgbox_information", TRUE,
1185	WDestructiveClose);
1186	Q_CHECK_PTR( mb );
1187	return mb->exec();
1188	}
1189
1190
1191	/*!
1192	Opens a warning message box with the caption \a caption and the
1193	text \a text. The dialog may have up to three buttons. Each of the
1194	button parameters, \a button0, \a button1 and \a button2 may be
1195	set to one of the following values:
1196
1197	\list
1198	\i QMessageBox::NoButton
1199	\i QMessageBox::Ok
1200	\i QMessageBox::Cancel
1201	\i QMessageBox::Yes
1202	\i QMessageBox::No
1203	\i QMessageBox::Abort
1204	\i QMessageBox::Retry
1205	\i QMessageBox::Ignore
1206	\i QMessageBox::YesAll
1207	\i QMessageBox::NoAll
1208	\endlist
1209
1210	If you don't want all three buttons, set the last button, or last
1211	two buttons to QMessageBox::NoButton.
1212
1213	One button can be OR-ed with \c QMessageBox::Default, and one
1214	button can be OR-ed with \c QMessageBox::Escape.
1215
1216	Returns the identity (QMessageBox::Ok, or QMessageBox::No, etc.)
1217	of the button that was clicked.
1218
1219	If \a parent is 0, the message box becomes an application-global
1220	modal dialog box. If \a parent is a widget, the message box
1221	becomes modal relative to \a parent.
1222
1223	\sa information(), question(), critical()
1224	*/
1225
1226	int QMessageBox::warning( QWidget *parent,
1227	const QString& caption, const QString& text,
1228	int button0, int button1, int button2 )
1229	{
1230	QMessageBox *mb = new QMessageBox( caption, text, Warning,
1231	button0, button1, button2,
1232	parent, "qt_msgbox_warning", TRUE,
1233	WDestructiveClose);
1234	Q_CHECK_PTR( mb );
1235	return mb->exec();
1236	}
1237
1238
1239	/*!
1240	Opens a critical message box with the caption \a caption and the
1241	text \a text. The dialog may have up to three buttons. Each of the
1242	button parameters, \a button0, \a button1 and \a button2 may be
1243	set to one of the following values:
1244
1245	\list
1246	\i QMessageBox::NoButton
1247	\i QMessageBox::Ok
1248	\i QMessageBox::Cancel
1249	\i QMessageBox::Yes
1250	\i QMessageBox::No
1251	\i QMessageBox::Abort
1252	\i QMessageBox::Retry
1253	\i QMessageBox::Ignore
1254	\i QMessageBox::YesAll
1255	\i QMessageBox::NoAll
1256	\endlist
1257
1258	If you don't want all three buttons, set the last button, or last
1259	two buttons to QMessageBox::NoButton.
1260
1261	One button can be OR-ed with \c QMessageBox::Default, and one
1262	button can be OR-ed with \c QMessageBox::Escape.
1263
1264	Returns the identity (QMessageBox::Ok, or QMessageBox::No, etc.)
1265	of the button that was clicked.
1266
1267	If \a parent is 0, the message box becomes an application-global
1268	modal dialog box. If \a parent is a widget, the message box
1269	becomes modal relative to \a parent.
1270
1271	\sa information(), question(), warning()
1272	*/
1273
1274	int QMessageBox::critical( QWidget *parent,
1275	const QString& caption, const QString& text,
1276	int button0, int button1, int button2 )
1277	{
1278	QMessageBox *mb = new QMessageBox( caption, text, Critical,
1279	button0, button1, button2,
1280	parent, "qt_msgbox_critical", TRUE,
1281	WDestructiveClose);
1282	Q_CHECK_PTR( mb );
1283	return mb->exec();
1284	}
1285
1286
1287	/*!
1288	Displays a simple about box with caption \a caption and text \a
1289	text. The about box's parent is \a parent.
1290
1291	about() looks for a suitable icon in four locations:
1292	\list 1
1293	\i It prefers \link QWidget::icon() parent->icon() \endlink if that exists.
1294	\i If not, it tries the top-level widget containing \a parent.
1295	\i If that fails, it tries the \link
1296	QApplication::mainWidget() main widget. \endlink
1297	\i As a last resort it uses the Information icon.
1298	\endlist
1299
1300	The about box has a single button labelled "OK".
1301
1302	\sa QWidget::icon() QApplication::mainWidget()
1303	*/
1304
1305	void QMessageBox::about( QWidget *parent, const QString &caption,
1306	const QString& text )
1307	{
1308	QMessageBox *mb = new QMessageBox( caption, text,
1309	Information,
1310	Ok + Default, 0, 0,
1311	parent, "qt_msgbox_simple_about_box", TRUE,
1312	WDestructiveClose);
1313	Q_CHECK_PTR( mb );
1314	#ifndef QT_NO_WIDGET_TOPEXTRA
1315	const QPixmap *pm = parent ? parent->icon() : 0;
1316	if ( pm && !pm->isNull() )
1317	mb->setIconPixmap( *pm );
1318	else {
1319	pm = parent ? parent->topLevelWidget()->icon() : 0;
1320	if ( pm && !pm->isNull() )
1321	mb->setIconPixmap( *pm );
1322	else {
1323	pm = qApp && qApp->mainWidget() ? qApp->mainWidget()->icon() : 0;
1324	if ( pm && !pm->isNull() )
1325	mb->setIconPixmap( *pm );
1326	}
1327	}
1328	#endif
1329	mb->exec();
1330	}
1331
1332
1333	/*! \reimp
1334	*/
1335
1336	void QMessageBox::styleChanged( QStyle& )
1337	{
1338	if ( mbd->icon != NoIcon ) {
1339	// Reload icon for new style
1340	setIcon( mbd->icon );
1341	}
1342	}
1343
1344
1345	static int textBox( QWidget *parent, QMessageBox::Icon severity,
1346	const QString& caption, const QString& text,
1347	const QString& button0Text,
1348	const QString& button1Text,
1349	const QString& button2Text,
1350	int defaultButtonNumber,
1351	int escapeButtonNumber )
1352	{
1353	int b[3];
1354	b[0] = 1;
1355	b[1] = button1Text.isEmpty() ? 0 : 2;
1356	b[2] = button2Text.isEmpty() ? 0 : 3;
1357
1358	int i;
1359	for( i=0; i<3; i++ ) {
1360	if ( b[i] && defaultButtonNumber == i )
1361	b[i] += QMessageBox::Default;
1362	if ( b[i] && escapeButtonNumber == i )
1363	b[i] += QMessageBox::Escape;
1364	}
1365
1366	QMessageBox *mb = new QMessageBox( caption, text, severity,
1367	b[0], b[1], b[2],
1368	parent, "qt_msgbox_information", TRUE,
1369	Qt::WDestructiveClose);
1370	Q_CHECK_PTR( mb );
1371	if ( button0Text.isEmpty() )
1372	mb->setButtonText( 1, QMessageBox::tr(mb_texts[QMessageBox::Ok]) );
1373	else
1374	mb->setButtonText( 1, button0Text );
1375	if ( b[1] )
1376	mb->setButtonText( 2, button1Text );
1377	if ( b[2] )
1378	mb->setButtonText( 3, button2Text );
1379
1380	#ifndef QT_NO_CURSOR
1381	mb->setCursor( Qt::arrowCursor );
1382	#endif
1383	return mb->exec() - 1;
1384	}
1385
1386
1387	/*!
1388	\overload
1389
1390	Displays an information message box with caption \a caption, text
1391	\a text and one, two or three buttons. Returns the index of the
1392	button that was clicked (0, 1 or 2).
1393
1394	\a button0Text is the text of the first button, and is optional.
1395	If \a button0Text is not supplied, "OK" (translated) will be used.
1396	\a button1Text is the text of the second button, and is optional.
1397	\a button2Text is the text of the third button, and is optional.
1398	\a defaultButtonNumber (0, 1 or 2) is the index of the default
1399	button; pressing Return or Enter is the same as clicking the
1400	default button. It defaults to 0 (the first button). \a
1401	escapeButtonNumber is the index of the Escape button; pressing
1402	Escape is the same as clicking this button. It defaults to -1;
1403	supply 0, 1 or 2 to make pressing Escape equivalent to clicking
1404	the relevant button.
1405
1406	If \a parent is 0, the message box becomes an application-global
1407	modal dialog box. If \a parent is a widget, the message box
1408	becomes modal relative to \a parent.
1409
1410	Note: If you do not specify an Escape button then if the Escape
1411	button is pressed then -1 will be returned. It is suggested that
1412	you specify an Escape button to prevent this from happening.
1413
1414	\sa question(), warning(), critical()
1415	*/
1416
1417	int QMessageBox::information( QWidget *parent, const QString &caption,
1418	const QString& text,
1419	const QString& button0Text,
1420	const QString& button1Text,
1421	const QString& button2Text,
1422	int defaultButtonNumber,
1423	int escapeButtonNumber )
1424	{
1425	return textBox( parent, Information, caption, text,
1426	button0Text, button1Text, button2Text,
1427	defaultButtonNumber, escapeButtonNumber );
1428	}
1429
1430	/*!
1431	\overload
1432
1433	Displays a question message box with caption \a caption, text \a
1434	text and one, two or three buttons. Returns the index of the
1435	button that was clicked (0, 1 or 2).
1436
1437	\a button0Text is the text of the first button, and is optional.
1438	If \a button0Text is not supplied, "OK" (translated) will be used.
1439	\a button1Text is the text of the second button, and is optional.
1440	\a button2Text is the text of the third button, and is optional.
1441	\a defaultButtonNumber (0, 1 or 2) is the index of the default
1442	button; pressing Return or Enter is the same as clicking the
1443	default button. It defaults to 0 (the first button). \a
1444	escapeButtonNumber is the index of the Escape button; pressing
1445	Escape is the same as clicking this button. It defaults to -1;
1446	supply 0, 1 or 2 to make pressing Escape equivalent to clicking
1447	the relevant button.
1448
1449	If \a parent is 0, the message box becomes an application-global
1450	modal dialog box. If \a parent is a widget, the message box
1451	becomes modal relative to \a parent.
1452
1453	Note: If you do not specify an Escape button then if the Escape
1454	button is pressed then -1 will be returned. It is suggested that
1455	you specify an Escape button to prevent this from happening.
1456
1457	\sa information(), warning(), critical()
1458	*/
1459	int QMessageBox::question( QWidget *parent, const QString &caption,
1460	const QString& text,
1461	const QString& button0Text,
1462	const QString& button1Text,
1463	const QString& button2Text,
1464	int defaultButtonNumber,
1465	int escapeButtonNumber )
1466	{
1467	return textBox( parent, Question, caption, text,
1468	button0Text, button1Text, button2Text,
1469	defaultButtonNumber, escapeButtonNumber );
1470	}
1471
1472
1473	/*!
1474	\overload
1475
1476	Displays a warning message box with a caption, a text, and 1, 2 or
1477	3 buttons. Returns the number of the button that was clicked (0,
1478	1, or 2).
1479
1480	\a button0Text is the text of the first button, and is optional.
1481	If \a button0Text is not supplied, "OK" (translated) will be used.
1482	\a button1Text is the text of the second button, and is optional,
1483	and \a button2Text is the text of the third button, and is
1484	optional. \a defaultButtonNumber (0, 1 or 2) is the index of the
1485	default button; pressing Return or Enter is the same as clicking
1486	the default button. It defaults to 0 (the first button). \a
1487	escapeButtonNumber is the index of the Escape button; pressing
1488	Escape is the same as clicking this button. It defaults to -1;
1489	supply 0, 1, or 2 to make pressing Escape equivalent to clicking
1490	the relevant button.
1491
1492	If \a parent is 0, the message box becomes an application-global
1493	modal dialog box. If \a parent is a widget, the message box
1494	becomes modal relative to \a parent.
1495
1496	Note: If you do not specify an Escape button then if the Escape
1497	button is pressed then -1 will be returned. It is suggested that
1498	you specify an Escape button to prevent this from happening.
1499
1500	\sa information(), question(), critical()
1501	*/
1502
1503	int QMessageBox::warning( QWidget *parent, const QString &caption,
1504	const QString& text,
1505	const QString& button0Text,
1506	const QString& button1Text,
1507	const QString& button2Text,
1508	int defaultButtonNumber,
1509	int escapeButtonNumber )
1510	{
1511	return textBox( parent, Warning, caption, text,
1512	button0Text, button1Text, button2Text,
1513	defaultButtonNumber, escapeButtonNumber );
1514	}
1515
1516
1517	/*!
1518	\overload
1519
1520	Displays a critical error message box with a caption, a text, and
1521	1, 2 or 3 buttons. Returns the number of the button that was
1522	clicked (0, 1 or 2).
1523
1524	\a button0Text is the text of the first button, and is optional.
1525	If \a button0Text is not supplied, "OK" (translated) will be used.
1526	\a button1Text is the text of the second button, and is optional,
1527	and \a button2Text is the text of the third button, and is
1528	optional. \a defaultButtonNumber (0, 1 or 2) is the index of the
1529	default button; pressing Return or Enter is the same as clicking
1530	the default button. It defaults to 0 (the first button). \a
1531	escapeButtonNumber is the index of the Escape button; pressing
1532	Escape is the same as clicking this button. It defaults to -1;
1533	supply 0, 1, or 2 to make pressing Escape equivalent to clicking
1534	the relevant button.
1535
1536	If \a parent is 0, the message box becomes an application-global
1537	modal dialog box. If \a parent is a widget, the message box
1538	becomes modal relative to \a parent.
1539
1540	\sa information(), question(), warning()
1541	*/
1542
1543	int QMessageBox::critical( QWidget *parent, const QString &caption,
1544	const QString& text,
1545	const QString& button0Text,
1546	const QString& button1Text,
1547	const QString& button2Text,
1548	int defaultButtonNumber,
1549	int escapeButtonNumber )
1550	{
1551	return textBox( parent, Critical, caption, text,
1552	button0Text, button1Text, button2Text,
1553	defaultButtonNumber, escapeButtonNumber );
1554	}
1555
1556
1557	/*!
1558	Displays a simple message box about Qt, with caption \a caption
1559	and centered over \a parent (if \a parent is not 0). The message
1560	includes the version number of Qt being used by the application.
1561
1562	This is useful for inclusion in the Help menu of an application.
1563	See the examples/menu/menu.cpp example.
1564
1565	QApplication provides this functionality as a slot.
1566
1567	\sa QApplication::aboutQt()
1568	*/
1569
1570	void QMessageBox::aboutQt( QWidget *parent, const QString &caption )
1571	{
1572	QMessageBox *mb = new QMessageBox( parent, "qt_msgbox_about_qt" );
1573	Q_CHECK_PTR( mb );
1574	mb->setWFlags( WDestructiveClose );
1575
1576	#ifndef QT_NO_WIDGET_TOPEXTRA
1577	QString c = caption;
1578	if ( c.isNull() )
1579	c = tr( "About Qt" );
1580	mb->setCaption( c );
1581	#endif
1582	mb->setText( *translatedTextAboutQt );
1583	#ifndef QT_NO_IMAGEIO
1584	QPixmap pm;
1585	QImage logo( (const char **)qtlogo_xpm);
1586	if ( qGray(mb->palette().active().text().rgb()) >
1587	qGray(mb->palette().active().base().rgb()) )
1588	{
1589	// light on dark, adjust some colors (where's 10?)
1590	logo.setColor( 0, 0xffffffff );
1591	logo.setColor( 1, 0xff666666 );
1592	logo.setColor( 2, 0xffcccc66 );
1593	logo.setColor( 4, 0xffcccccc );
1594	logo.setColor( 6, 0xffffff66 );
1595	logo.setColor( 7, 0xff999999 );
1596	logo.setColor( 8, 0xff3333ff );
1597	logo.setColor( 9, 0xffffff33 );
1598	logo.setColor( 11, 0xffcccc99 );
1599	}
1600	if ( pm.convertFromImage( logo ) )
1601	mb->setIconPixmap( pm );
1602	#endif
1603	mb->setButtonText( 0, tr("OK") );
1604	if ( mb->mbd && mb->mbd->pb[0] ) {
1605	mb->mbd->pb[0]->setAutoDefault( TRUE );
1606	mb->mbd->pb[0]->setFocusPolicy( QWidget::StrongFocus );
1607	mb->mbd->pb[0]->setDefault( TRUE );
1608	mb->mbd->pb[0]->setFocus();
1609	}
1610	mb->exec();
1611	}
1612
1613	/*!
1614	\reimp
1615	*/
1616
1617	void QMessageBox::setIcon( const QPixmap &pix )
1618	{
1619	//reimplemented to avoid compiler warning.
1620	#ifndef QT_NO_WIDGET_TOPEXTRA
1621	QDialog::setIcon( pix );
1622	#endif
1623	}
1624
1625
1626	/*!
1627	\property QMessageBox::textFormat
1628	\brief the format of the text displayed by the message box
1629
1630	The current text format used by the message box. See the \l
1631	Qt::TextFormat enum for an explanation of the possible options.
1632
1633	The default format is \c AutoText.
1634
1635	\sa setText()
1636	*/
1637
1638	Qt::TextFormat QMessageBox::textFormat() const
1639	{
1640	return label->textFormat();
1641	}
1642
1643
1644	void QMessageBox::setTextFormat( Qt::TextFormat format )
1645	{
1646	label->setTextFormat( format );
1647	}
1648
1649
1650	#endif

Note: See TracBrowser for help on using the repository browser.

Context Navigation

source: trunk/src/dialogs/qmessagebox.cpp

Download in other formats: