KDE 4.7 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 WindowModal = 32 00098 }; 00099 00100 Q_DECLARE_FLAGS(Options,Option) 00101 00102 00130 static int questionYesNo(QWidget *parent, 00131 const QString &text, 00132 const QString &caption = QString(), 00133 const KGuiItem &buttonYes = KStandardGuiItem::yes(), 00134 const KGuiItem &buttonNo = KStandardGuiItem::no(), 00135 const QString &dontAskAgainName = QString(), 00136 Options options = Notify); 00141 static int questionYesNoWId(WId parent_id, 00142 const QString &text, 00143 const QString &caption = QString(), 00144 const KGuiItem &buttonYes = KStandardGuiItem::yes(), 00145 const KGuiItem &buttonNo = KStandardGuiItem::no(), 00146 const QString &dontAskAgainName = QString(), 00147 Options options = Notify); 00178 static int questionYesNoCancel(QWidget *parent, 00179 const QString &text, 00180 const QString &caption = QString(), 00181 const KGuiItem &buttonYes = KStandardGuiItem::yes(), 00182 const KGuiItem &buttonNo = KStandardGuiItem::no(), 00183 const KGuiItem &buttonCancel = KStandardGuiItem::cancel(), 00184 const QString &dontAskAgainName = QString(), 00185 Options options = Notify); 00186 00191 static int questionYesNoCancelWId(WId parent_id, 00192 const QString &text, 00193 const QString &caption = QString(), 00194 const KGuiItem &buttonYes = KStandardGuiItem::yes(), 00195 const KGuiItem &buttonNo = KStandardGuiItem::no(), 00196 const KGuiItem &buttonCancel = KStandardGuiItem::cancel(), 00197 const QString &dontAskAgainName = QString(), 00198 Options options = Notify); 00199 00232 static int questionYesNoList(QWidget *parent, 00233 const QString &text, 00234 const QStringList &strlist, 00235 const QString &caption = QString(), 00236 const KGuiItem &buttonYes = KStandardGuiItem::yes(), 00237 const KGuiItem &buttonNo = KStandardGuiItem::no(), 00238 const QString &dontAskAgainName = QString(), 00239 Options options = Notify); 00240 00245 static int questionYesNoListWId(WId parent_id, 00246 const QString &text, 00247 const QStringList &strlist, 00248 const QString &caption = QString(), 00249 const KGuiItem &buttonYes = KStandardGuiItem::yes(), 00250 const KGuiItem &buttonNo = KStandardGuiItem::no(), 00251 const QString &dontAskAgainName = QString(), 00252 Options options = Notify); 00253 00282 static int warningYesNo(QWidget *parent, 00283 const QString &text, 00284 const QString &caption = QString(), 00285 const KGuiItem &buttonYes = KStandardGuiItem::yes(), 00286 const KGuiItem &buttonNo = KStandardGuiItem::no(), 00287 const QString &dontAskAgainName = QString(), 00288 Options options = Options(Notify | Dangerous)); 00289 00294 static int warningYesNoWId(WId parent_id, 00295 const QString &text, 00296 const QString &caption = QString(), 00297 const KGuiItem &buttonYes = KStandardGuiItem::yes(), 00298 const KGuiItem &buttonNo = KStandardGuiItem::no(), 00299 const QString &dontAskAgainName = QString(), 00300 Options options = Options(Notify | Dangerous)); 00301 00334 static int warningYesNoList(QWidget *parent, 00335 const QString &text, 00336 const QStringList &strlist, 00337 const QString &caption = QString(), 00338 const KGuiItem &buttonYes = KStandardGuiItem::yes(), 00339 const KGuiItem &buttonNo = KStandardGuiItem::no(), 00340 const QString &dontAskAgainName = QString(), 00341 Options options = Options(Notify | Dangerous)); 00342 00347 static int warningYesNoListWId(WId parent_id, 00348 const QString &text, 00349 const QStringList &strlist, 00350 const QString &caption = QString(), 00351 const KGuiItem &buttonYes = KStandardGuiItem::yes(), 00352 const KGuiItem &buttonNo = KStandardGuiItem::no(), 00353 const QString &dontAskAgainName = QString(), 00354 Options options = Options(Notify | Dangerous)); 00355 00384 static int warningContinueCancel(QWidget *parent, 00385 const QString &text, 00386 const QString &caption = QString(), 00387 const KGuiItem &buttonContinue = KStandardGuiItem::cont(), 00388 const KGuiItem &buttonCancel = KStandardGuiItem::cancel(), 00389 const QString &dontAskAgainName = QString(), 00390 Options options = Notify); 00391 00396 static int warningContinueCancelWId(WId parent_id, 00397 const QString &text, 00398 const QString &caption = QString(), 00399 const KGuiItem &buttonContinue = KStandardGuiItem::cont(), 00400 const KGuiItem &buttonCancel = KStandardGuiItem::cancel(), 00401 const QString &dontAskAgainName = QString(), 00402 Options options = Notify); 00403 00436 static int warningContinueCancelList(QWidget *parent, 00437 const QString &text, 00438 const QStringList &strlist, 00439 const QString &caption = QString(), 00440 const KGuiItem &buttonContinue = KStandardGuiItem::cont(), 00441 const KGuiItem &buttonCancel = KStandardGuiItem::cancel(), 00442 const QString &dontAskAgainName = QString(), 00443 Options options = Notify); 00444 00449 static int warningContinueCancelListWId(WId parent_id, 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 00492 static int warningYesNoCancel(QWidget *parent, 00493 const QString &text, 00494 const QString &caption = QString(), 00495 const KGuiItem &buttonYes = KStandardGuiItem::yes(), 00496 const KGuiItem &buttonNo = KStandardGuiItem::no(), 00497 const KGuiItem &buttonCancel = KStandardGuiItem::cancel(), 00498 const QString &dontAskAgainName = QString(), 00499 Options options = Notify); 00500 00505 static int warningYesNoCancelWId(WId parent_id, 00506 const QString &text, 00507 const QString &caption = QString(), 00508 const KGuiItem &buttonYes = KStandardGuiItem::yes(), 00509 const KGuiItem &buttonNo = KStandardGuiItem::no(), 00510 const KGuiItem &buttonCancel = KStandardGuiItem::cancel(), 00511 const QString &dontAskAgainName = QString(), 00512 Options options = Notify); 00513 00551 static int warningYesNoCancelList(QWidget *parent, 00552 const QString &text, 00553 const QStringList &strlist, 00554 const QString &caption = QString(), 00555 const KGuiItem &buttonYes = KStandardGuiItem::yes(), 00556 const KGuiItem &buttonNo = KStandardGuiItem::no(), 00557 const KGuiItem &buttonCancel = KStandardGuiItem::cancel(), 00558 const QString &dontAskAgainName = QString(), 00559 Options options = Notify); 00560 00565 static int warningYesNoCancelListWId(WId parent_id, 00566 const QString &text, 00567 const QStringList &strlist, 00568 const QString &caption = QString(), 00569 const KGuiItem &buttonYes = KStandardGuiItem::yes(), 00570 const KGuiItem &buttonNo = KStandardGuiItem::no(), 00571 const KGuiItem &buttonCancel = KStandardGuiItem::cancel(), 00572 const QString &dontAskAgainName = QString(), 00573 Options options = Notify); 00574 00596 static void error(QWidget *parent, 00597 const QString &text, 00598 const QString &caption = QString(), 00599 Options options = Notify); 00600 00605 static void errorWId(WId parent_id, 00606 const QString &text, 00607 const QString &caption = QString(), 00608 Options options = Notify); 00609 00634 static void errorList(QWidget *parent, 00635 const QString &text, 00636 const QStringList &strlist, 00637 const QString &caption = QString(), 00638 Options options = Notify); 00639 00645 static void errorListWId(WId parent_id, 00646 const QString &text, 00647 const QStringList &strlist, 00648 const QString &caption = QString(), 00649 Options options = Notify); 00650 00675 static void detailedError(QWidget *parent, 00676 const QString &text, 00677 const QString &details, 00678 const QString &caption = QString(), 00679 Options options = Notify); 00680 00685 static void detailedErrorWId(WId parent_id, 00686 const QString &text, 00687 const QString &details, 00688 const QString &caption = QString(), 00689 Options options = Notify); 00690 00701 static void queuedDetailedError( QWidget *parent, 00702 const QString &text, 00703 const QString &details, 00704 const QString &caption = QString()); 00705 00710 static void queuedDetailedErrorWId( WId parent_id, 00711 const QString &text, 00712 const QString &details, 00713 const QString &caption = QString()); 00714 00735 static void sorry(QWidget *parent, 00736 const QString &text, 00737 const QString &caption = QString(), 00738 Options options = Notify); 00739 00744 static void sorryWId(WId parent_id, 00745 const QString &text, 00746 const QString &caption = QString(), 00747 Options options = Notify); 00748 00775 static void detailedSorry(QWidget *parent, 00776 const QString &text, 00777 const QString &details, 00778 const QString &caption = QString(), 00779 Options options = Notify); 00780 00785 static void detailedSorryWId(WId parent_id, 00786 const QString &text, 00787 const QString &details, 00788 const QString &caption = QString(), 00789 Options options = Notify); 00790 00815 static void information(QWidget *parent, 00816 const QString &text, 00817 const QString &caption = QString(), 00818 const QString &dontShowAgainName = QString(), 00819 Options options = Notify); 00820 00825 static void informationWId(WId parent_id, 00826 const QString &text, 00827 const QString &caption = QString(), 00828 const QString &dontShowAgainName = QString(), 00829 Options options = Notify); 00830 00858 static void informationList(QWidget *parent, 00859 const QString &text, 00860 const QStringList & strlist, 00861 const QString &caption = QString(), 00862 const QString &dontShowAgainName = QString(), 00863 Options options = Notify); 00864 00869 static void informationListWId(WId parent_id, 00870 const QString &text, 00871 const QStringList & strlist, 00872 const QString &caption = QString(), 00873 const QString &dontShowAgainName = QString(), 00874 Options options = Notify); 00875 00880 static void enableAllMessages(); 00881 00888 static void enableMessage(const QString &dontShowAgainName); 00889 00907 static void about(QWidget *parent, 00908 const QString& text, 00909 const QString& caption = QString(), 00910 Options options = Notify); 00911 00937 static int messageBox( QWidget *parent, DialogType type, const QString &text, 00938 const QString &caption = QString(), 00939 const KGuiItem &buttonYes = KStandardGuiItem::yes(), 00940 const KGuiItem &buttonNo = KStandardGuiItem::no(), 00941 const KGuiItem &buttonCancel = KStandardGuiItem::cancel(), 00942 const QString &dontShowAskAgainName = QString(), 00943 Options options = Notify); 00944 00949 static int messageBoxWId( WId parent_id, DialogType type, const QString &text, 00950 const QString &caption = QString(), 00951 const KGuiItem &buttonYes = KStandardGuiItem::yes(), 00952 const KGuiItem &buttonNo = KStandardGuiItem::no(), 00953 const KGuiItem &buttonCancel = KStandardGuiItem::cancel(), 00954 const QString &dontShowAskAgainName = QString(), 00955 Options options = Notify); 00956 00969 static void queuedMessageBox( QWidget *parent, 00970 DialogType type, const QString &text, 00971 const QString &caption, 00972 Options options ); 00973 00978 static void queuedMessageBoxWId( WId parent_id, 00979 DialogType type, const QString &text, 00980 const QString &caption, 00981 Options options ); 00982 00989 static void queuedMessageBox( QWidget *parent, 00990 DialogType type, const QString &text, 00991 const QString &caption = QString() ); 00992 00997 static void queuedMessageBoxWId( WId parent_id, 00998 DialogType type, const QString &text, 00999 const QString &caption = QString() ); 01000 01009 static bool shouldBeShownYesNo(const QString &dontShowAgainName, 01010 ButtonCode &result); 01017 static bool shouldBeShownContinue(const QString &dontShowAgainName); 01018 01026 static void saveDontShowAgainYesNo(const QString &dontShowAgainName, 01027 ButtonCode result); 01028 01035 static void saveDontShowAgainContinue(const QString &dontShowAgainName); 01036 01041 static void setDontShowAskAgainConfig(KConfig* cfg); 01042 01067 static int createKMessageBox(KDialog *dialog, QMessageBox::Icon icon, //krazy:exclude=qclasses 01068 const QString &text, const QStringList &strlist, 01069 const QString &ask, bool *checkboxReturn, 01070 Options options, const QString &details=QString()); 01071 01099 static int createKMessageBox(KDialog *dialog, const QIcon &icon, 01100 const QString &text, const QStringList &strlist, 01101 const QString &ask, bool *checkboxReturn, 01102 Options options, const QString &details=QString(), 01103 QMessageBox::Icon notifyType=QMessageBox::Information); //krazy:exclude=qclasses 01104 }; 01105 01106 Q_DECLARE_OPERATORS_FOR_FLAGS(KMessageBox::Options) 01107 01108 01109 #endif
