KDE 4.6 API Reference KDEUI
kmessagebox.h
Go to the documentation of this file.
00001 /* This file is part of the KDE libraries 00002 Copyright (C) 1999 Waldo Bastian (bastian@kde.org) 00003 00004 This library is free software; you can redistribute it and/or 00005 modify it under the terms of the GNU Library General Public 00006 License as published by the Free Software Foundation; version 2 00007 of the License. 00008 00009 This library is distributed in the hope that it will be useful, 00010 but WITHOUT ANY WARRANTY; without even the implied warranty of 00011 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 00012 Library General Public License for more details. 00013 00014 You should have received a copy of the GNU Library General Public License 00015 along with this library; see the file COPYING.LIB. If not, write to 00016 the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, 00017 Boston, MA 02110-1301, USA. 00018 */ 00019 00020 //krazy:excludeall=dpointer 00021 00022 #ifndef KMESSAGEBOX_H 00023 #define KMESSAGEBOX_H 00024 00025 #include <QtGui/QMessageBox> 00026 00027 #include <kguiitem.h> 00028 #include <kstandardguiitem.h> 00029 00030 class QWidget; 00031 class QStringList; 00032 class KConfig; 00033 class KDialog; 00034 00062 class KDEUI_EXPORT KMessageBox 00063 { 00064 public: 00068 enum ButtonCode 00069 { 00070 Ok = 1, 00071 Cancel = 2, 00072 Yes = 3, 00073 No = 4, 00074 Continue = 5 00075 }; 00076 00077 enum DialogType 00078 { 00079 QuestionYesNo = 1, 00080 WarningYesNo = 2, 00081 WarningContinueCancel = 3, 00082 WarningYesNoCancel = 4, 00083 Information = 5, 00084 // Reserved for: SSLMessageBox = 6 00085 Sorry = 7, 00086 Error = 8, 00087 QuestionYesNoCancel = 9 00088 }; 00089 00090 enum Option 00091 { 00092 Notify = 1, 00093 AllowLink = 2, 00094 Dangerous = 4, 00095 PlainCaption = 8, 00096 NoExec = 16 00097 }; 00098 00099 Q_DECLARE_FLAGS(Options,Option) 00100 00101 00131 static int questionYesNo(QWidget *parent, 00132 const QString &text, 00133 const QString &caption = QString(), 00134 const KGuiItem &buttonYes = KStandardGuiItem::yes(), 00135 const KGuiItem &buttonNo = KStandardGuiItem::no(), 00136 const QString &dontAskAgainName = QString(), 00137 Options options = Notify); 00142 static int questionYesNoWId(WId parent_id, 00143 const QString &text, 00144 const QString &caption = QString(), 00145 const KGuiItem &buttonYes = KStandardGuiItem::yes(), 00146 const KGuiItem &buttonNo = KStandardGuiItem::no(), 00147 const QString &dontAskAgainName = QString(), 00148 Options options = Notify); 00181 static int questionYesNoCancel(QWidget *parent, 00182 const QString &text, 00183 const QString &caption = QString(), 00184 const KGuiItem &buttonYes = KStandardGuiItem::yes(), 00185 const KGuiItem &buttonNo = KStandardGuiItem::no(), 00186 const KGuiItem &buttonCancel = KStandardGuiItem::cancel(), 00187 const QString &dontAskAgainName = QString(), 00188 Options options = Notify); 00189 00194 static int questionYesNoCancelWId(WId parent_id, 00195 const QString &text, 00196 const QString &caption = QString(), 00197 const KGuiItem &buttonYes = KStandardGuiItem::yes(), 00198 const KGuiItem &buttonNo = KStandardGuiItem::no(), 00199 const KGuiItem &buttonCancel = KStandardGuiItem::cancel(), 00200 const QString &dontAskAgainName = QString(), 00201 Options options = Notify); 00202 00237 static int questionYesNoList(QWidget *parent, 00238 const QString &text, 00239 const QStringList &strlist, 00240 const QString &caption = QString(), 00241 const KGuiItem &buttonYes = KStandardGuiItem::yes(), 00242 const KGuiItem &buttonNo = KStandardGuiItem::no(), 00243 const QString &dontAskAgainName = QString(), 00244 Options options = Notify); 00245 00250 static int questionYesNoListWId(WId parent_id, 00251 const QString &text, 00252 const QStringList &strlist, 00253 const QString &caption = QString(), 00254 const KGuiItem &buttonYes = KStandardGuiItem::yes(), 00255 const KGuiItem &buttonNo = KStandardGuiItem::no(), 00256 const QString &dontAskAgainName = QString(), 00257 Options options = Notify); 00258 00289 static int warningYesNo(QWidget *parent, 00290 const QString &text, 00291 const QString &caption = QString(), 00292 const KGuiItem &buttonYes = KStandardGuiItem::yes(), 00293 const KGuiItem &buttonNo = KStandardGuiItem::no(), 00294 const QString &dontAskAgainName = QString(), 00295 Options options = Options(Notify | Dangerous)); 00296 00301 static int warningYesNoWId(WId parent_id, 00302 const QString &text, 00303 const QString &caption = QString(), 00304 const KGuiItem &buttonYes = KStandardGuiItem::yes(), 00305 const KGuiItem &buttonNo = KStandardGuiItem::no(), 00306 const QString &dontAskAgainName = QString(), 00307 Options options = Options(Notify | Dangerous)); 00308 00343 static int warningYesNoList(QWidget *parent, 00344 const QString &text, 00345 const QStringList &strlist, 00346 const QString &caption = QString(), 00347 const KGuiItem &buttonYes = KStandardGuiItem::yes(), 00348 const KGuiItem &buttonNo = KStandardGuiItem::no(), 00349 const QString &dontAskAgainName = QString(), 00350 Options options = Options(Notify | Dangerous)); 00351 00356 static int warningYesNoListWId(WId parent_id, 00357 const QString &text, 00358 const QStringList &strlist, 00359 const QString &caption = QString(), 00360 const KGuiItem &buttonYes = KStandardGuiItem::yes(), 00361 const KGuiItem &buttonNo = KStandardGuiItem::no(), 00362 const QString &dontAskAgainName = QString(), 00363 Options options = Options(Notify | Dangerous)); 00364 00395 static int warningContinueCancel(QWidget *parent, 00396 const QString &text, 00397 const QString &caption = QString(), 00398 const KGuiItem &buttonContinue = KStandardGuiItem::cont(), 00399 const KGuiItem &buttonCancel = KStandardGuiItem::cancel(), 00400 const QString &dontAskAgainName = QString(), 00401 Options options = Notify); 00402 00407 static int warningContinueCancelWId(WId parent_id, 00408 const QString &text, 00409 const QString &caption = QString(), 00410 const KGuiItem &buttonContinue = KStandardGuiItem::cont(), 00411 const KGuiItem &buttonCancel = KStandardGuiItem::cancel(), 00412 const QString &dontAskAgainName = QString(), 00413 Options options = Notify); 00414 00449 static int warningContinueCancelList(QWidget *parent, 00450 const QString &text, 00451 const QStringList &strlist, 00452 const QString &caption = QString(), 00453 const KGuiItem &buttonContinue = KStandardGuiItem::cont(), 00454 const KGuiItem &buttonCancel = KStandardGuiItem::cancel(), 00455 const QString &dontAskAgainName = QString(), 00456 Options options = Notify); 00457 00462 static int warningContinueCancelListWId(WId parent_id, 00463 const QString &text, 00464 const QStringList &strlist, 00465 const QString &caption = QString(), 00466 const KGuiItem &buttonContinue = KStandardGuiItem::cont(), 00467 const KGuiItem &buttonCancel = KStandardGuiItem::cancel(), 00468 const QString &dontAskAgainName = QString(), 00469 Options options = Notify); 00470 00507 static int warningYesNoCancel(QWidget *parent, 00508 const QString &text, 00509 const QString &caption = QString(), 00510 const KGuiItem &buttonYes = KStandardGuiItem::yes(), 00511 const KGuiItem &buttonNo = KStandardGuiItem::no(), 00512 const KGuiItem &buttonCancel = KStandardGuiItem::cancel(), 00513 const QString &dontAskAgainName = QString(), 00514 Options options = Notify); 00515 00520 static int warningYesNoCancelWId(WId parent_id, 00521 const QString &text, 00522 const QString &caption = QString(), 00523 const KGuiItem &buttonYes = KStandardGuiItem::yes(), 00524 const KGuiItem &buttonNo = KStandardGuiItem::no(), 00525 const KGuiItem &buttonCancel = KStandardGuiItem::cancel(), 00526 const QString &dontAskAgainName = QString(), 00527 Options options = Notify); 00528 00568 static int warningYesNoCancelList(QWidget *parent, 00569 const QString &text, 00570 const QStringList &strlist, 00571 const QString &caption = QString(), 00572 const KGuiItem &buttonYes = KStandardGuiItem::yes(), 00573 const KGuiItem &buttonNo = KStandardGuiItem::no(), 00574 const KGuiItem &buttonCancel = KStandardGuiItem::cancel(), 00575 const QString &dontAskAgainName = QString(), 00576 Options options = Notify); 00577 00582 static int warningYesNoCancelListWId(WId parent_id, 00583 const QString &text, 00584 const QStringList &strlist, 00585 const QString &caption = QString(), 00586 const KGuiItem &buttonYes = KStandardGuiItem::yes(), 00587 const KGuiItem &buttonNo = KStandardGuiItem::no(), 00588 const KGuiItem &buttonCancel = KStandardGuiItem::cancel(), 00589 const QString &dontAskAgainName = QString(), 00590 Options options = Notify); 00591 00615 static void error(QWidget *parent, 00616 const QString &text, 00617 const QString &caption = QString(), 00618 Options options = Notify); 00619 00624 static void errorWId(WId parent_id, 00625 const QString &text, 00626 const QString &caption = QString(), 00627 Options options = Notify); 00628 00655 static void errorList(QWidget *parent, 00656 const QString &text, 00657 const QStringList &strlist, 00658 const QString &caption = QString(), 00659 Options options = Notify); 00660 00666 static void errorListWId(WId parent_id, 00667 const QString &text, 00668 const QStringList &strlist, 00669 const QString &caption = QString(), 00670 Options options = Notify); 00671 00698 static void detailedError(QWidget *parent, 00699 const QString &text, 00700 const QString &details, 00701 const QString &caption = QString(), 00702 Options options = Notify); 00703 00708 static void detailedErrorWId(WId parent_id, 00709 const QString &text, 00710 const QString &details, 00711 const QString &caption = QString(), 00712 Options options = Notify); 00713 00724 static void queuedDetailedError( QWidget *parent, 00725 const QString &text, 00726 const QString &details, 00727 const QString &caption = QString()); 00728 00733 static void queuedDetailedErrorWId( WId parent_id, 00734 const QString &text, 00735 const QString &details, 00736 const QString &caption = QString()); 00737 00760 static void sorry(QWidget *parent, 00761 const QString &text, 00762 const QString &caption = QString(), 00763 Options options = Notify); 00764 00769 static void sorryWId(WId parent_id, 00770 const QString &text, 00771 const QString &caption = QString(), 00772 Options options = Notify); 00773 00802 static void detailedSorry(QWidget *parent, 00803 const QString &text, 00804 const QString &details, 00805 const QString &caption = QString(), 00806 Options options = Notify); 00807 00812 static void detailedSorryWId(WId parent_id, 00813 const QString &text, 00814 const QString &details, 00815 const QString &caption = QString(), 00816 Options options = Notify); 00817 00844 static void information(QWidget *parent, 00845 const QString &text, 00846 const QString &caption = QString(), 00847 const QString &dontShowAgainName = QString(), 00848 Options options = Notify); 00849 00854 static void informationWId(WId parent_id, 00855 const QString &text, 00856 const QString &caption = QString(), 00857 const QString &dontShowAgainName = QString(), 00858 Options options = Notify); 00859 00889 static void informationList(QWidget *parent, 00890 const QString &text, 00891 const QStringList & strlist, 00892 const QString &caption = QString(), 00893 const QString &dontShowAgainName = QString(), 00894 Options options = Notify); 00895 00900 static void informationListWId(WId parent_id, 00901 const QString &text, 00902 const QStringList & strlist, 00903 const QString &caption = QString(), 00904 const QString &dontShowAgainName = QString(), 00905 Options options = Notify); 00906 00911 static void enableAllMessages(); 00912 00919 static void enableMessage(const QString &dontShowAgainName); 00920 00940 static void about(QWidget *parent, 00941 const QString& text, 00942 const QString& caption = QString(), 00943 Options options = Notify); 00944 00972 static int messageBox( QWidget *parent, DialogType type, const QString &text, 00973 const QString &caption = QString(), 00974 const KGuiItem &buttonYes = KStandardGuiItem::yes(), 00975 const KGuiItem &buttonNo = KStandardGuiItem::no(), 00976 const KGuiItem &buttonCancel = KStandardGuiItem::cancel(), 00977 const QString &dontShowAskAgainName = QString(), 00978 Options options = Notify); 00979 00984 static int messageBoxWId( WId parent_id, DialogType type, const QString &text, 00985 const QString &caption = QString(), 00986 const KGuiItem &buttonYes = KStandardGuiItem::yes(), 00987 const KGuiItem &buttonNo = KStandardGuiItem::no(), 00988 const KGuiItem &buttonCancel = KStandardGuiItem::cancel(), 00989 const QString &dontShowAskAgainName = QString(), 00990 Options options = Notify); 00991 01004 static void queuedMessageBox( QWidget *parent, 01005 DialogType type, const QString &text, 01006 const QString &caption, 01007 Options options ); 01008 01013 static void queuedMessageBoxWId( WId parent_id, 01014 DialogType type, const QString &text, 01015 const QString &caption, 01016 Options options ); 01017 01024 static void queuedMessageBox( QWidget *parent, 01025 DialogType type, const QString &text, 01026 const QString &caption = QString() ); 01027 01032 static void queuedMessageBoxWId( WId parent_id, 01033 DialogType type, const QString &text, 01034 const QString &caption = QString() ); 01035 01044 static bool shouldBeShownYesNo(const QString &dontShowAgainName, 01045 ButtonCode &result); 01052 static bool shouldBeShownContinue(const QString &dontShowAgainName); 01053 01061 static void saveDontShowAgainYesNo(const QString &dontShowAgainName, 01062 ButtonCode result); 01063 01070 static void saveDontShowAgainContinue(const QString &dontShowAgainName); 01071 01076 static void setDontShowAskAgainConfig(KConfig* cfg); 01077 01102 static int createKMessageBox(KDialog *dialog, QMessageBox::Icon icon, //krazy:exclude=qclasses 01103 const QString &text, const QStringList &strlist, 01104 const QString &ask, bool *checkboxReturn, 01105 Options options, const QString &details=QString()); 01106 01134 static int createKMessageBox(KDialog *dialog, const QIcon &icon, 01135 const QString &text, const QStringList &strlist, 01136 const QString &ask, bool *checkboxReturn, 01137 Options options, const QString &details=QString(), 01138 QMessageBox::Icon notifyType=QMessageBox::Information); //krazy:exclude=qclasses 01139 }; 01140 01141 Q_DECLARE_OPERATORS_FOR_FLAGS(KMessageBox::Options) 01142 01143 01144 #endif
