/**************************************************************************** ** ** Copyright (C) 2014 Digia Plc and/or its subsidiary(-ies). ** Contact: http://www.qt-project.org/legal ** ** This file is part of Qt Creator. ** ** Commercial License Usage ** Licensees holding valid commercial Qt licenses may use this file in ** accordance with the commercial license agreement provided with the ** Software or, alternatively, in accordance with the terms contained in ** a written agreement between you and Digia. For licensing terms and ** conditions see http://www.qt.io/licensing. For further information ** use the contact form at http://www.qt.io/contact-us. ** ** GNU Lesser General Public License Usage ** Alternatively, this file may be used under the terms of the GNU Lesser ** General Public License version 2.1 or version 3 as published by the Free ** Software Foundation and appearing in the file LICENSE.LGPLv21 and ** LICENSE.LGPLv3 included in the packaging of this file. Please review the ** following information to ensure the GNU Lesser General Public License ** requirements will be met: https://www.gnu.org/licenses/lgpl.html and ** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. ** ** In addition, as a special exception, Digia gives you certain additional ** rights. These rights are described in the Digia Qt LGPL Exception ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package. ** ****************************************************************************/ #include "checkablemessagebox.h" #include "qtcassert.h" #include #include #include #include #include #include /*! \class Utils::CheckableMessageBox \brief The CheckableMessageBox class implements a message box suitable for questions with a "Do not ask me again" checkbox. Emulates the QMessageBox API with static conveniences. The message label can open external URLs. */ static const char kDoNotAskAgainKey[] = "DoNotAskAgain"; namespace Utils { class CheckableMessageBoxPrivate { public: CheckableMessageBoxPrivate(QDialog *q) : clickedButton(0) { QSizePolicy sizePolicy(QSizePolicy::Minimum, QSizePolicy::Preferred); pixmapLabel = new QLabel(q); sizePolicy.setHorizontalStretch(0); sizePolicy.setVerticalStretch(0); sizePolicy.setHeightForWidth(pixmapLabel->sizePolicy().hasHeightForWidth()); pixmapLabel->setSizePolicy(sizePolicy); pixmapLabel->setVisible(false); QSpacerItem *pixmapSpacer = new QSpacerItem(0, 5, QSizePolicy::Minimum, QSizePolicy::MinimumExpanding); messageLabel = new QLabel(q); messageLabel->setMinimumSize(QSize(300, 0)); messageLabel->setWordWrap(true); messageLabel->setOpenExternalLinks(true); messageLabel->setTextInteractionFlags(Qt::LinksAccessibleByKeyboard|Qt::LinksAccessibleByMouse); QSpacerItem *checkBoxRightSpacer = new QSpacerItem(1, 1, QSizePolicy::Expanding, QSizePolicy::Minimum); QSpacerItem *buttonSpacer = new QSpacerItem(0, 1, QSizePolicy::Minimum, QSizePolicy::Minimum); checkBox = new QCheckBox(q); checkBox->setText(CheckableMessageBox::tr("Do not ask again")); buttonBox = new QDialogButtonBox(q); buttonBox->setOrientation(Qt::Horizontal); buttonBox->setStandardButtons(QDialogButtonBox::Cancel|QDialogButtonBox::Ok); QVBoxLayout *verticalLayout = new QVBoxLayout(); verticalLayout->addWidget(pixmapLabel); verticalLayout->addItem(pixmapSpacer); QHBoxLayout *horizontalLayout_2 = new QHBoxLayout(); horizontalLayout_2->addLayout(verticalLayout); horizontalLayout_2->addWidget(messageLabel); QHBoxLayout *horizontalLayout = new QHBoxLayout(); horizontalLayout->addWidget(checkBox); horizontalLayout->addItem(checkBoxRightSpacer); QVBoxLayout *verticalLayout_2 = new QVBoxLayout(q); verticalLayout_2->addLayout(horizontalLayout_2); verticalLayout_2->addLayout(horizontalLayout); verticalLayout_2->addItem(buttonSpacer); verticalLayout_2->addWidget(buttonBox); } QLabel *pixmapLabel; QLabel *messageLabel; QCheckBox *checkBox; QDialogButtonBox *buttonBox; QAbstractButton *clickedButton; }; CheckableMessageBox::CheckableMessageBox(QWidget *parent) : QDialog(parent), d(new CheckableMessageBoxPrivate(this)) { setModal(true); setWindowFlags(windowFlags() & ~Qt::WindowContextHelpButtonHint); connect(d->buttonBox, SIGNAL(accepted()), SLOT(accept())); connect(d->buttonBox, SIGNAL(rejected()), SLOT(reject())); connect(d->buttonBox, SIGNAL(clicked(QAbstractButton*)), SLOT(slotClicked(QAbstractButton*))); } CheckableMessageBox::~CheckableMessageBox() { delete d; } void CheckableMessageBox::slotClicked(QAbstractButton *b) { d->clickedButton = b; } QAbstractButton *CheckableMessageBox::clickedButton() const { return d->clickedButton; } QDialogButtonBox::StandardButton CheckableMessageBox::clickedStandardButton() const { if (d->clickedButton) return d->buttonBox->standardButton(d->clickedButton); return QDialogButtonBox::NoButton; } QString CheckableMessageBox::text() const { return d->messageLabel->text(); } void CheckableMessageBox::setText(const QString &t) { d->messageLabel->setText(t); } QPixmap CheckableMessageBox::iconPixmap() const { if (const QPixmap *p = d->pixmapLabel->pixmap()) return QPixmap(*p); return QPixmap(); } void CheckableMessageBox::setIconPixmap(const QPixmap &p) { d->pixmapLabel->setPixmap(p); d->pixmapLabel->setVisible(!p.isNull()); } bool CheckableMessageBox::isChecked() const { return d->checkBox->isChecked(); } void CheckableMessageBox::setChecked(bool s) { d->checkBox->setChecked(s); } QString CheckableMessageBox::checkBoxText() const { return d->checkBox->text(); } void CheckableMessageBox::setCheckBoxText(const QString &t) { d->checkBox->setText(t); } bool CheckableMessageBox::isCheckBoxVisible() const { return d->checkBox->isVisible(); } void CheckableMessageBox::setCheckBoxVisible(bool v) { d->checkBox->setVisible(v); } QDialogButtonBox::StandardButtons CheckableMessageBox::standardButtons() const { return d->buttonBox->standardButtons(); } void CheckableMessageBox::setStandardButtons(QDialogButtonBox::StandardButtons s) { d->buttonBox->setStandardButtons(s); } QPushButton *CheckableMessageBox::button(QDialogButtonBox::StandardButton b) const { return d->buttonBox->button(b); } QPushButton *CheckableMessageBox::addButton(const QString &text, QDialogButtonBox::ButtonRole role) { return d->buttonBox->addButton(text, role); } QDialogButtonBox::StandardButton CheckableMessageBox::defaultButton() const { foreach (QAbstractButton *b, d->buttonBox->buttons()) if (QPushButton *pb = qobject_cast(b)) if (pb->isDefault()) return d->buttonBox->standardButton(pb); return QDialogButtonBox::NoButton; } void CheckableMessageBox::setDefaultButton(QDialogButtonBox::StandardButton s) { if (QPushButton *b = d->buttonBox->button(s)) { b->setDefault(true); b->setFocus(); } } QDialogButtonBox::StandardButton CheckableMessageBox::question(QWidget *parent, const QString &title, const QString &question, const QString &checkBoxText, bool *checkBoxSetting, QDialogButtonBox::StandardButtons buttons, QDialogButtonBox::StandardButton defaultButton) { CheckableMessageBox mb(parent); mb.setWindowTitle(title); mb.setIconPixmap(QMessageBox::standardIcon(QMessageBox::Question)); mb.setText(question); mb.setCheckBoxText(checkBoxText); mb.setChecked(*checkBoxSetting); mb.setStandardButtons(buttons); mb.setDefaultButton(defaultButton); mb.exec(); *checkBoxSetting = mb.isChecked(); return mb.clickedStandardButton(); } QDialogButtonBox::StandardButton CheckableMessageBox::information(QWidget *parent, const QString &title, const QString &text, const QString &checkBoxText, bool *checkBoxSetting, QDialogButtonBox::StandardButtons buttons, QDialogButtonBox::StandardButton defaultButton) { CheckableMessageBox mb(parent); mb.setWindowTitle(title); mb.setIconPixmap(QMessageBox::standardIcon(QMessageBox::Information)); mb.setText(text); mb.setCheckBoxText(checkBoxText); mb.setChecked(*checkBoxSetting); mb.setStandardButtons(buttons); mb.setDefaultButton(defaultButton); mb.exec(); *checkBoxSetting = mb.isChecked(); return mb.clickedStandardButton(); } QMessageBox::StandardButton CheckableMessageBox::dialogButtonBoxToMessageBoxButton(QDialogButtonBox::StandardButton db) { return static_cast(int(db)); } /*! Shows a message box with given \a title and \a text, and a \gui {Do not ask again} check box. If the user checks the check box and accepts the dialog with the \a acceptButton, further invocations of this function with the same \a settings and \a settingsSubKey will not show the dialog, but instantly return \a acceptButton. Returns the clicked button, or QDialogButtonBox::NoButton if the user rejects the dialog with the escape key, or \a acceptButton if the dialog is suppressed. */ QDialogButtonBox::StandardButton CheckableMessageBox::doNotAskAgainQuestion(QWidget *parent, const QString &title, const QString &text, QSettings *settings, const QString &settingsSubKey, QDialogButtonBox::StandardButtons buttons, QDialogButtonBox::StandardButton defaultButton, QDialogButtonBox::StandardButton acceptButton) { QTC_CHECK(settings); if (settings) { settings->beginGroup(QLatin1String(kDoNotAskAgainKey)); bool shouldNotAsk = settings->value(settingsSubKey, false).toBool(); settings->endGroup(); if (shouldNotAsk) return acceptButton; } CheckableMessageBox mb(parent); mb.setWindowTitle(title); mb.setIconPixmap(QMessageBox::standardIcon(QMessageBox::Question)); mb.setText(text); mb.setCheckBoxVisible(true); mb.setCheckBoxText(CheckableMessageBox::msgDoNotAskAgain()); mb.setChecked(false); mb.setStandardButtons(buttons); mb.setDefaultButton(defaultButton); mb.exec(); if (settings) { settings->beginGroup(QLatin1String(kDoNotAskAgainKey)); if (mb.isChecked() && (mb.clickedStandardButton() == acceptButton)) settings->setValue(settingsSubKey, true); else // clean up doesn't hurt settings->remove(settingsSubKey); settings->endGroup(); } return mb.clickedStandardButton(); } /*! Resets all suppression settings for doNotAskAgainQuestion() found in \a settings, so all these message boxes are shown again. */ void CheckableMessageBox::resetAllDoNotAskAgainQuestions(QSettings *settings) { QTC_ASSERT(settings, return); settings->beginGroup(QLatin1String(kDoNotAskAgainKey)); settings->remove(QString()); settings->endGroup(); } /*! Returns whether any message boxes from doNotAskAgainQuestion() are suppressed in the \a settings. */ bool CheckableMessageBox::hasSuppressedQuestions(QSettings *settings) { QTC_ASSERT(settings, return false); bool hasSuppressed = false; settings->beginGroup(QLatin1String(kDoNotAskAgainKey)); foreach (const QString &subKey, settings->childKeys()) { if (settings->value(subKey, false).toBool()) { hasSuppressed = true; break; } } settings->endGroup(); return hasSuppressed; } /*! Returns the standard \gui {Do not ask again} check box text. \sa doNotAskAgainQuestion() */ QString CheckableMessageBox::msgDoNotAskAgain() { return QApplication::translate("Utils::CheckableMessageBox", "Do not &ask again"); } } // namespace Utils