source: trunk/doc/html/qmessagebox-h.html

Last change on this file was 190, checked in by rudi, 14 years ago

reference documentation added
File size: 9.5 KB
Line 
1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/include/qmessagebox.h:1 -->
3<html>
4<head>
5<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
6<title>qmessagebox.h Include File</title>
7<style type="text/css"><!--
8fn { margin-left: 1cm; text-indent: -1cm; }
9a:link { color: #004faf; text-decoration: none }
10a:visited { color: #672967; text-decoration: none }
11body { background: #ffffff; color: black; }
12--></style>
13</head>
14<body>
15
16<table border="0" cellpadding="0" cellspacing="0" width="100%">
17<tr bgcolor="#E5E5E5">
18<td valign=center>
19 <a href="index.html">
20<font color="#004faf">Home</font></a>
21 | <a href="classes.html">
22<font color="#004faf">All&nbsp;Classes</font></a>
23 | <a href="mainclasses.html">
24<font color="#004faf">Main&nbsp;Classes</font></a>
25 | <a href="annotated.html">
26<font color="#004faf">Annotated</font></a>
27 | <a href="groups.html">
28<font color="#004faf">Grouped&nbsp;Classes</font></a>
29 | <a href="functions.html">
30<font color="#004faf">Functions</font></a>
31</td>
32<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>qmessagebox.h</h1>
33
34<p>This is the verbatim text of the qmessagebox.h include file. It is provided only for illustration; the copyright remains with Trolltech.
35<hr>
36<pre>
37/****************************************************************************
38** $Id: qmessagebox-h.html 2051 2007-02-21 10:04:20Z chehrlic $
39**
40** Definition of QMessageBox class
41**
42** Created : 950503
43**
44** Copyright (C) 1992-2007 Trolltech ASA. All rights reserved.
45**
46** This file is part of the dialogs module of the Qt GUI Toolkit.
47**
48** This file may be distributed under the terms of the Q Public License
49** as defined by Trolltech ASA of Norway and appearing in the file
50** LICENSE.QPL included in the packaging of this file.
51**
52** This file may be distributed and/or modified under the terms of the
53** GNU General Public License version 2 as published by the Free Software
54** Foundation and appearing in the file LICENSE.GPL included in the
55** packaging of this file.
56**
57** Licensees holding valid Qt Enterprise Edition or Qt Professional Edition
58** licenses may use this file in accordance with the Qt Commercial License
59** Agreement provided with the Software.
60**
61** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
62** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
63**
64** See http://www.trolltech.com/pricing.html or email sales@trolltech.com for
65** information about Qt Commercial License Agreements.
66** See http://www.trolltech.com/qpl/ for QPL licensing information.
67** See http://www.trolltech.com/gpl/ for GPL licensing information.
68**
69** Contact info@trolltech.com if any conditions of this licensing are
70** not clear to you.
71**
72**********************************************************************/
73
74#ifndef QMESSAGEBOX_H
75#define QMESSAGEBOX_H
76
77#ifndef QT_H
78#include "qdialog.h"
79#endif // QT_H
80
81#ifndef QT_NO_MESSAGEBOX
82
83class QLabel;
84class QPushButton;
85struct QMessageBoxData;
86
87class Q_EXPORT QMessageBox : public QDialog
88{
89 Q_OBJECT
90 Q_ENUMS( Icon )
91 Q_PROPERTY( QString text READ text WRITE setText )
92 Q_PROPERTY( Icon icon READ icon WRITE setIcon )
93 Q_PROPERTY( QPixmap iconPixmap READ iconPixmap WRITE setIconPixmap )
94 Q_PROPERTY( TextFormat textFormat READ textFormat WRITE setTextFormat )
95
96public:
97 enum Icon { NoIcon = 0, Information = 1, Warning = 2, Critical = 3,
98 Question = 4 };
99
100 QMessageBox( QWidget* parent=0, const char* name=0 );
101 QMessageBox( const QString&amp; caption, const QString &amp;text, Icon icon,
102 int button0, int button1, int button2,
103 QWidget* parent=0, const char* name=0, bool modal=TRUE,
104 WFlags f=WStyle_DialogBorder );
105 ~QMessageBox();
106
107 enum { NoButton = 0, Ok = 1, Cancel = 2, Yes = 3, No = 4, Abort = 5,
108 Retry = 6, Ignore = 7, YesAll = 8, NoAll = 9, ButtonMask = 0xff,
109 Default = 0x100, Escape = 0x200, FlagMask = 0x300 };
110
111 static int information( QWidget *parent, const QString &amp;caption,
112 const QString&amp; text,
113 int button0, int button1=0, int button2=0 );
114 static int information( QWidget *parent, const QString &amp;caption,
115 const QString&amp; text,
116 const QString&amp; button0Text = QString::null,
117 const QString&amp; button1Text = QString::null,
118 const QString&amp; button2Text = QString::null,
119 int defaultButtonNumber = 0,
120 int escapeButtonNumber = -1 );
121
122 static int question( QWidget *parent, const QString &amp;caption,
123 const QString&amp; text,
124 int button0, int button1=0, int button2=0 );
125 static int question( QWidget *parent, const QString &amp;caption,
126 const QString&amp; text,
127 const QString&amp; button0Text = QString::null,
128 const QString&amp; button1Text = QString::null,
129 const QString&amp; button2Text = QString::null,
130 int defaultButtonNumber = 0,
131 int escapeButtonNumber = -1 );
132
133 static int warning( QWidget *parent, const QString &amp;caption,
134 const QString&amp; text,
135 int button0, int button1, int button2=0 );
136 static int warning( QWidget *parent, const QString &amp;caption,
137 const QString&amp; text,
138 const QString&amp; button0Text = QString::null,
139 const QString&amp; button1Text = QString::null,
140 const QString&amp; button2Text = QString::null,
141 int defaultButtonNumber = 0,
142 int escapeButtonNumber = -1 );
143
144 static int critical( QWidget *parent, const QString &amp;caption,
145 const QString&amp; text,
146 int button0, int button1, int button2=0 );
147 static int critical( QWidget *parent, const QString &amp;caption,
148 const QString&amp; text,
149 const QString&amp; button0Text = QString::null,
150 const QString&amp; button1Text = QString::null,
151 const QString&amp; button2Text = QString::null,
152 int defaultButtonNumber = 0,
153 int escapeButtonNumber = -1 );
154
155 static void about( QWidget *parent, const QString &amp;caption,
156 const QString&amp; text );
157
158 static void aboutQt( QWidget *parent,
159 const QString&amp; caption=QString::null );
160
161/* OBSOLETE */
162 static int message( const QString &amp;caption,
163 const QString&amp; text,
164 const QString&amp; buttonText=QString::null,
165 QWidget *parent=0, const char * =0 ) {
166 return QMessageBox::information( parent, caption, text,
167 buttonText.isEmpty()
168 ? tr("OK") : buttonText ) == 0;
169 }
170
171/* OBSOLETE */
172 static bool query( const QString &amp;caption,
173 const QString&amp; text,
174 const QString&amp; yesButtonText=QString::null,
175 const QString&amp; noButtonText=QString::null,
176 QWidget *parent=0, const char * = 0 ) {
177 return QMessageBox::information( parent, caption, text,
178 yesButtonText.isEmpty()
179 ? tr("OK") : yesButtonText,
180 noButtonText ) == 0;
181 }
182
183 QString text() const;
184 void setText( const QString &amp;);
185
186 Icon icon() const;
187
188 void setIcon( Icon );
189 void setIcon( const QPixmap &amp; );
190
191 const QPixmap *iconPixmap() const;
192 void setIconPixmap( const QPixmap &amp; );
193
194 QString buttonText( int button ) const;
195 void setButtonText( int button, const QString &amp;);
196
197 void adjustSize();
198
199/* OBSOLETE */
200 static QPixmap standardIcon( Icon icon, GUIStyle );
201
202 static QPixmap standardIcon( Icon icon );
203
204 TextFormat textFormat() const;
205 void setTextFormat( TextFormat );
206
207protected:
208 void resizeEvent( QResizeEvent * );
209 void showEvent( QShowEvent * );
210 void closeEvent( QCloseEvent * );
211 void keyPressEvent( QKeyEvent * );
212 void styleChanged( QStyle&amp; );
213
214private slots:
215 void buttonClicked();
216
217private:
218 void init( int, int, int );
219 int indexOf( int ) const;
220 void resizeButtons();
221 QLabel *label;
222 QMessageBoxData *mbd;
223 void *reserved1;
224 void *reserved2;
225
226private: // Disabled copy constructor and operator=
227#if defined(Q_DISABLE_COPY)
228 QMessageBox( const QMessageBox &amp; );
229 QMessageBox &amp;operator=( const QMessageBox &amp; );
230#endif
231};
232
233/*
234* Macro to be used at the beginning of main(), e.g.
235*
236* #include &lt;qapplication.h&gt;
237* #include &lt;qmessagebox.h&gt;
238* int main( int argc, char**argv )
239* {
240* QT_REQUIRE_VERSION( argc, argv, "3.0.5" )
241* ...
242* }
243*/
244#define QT_REQUIRE_VERSION( argc, argv, str ) { QString s=QString::fromLatin1(str);\
245QString sq=QString::fromLatin1(qVersion()); if ( (sq.section('.',0,0).toInt()&lt;&lt;16)+\
246(sq.section('.',1,1).toInt()&lt;&lt;8)+sq.section('.',2,2).toInt()&lt;(s.section('.',0,0).toInt()&lt;&lt;16)+\
247(s.section('.',1,1).toInt()&lt;&lt;8)+s.section('.',2,2).toInt() ){if ( !qApp){ int c=0; new \
248QApplication(argc,argv);} QString s = QApplication::tr("Executable '%1' requires Qt "\
249 "%2, found Qt %3.").arg(QString::fromLatin1(qAppName())).arg(QString::fromLatin1(\
250str)).arg(QString::fromLatin1(qVersion()) ); QMessageBox::critical( 0, QApplication::tr(\
251"Incompatible Qt Library Error" ), s, QMessageBox::Abort,0 ); qFatal(s.ascii()); }}
252
253
254#endif // QT_NO_MESSAGEBOX
255
256#endif // QMESSAGEBOX_H
257</pre>
258<!-- eof -->
259<p><address><hr><div align=center>
260<table width=100% cellspacing=0 border=0><tr>
261<td>Copyright &copy; 2007
262<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
263<td align=right><div align=right>Qt 3.3.8</div>
264</table></div></address></body>
265</html>
Note: See TracBrowser for help on using the repository browser.