messagebox.h

Go to the documentation of this file.

/*
 *  messagebox.h  -  enhanced KMessageBox class
 *  Program:  kalarm
 *  Copyright © 2004,2007,2011 by David Jarvie <djarvie@kde.org>
 *
 *  This program is free software; you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License as published by
 *  the Free Software Foundation; either version 2 of the License, or
 *  (at your option) any later version.
 *
 *  This program is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
 *  GNU General Public License for more details.
 *
 *  You should have received a copy of the GNU General Public License along
 *  with this program; if not, write to the Free Software Foundation, Inc.,
 *  51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

#ifndef MESSAGEBOX_H
#define MESSAGEBOX_H

#include <kdeversion.h>
#include <kstandardguiitem.h>
#include <kmessagebox.h>

class KAMessageBox : public KMessageBox
{
    public:
        enum AskType {      // KAMessageBox types
            CONT_CANCEL_DEF_CONT,    // Continue/Cancel, with default = Continue
            CONT_CANCEL_DEF_CANCEL,  // Continue/Cancel, with default = Cancel
            YES_NO_DEF_NO            // Yes/No, with default = No
        };
        static ButtonCode getContinueDefault(const QString& dontAskAgainName);
        static void setContinueDefault(const QString& dontAskAgainName, ButtonCode defaultButton);
        static int  warningContinueCancel(QWidget* parent, ButtonCode defaultButton, const QString& text,
                                          const QString& caption = QString(),
                                          const KGuiItem& buttonContinue = KStandardGuiItem::cont(),
                                          const QString& dontAskAgainName = QString());
        static bool setDefaultShouldBeShownContinue(const QString& dontShowAgainName, bool defaultShow);
        static bool shouldBeShownContinue(const QString& dontShowAgainName);
        static void saveDontShowAgainYesNo(const QString& dontShowAgainName, bool dontShow = true, ButtonCode result = No);
        static void saveDontShowAgainContinue(const QString& dontShowAgainName, bool dontShow = true);

        static void detailedError(QWidget* parent, const QString& text, const QString& details,
                                  const QString& caption = QString(), Options options = Options(Notify|WindowModal))
        { KMessageBox::detailedError(parent, text, details, caption, options); }

        static void detailedSorry(QWidget* parent, const QString& text, const QString& details,
                                  const QString& caption = QString(), Options options = Options(Notify|WindowModal))
        { KMessageBox::detailedSorry(parent, text, details, caption, options); }

        static void error(QWidget* parent, const QString& text, const QString& caption = QString(),
                          Options options = Options(Notify|WindowModal))
        { KMessageBox::error(parent, text, caption, options); }

        static void information(QWidget* parent, const QString& text, const QString& caption = QString(),
                                const QString& dontShowAgainName = QString(), Options options = Options(Notify|WindowModal))
        { KMessageBox::information(parent, text, caption, dontShowAgainName, options); }

        static void sorry(QWidget* parent, const QString& text, const QString& caption = QString(),
                          Options options = Options(Notify|WindowModal))
        { KMessageBox::sorry(parent, text, caption, options); }

        static int questionYesNo(QWidget* parent, const QString& text, const QString& caption = QString(),
                                 const KGuiItem& buttonYes = KStandardGuiItem::yes(),
                                 const KGuiItem& buttonNo = KStandardGuiItem::no(),
                                 const QString& dontAskAgainName = QString(), Options options = Options(Notify|WindowModal))
        { return KMessageBox::questionYesNo(parent, text, caption, buttonYes, buttonNo, dontAskAgainName, options); }

        static int questionYesNoCancel(QWidget* parent, const QString& text, const QString& caption = QString(),
                                       const KGuiItem& buttonYes = KStandardGuiItem::yes(),
                                       const KGuiItem& buttonNo = KStandardGuiItem::no(),
                                       const KGuiItem &buttonCancel = KStandardGuiItem::cancel(),
                                       const QString& dontAskAgainName = QString(), Options options = Options(Notify|WindowModal))
        { return KMessageBox::questionYesNoCancel(parent, text, caption, buttonYes, buttonNo, buttonCancel, dontAskAgainName, options); }

        static int warningContinueCancel(QWidget* parent, const QString& text, const QString& caption = QString(),
                                         const KGuiItem& buttonContinue = KStandardGuiItem::cont(),
                                         const KGuiItem& buttonCancel = KStandardGuiItem::cancel(),
                                         const QString& dontAskAgainName = QString(), Options options = Options(Notify|WindowModal))
        { return KMessageBox::warningContinueCancel(parent, text, caption, buttonContinue, buttonCancel, dontAskAgainName, options); }

        static int warningYesNo(QWidget* parent, const QString& text, const QString& caption = QString(),
                                const KGuiItem& buttonYes = KStandardGuiItem::yes(),
                                const KGuiItem& buttonNo = KStandardGuiItem::no(),
                                const QString& dontAskAgainName = QString(), Options options = Options(Notify|Dangerous|WindowModal))
        { return KMessageBox::warningYesNo(parent, text, caption, buttonYes, buttonNo, dontAskAgainName, options); }

        static const Options NoAppModal;

#if !KDE_IS_VERSION(4,7,1)
        static const Option WindowModal = Notify;
#endif

    private:
        static void saveDontShowAgain(const QString& dontShowAgainName, bool yesno, bool dontShow, const char* yesnoResult = 0);
        static QMap<QString, ButtonCode> mContinueDefaults;
};

#endif

// vim: et sw=4: