/**************************************************************************** ** ** Copyright (C) 2012 Nokia Corporation and/or its subsidiary(-ies). ** Contact: http://www.qt-project.org/ ** ** This file is part of the QtGui module of the Qt Toolkit. ** ** $QT_BEGIN_LICENSE:LGPL$ ** GNU Lesser General Public License Usage ** This file may be used under the terms of the GNU Lesser General Public ** License version 2.1 as published by the Free Software Foundation and ** appearing in the file LICENSE.LGPL included in the packaging of this ** file. Please review the following information to ensure the GNU Lesser ** General Public License version 2.1 requirements will be met: ** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. ** ** In addition, as a special exception, Nokia gives you certain additional ** rights. These rights are described in the Nokia Qt LGPL Exception ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package. ** ** GNU General Public License Usage ** Alternatively, this file may be used under the terms of the GNU General ** Public License version 3.0 as published by the Free Software Foundation ** and appearing in the file LICENSE.GPL included in the packaging of this ** file. Please review the following information to ensure the GNU General ** Public License version 3.0 requirements will be met: ** http://www.gnu.org/copyleft/gpl.html. ** ** Other Usage ** Alternatively, this file may be used in accordance with the terms and ** conditions contained in a signed written agreement between you and Nokia. ** ** ** ** ** ** ** $QT_END_LICENSE$ ** ****************************************************************************/ #ifndef QMESSAGEBOX_H #define QMESSAGEBOX_H #include QT_BEGIN_HEADER QT_BEGIN_NAMESPACE #ifndef QT_NO_MESSAGEBOX class QLabel; class QMessageBoxPrivate; class QAbstractButton; class Q_WIDGETS_EXPORT QMessageBox : public QDialog { Q_OBJECT Q_ENUMS(Icon) Q_FLAGS(StandardButtons) Q_PROPERTY(QString text READ text WRITE setText) Q_PROPERTY(Icon icon READ icon WRITE setIcon) Q_PROPERTY(QPixmap iconPixmap READ iconPixmap WRITE setIconPixmap) Q_PROPERTY(Qt::TextFormat textFormat READ textFormat WRITE setTextFormat) Q_PROPERTY(StandardButtons standardButtons READ standardButtons WRITE setStandardButtons) #ifndef QT_NO_TEXTEDIT Q_PROPERTY(QString detailedText READ detailedText WRITE setDetailedText) #endif Q_PROPERTY(QString informativeText READ informativeText WRITE setInformativeText) public: enum Icon { NoIcon = 0, Information = 1, Warning = 2, Critical = 3, Question = 4 }; enum ButtonRole { // keep this in sync with QDialogButtonBox::ButtonRole InvalidRole = -1, AcceptRole, RejectRole, DestructiveRole, ActionRole, HelpRole, YesRole, NoRole, ResetRole, ApplyRole, NRoles }; enum StandardButton { // keep this in sync with QDialogButtonBox::StandardButton NoButton = 0x00000000, Ok = 0x00000400, Save = 0x00000800, SaveAll = 0x00001000, Open = 0x00002000, Yes = 0x00004000, YesToAll = 0x00008000, No = 0x00010000, NoToAll = 0x00020000, Abort = 0x00040000, Retry = 0x00080000, Ignore = 0x00100000, Close = 0x00200000, Cancel = 0x00400000, Discard = 0x00800000, Help = 0x01000000, Apply = 0x02000000, Reset = 0x04000000, RestoreDefaults = 0x08000000, FirstButton = Ok, // internal LastButton = RestoreDefaults, // internal YesAll = YesToAll, // obsolete NoAll = NoToAll, // obsolete Default = 0x00000100, // obsolete Escape = 0x00000200, // obsolete FlagMask = 0x00000300, // obsolete ButtonMask = ~FlagMask // obsolete }; typedef StandardButton Button; // obsolete Q_DECLARE_FLAGS(StandardButtons, StandardButton) explicit QMessageBox(QWidget *parent = 0); QMessageBox(Icon icon, const QString &title, const QString &text, StandardButtons buttons = NoButton, QWidget *parent = 0, Qt::WindowFlags flags = Qt::Dialog | Qt::MSWindowsFixedSizeDialogHint); ~QMessageBox(); void addButton(QAbstractButton *button, ButtonRole role); QPushButton *addButton(const QString &text, ButtonRole role); QPushButton *addButton(StandardButton button); void removeButton(QAbstractButton *button); #ifdef Q_WS_WINCE void setVisible(bool visible); #endif #ifdef Q_NO_USING_KEYWORD #ifndef Q_QDOC void open() { QDialog::open(); } #endif #else using QDialog::open; #endif void open(QObject *receiver, const char *member); QList buttons() const; ButtonRole buttonRole(QAbstractButton *button) const; void setStandardButtons(StandardButtons buttons); StandardButtons standardButtons() const; StandardButton standardButton(QAbstractButton *button) const; QAbstractButton *button(StandardButton which) const; QPushButton *defaultButton() const; void setDefaultButton(QPushButton *button); void setDefaultButton(StandardButton button); QAbstractButton *escapeButton() const; void setEscapeButton(QAbstractButton *button); void setEscapeButton(StandardButton button); QAbstractButton *clickedButton() const; QString text() const; void setText(const QString &text); Icon icon() const; void setIcon(Icon); QPixmap iconPixmap() const; void setIconPixmap(const QPixmap &pixmap); Qt::TextFormat textFormat() const; void setTextFormat(Qt::TextFormat format); static StandardButton information(QWidget *parent, const QString &title, const QString &text, StandardButtons buttons = Ok, StandardButton defaultButton = NoButton); static StandardButton question(QWidget *parent, const QString &title, const QString &text, StandardButtons buttons = StandardButtons(Yes | No), StandardButton defaultButton = NoButton); static StandardButton warning(QWidget *parent, const QString &title, const QString &text, StandardButtons buttons = Ok, StandardButton defaultButton = NoButton); static StandardButton critical(QWidget *parent, const QString &title, const QString &text, StandardButtons buttons = Ok, StandardButton defaultButton = NoButton); static void about(QWidget *parent, const QString &title, const QString &text); static void aboutQt(QWidget *parent, const QString &title = QString()); // the following functions are obsolete: QMessageBox(const QString &title, const QString &text, Icon icon, int button0, int button1, int button2, QWidget *parent = 0, Qt::WindowFlags f = Qt::Dialog | Qt::MSWindowsFixedSizeDialogHint); static int information(QWidget *parent, const QString &title, const QString& text, int button0, int button1 = 0, int button2 = 0); static int information(QWidget *parent, const QString &title, const QString& text, const QString& button0Text, const QString& button1Text = QString(), const QString& button2Text = QString(), int defaultButtonNumber = 0, int escapeButtonNumber = -1); inline static StandardButton information(QWidget *parent, const QString &title, const QString& text, StandardButton button0, StandardButton button1 = NoButton) { return information(parent, title, text, StandardButtons(button0), button1); } static int question(QWidget *parent, const QString &title, const QString& text, int button0, int button1 = 0, int button2 = 0); static int question(QWidget *parent, const QString &title, const QString& text, const QString& button0Text, const QString& button1Text = QString(), const QString& button2Text = QString(), int defaultButtonNumber = 0, int escapeButtonNumber = -1); inline static int question(QWidget *parent, const QString &title, const QString& text, StandardButton button0, StandardButton button1) { return question(parent, title, text, StandardButtons(button0), button1); } static int warning(QWidget *parent, const QString &title, const QString& text, int button0, int button1, int button2 = 0); static int warning(QWidget *parent, const QString &title, const QString& text, const QString& button0Text, const QString& button1Text = QString(), const QString& button2Text = QString(), int defaultButtonNumber = 0, int escapeButtonNumber = -1); inline static int warning(QWidget *parent, const QString &title, const QString& text, StandardButton button0, StandardButton button1) { return warning(parent, title, text, StandardButtons(button0), button1); } static int critical(QWidget *parent, const QString &title, const QString& text, int button0, int button1, int button2 = 0); static int critical(QWidget *parent, const QString &title, const QString& text, const QString& button0Text, const QString& button1Text = QString(), const QString& button2Text = QString(), int defaultButtonNumber = 0, int escapeButtonNumber = -1); inline static int critical(QWidget *parent, const QString &title, const QString& text, StandardButton button0, StandardButton button1) { return critical(parent, title, text, StandardButtons(button0), button1); } QString buttonText(int button) const; void setButtonText(int button, const QString &text); QString informativeText() const; void setInformativeText(const QString &text); #ifndef QT_NO_TEXTEDIT QString detailedText() const; void setDetailedText(const QString &text); #endif void setWindowTitle(const QString &title); void setWindowModality(Qt::WindowModality windowModality); static QPixmap standardIcon(Icon icon); Q_SIGNALS: void buttonClicked(QAbstractButton *button); #ifdef qdoc public Q_SLOTS: int exec(); #endif protected: bool event(QEvent *e); void resizeEvent(QResizeEvent *event); void showEvent(QShowEvent *event); void closeEvent(QCloseEvent *event); void keyPressEvent(QKeyEvent *event); void changeEvent(QEvent *event); private: Q_PRIVATE_SLOT(d_func(), void _q_buttonClicked(QAbstractButton *)) Q_DISABLE_COPY(QMessageBox) Q_DECLARE_PRIVATE(QMessageBox) }; Q_DECLARE_OPERATORS_FOR_FLAGS(QMessageBox::StandardButtons) #define QT_REQUIRE_VERSION(argc, argv, str) { QString s = QString::fromLatin1(str);\ QString sq = QString::fromLatin1(qVersion()); \ if ((sq.section(QChar::fromLatin1('.'),0,0).toInt()<<16)+\ (sq.section(QChar::fromLatin1('.'),1,1).toInt()<<8)+\ sq.section(QChar::fromLatin1('.'),2,2).toInt()<(s.section(QChar::fromLatin1('.'),0,0).toInt()<<16)+\ (s.section(QChar::fromLatin1('.'),1,1).toInt()<<8)+\ s.section(QChar::fromLatin1('.'),2,2).toInt()) { \ if (!qApp){ \ new QApplication(argc,argv); \ } \ QString s = QApplication::tr("Executable '%1' requires Qt "\ "%2, found Qt %3.").arg(qAppName()).arg(QString::fromLatin1(\ str)).arg(QString::fromLatin1(qVersion())); QMessageBox::critical(0, QApplication::tr(\ "Incompatible Qt Library Error"), s, QMessageBox::Abort, 0); qFatal("%s", s.toLatin1().data()); }} #endif // QT_NO_MESSAGEBOX QT_END_NAMESPACE QT_END_HEADER #endif // QMESSAGEBOX_H