00001
00002
00003
00004
00005
00006
00007
00008
00009
00010
00011
00012
00013
00014
00015
00016
00017
00018
00019
00020
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
00060 class KDEUI_EXPORT KMessageBox
00061 {
00062 public:
00066 enum ButtonCode
00067 {
00068 Ok = 1,
00069 Cancel = 2,
00070 Yes = 3,
00071 No = 4,
00072 Continue = 5
00073 };
00074
00075 enum DialogType
00076 {
00077 QuestionYesNo = 1,
00078 WarningYesNo = 2,
00079 WarningContinueCancel = 3,
00080 WarningYesNoCancel = 4,
00081 Information = 5,
00082
00083 Sorry = 7,
00084 Error = 8,
00085 QuestionYesNoCancel = 9
00086 };
00087
00088 enum Option
00089 {
00090 Notify = 1,
00091 AllowLink = 2,
00092 Dangerous = 4,
00093 PlainCaption = 8,
00094 NoExec = 16
00095 };
00096
00097 Q_DECLARE_FLAGS(Options,Option)
00098
00099
00129 static int questionYesNo(QWidget *parent,
00130 const QString &text,
00131 const QString &caption = QString(),
00132 const KGuiItem &buttonYes = KStandardGuiItem::yes(),
00133 const KGuiItem &buttonNo = KStandardGuiItem::no(),
00134 const QString &dontAskAgainName = QString(),
00135 Options options = Notify);
00140 static int questionYesNoWId(WId parent_id,
00141 const QString &text,
00142 const QString &caption = QString(),
00143 const KGuiItem &buttonYes = KStandardGuiItem::yes(),
00144 const KGuiItem &buttonNo = KStandardGuiItem::no(),
00145 const QString &dontAskAgainName = QString(),
00146 Options options = Notify);
00179 static int questionYesNoCancel(QWidget *parent,
00180 const QString &text,
00181 const QString &caption = QString(),
00182 const KGuiItem &buttonYes = KStandardGuiItem::yes(),
00183 const KGuiItem &buttonNo = KStandardGuiItem::no(),
00184 const KGuiItem &buttonCancel = KStandardGuiItem::cancel(),
00185 const QString &dontAskAgainName = QString(),
00186 Options options = Notify);
00187
00192 static int questionYesNoCancelWId(WId parent_id,
00193 const QString &text,
00194 const QString &caption = QString(),
00195 const KGuiItem &buttonYes = KStandardGuiItem::yes(),
00196 const KGuiItem &buttonNo = KStandardGuiItem::no(),
00197 const KGuiItem &buttonCancel = KStandardGuiItem::cancel(),
00198 const QString &dontAskAgainName = QString(),
00199 Options options = Notify);
00200
00235 static int questionYesNoList(QWidget *parent,
00236 const QString &text,
00237 const QStringList &strlist,
00238 const QString &caption = QString(),
00239 const KGuiItem &buttonYes = KStandardGuiItem::yes(),
00240 const KGuiItem &buttonNo = KStandardGuiItem::no(),
00241 const QString &dontAskAgainName = QString(),
00242 Options options = Notify);
00243
00248 static int questionYesNoListWId(WId parent_id,
00249 const QString &text,
00250 const QStringList &strlist,
00251 const QString &caption = QString(),
00252 const KGuiItem &buttonYes = KStandardGuiItem::yes(),
00253 const KGuiItem &buttonNo = KStandardGuiItem::no(),
00254 const QString &dontAskAgainName = QString(),
00255 Options options = Notify);
00256
00287 static int warningYesNo(QWidget *parent,
00288 const QString &text,
00289 const QString &caption = QString(),
00290 const KGuiItem &buttonYes = KStandardGuiItem::yes(),
00291 const KGuiItem &buttonNo = KStandardGuiItem::no(),
00292 const QString &dontAskAgainName = QString(),
00293 Options options = Options(Notify | Dangerous));
00294
00299 static int warningYesNoWId(WId parent_id,
00300 const QString &text,
00301 const QString &caption = QString(),
00302 const KGuiItem &buttonYes = KStandardGuiItem::yes(),
00303 const KGuiItem &buttonNo = KStandardGuiItem::no(),
00304 const QString &dontAskAgainName = QString(),
00305 Options options = Options(Notify | Dangerous));
00306
00341 static int warningYesNoList(QWidget *parent,
00342 const QString &text,
00343 const QStringList &strlist,
00344 const QString &caption = QString(),
00345 const KGuiItem &buttonYes = KStandardGuiItem::yes(),
00346 const KGuiItem &buttonNo = KStandardGuiItem::no(),
00347 const QString &dontAskAgainName = QString(),
00348 Options options = Options(Notify | Dangerous));
00349
00354 static int warningYesNoListWId(WId parent_id,
00355 const QString &text,
00356 const QStringList &strlist,
00357 const QString &caption = QString(),
00358 const KGuiItem &buttonYes = KStandardGuiItem::yes(),
00359 const KGuiItem &buttonNo = KStandardGuiItem::no(),
00360 const QString &dontAskAgainName = QString(),
00361 Options options = Options(Notify | Dangerous));
00362
00393 static int warningContinueCancel(QWidget *parent,
00394 const QString &text,
00395 const QString &caption = QString(),
00396 const KGuiItem &buttonContinue = KStandardGuiItem::cont(),
00397 const KGuiItem &buttonCancel = KStandardGuiItem::cancel(),
00398 const QString &dontAskAgainName = QString(),
00399 Options options = Notify);
00400
00405 static int warningContinueCancelWId(WId parent_id,
00406 const QString &text,
00407 const QString &caption = QString(),
00408 const KGuiItem &buttonContinue = KStandardGuiItem::cont(),
00409 const KGuiItem &buttonCancel = KStandardGuiItem::cancel(),
00410 const QString &dontAskAgainName = QString(),
00411 Options options = Notify);
00412
00447 static int warningContinueCancelList(QWidget *parent,
00448 const QString &text,
00449 const QStringList &strlist,
00450 const QString &caption = QString(),
00451 const KGuiItem &buttonContinue = KStandardGuiItem::cont(),
00452 const KGuiItem &buttonCancel = KStandardGuiItem::cancel(),
00453 const QString &dontAskAgainName = QString(),
00454 Options options = Notify);
00455
00460 static int warningContinueCancelListWId(WId parent_id,
00461 const QString &text,
00462 const QStringList &strlist,
00463 const QString &caption = QString(),
00464 const KGuiItem &buttonContinue = KStandardGuiItem::cont(),
00465 const KGuiItem &buttonCancel = KStandardGuiItem::cancel(),
00466 const QString &dontAskAgainName = QString(),
00467 Options options = Notify);
00468
00505 static int warningYesNoCancel(QWidget *parent,
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
00518 static int warningYesNoCancelWId(WId parent_id,
00519 const QString &text,
00520 const QString &caption = QString(),
00521 const KGuiItem &buttonYes = KStandardGuiItem::yes(),
00522 const KGuiItem &buttonNo = KStandardGuiItem::no(),
00523 const KGuiItem &buttonCancel = KStandardGuiItem::cancel(),
00524 const QString &dontAskAgainName = QString(),
00525 Options options = Notify);
00526
00566 static int warningYesNoCancelList(QWidget *parent,
00567 const QString &text,
00568 const QStringList &strlist,
00569 const QString &caption = QString(),
00570 const KGuiItem &buttonYes = KStandardGuiItem::yes(),
00571 const KGuiItem &buttonNo = KStandardGuiItem::no(),
00572 const KGuiItem &buttonCancel = KStandardGuiItem::cancel(),
00573 const QString &dontAskAgainName = QString(),
00574 Options options = Notify);
00575
00580 static int warningYesNoCancelListWId(WId parent_id,
00581 const QString &text,
00582 const QStringList &strlist,
00583 const QString &caption = QString(),
00584 const KGuiItem &buttonYes = KStandardGuiItem::yes(),
00585 const KGuiItem &buttonNo = KStandardGuiItem::no(),
00586 const KGuiItem &buttonCancel = KStandardGuiItem::cancel(),
00587 const QString &dontAskAgainName = QString(),
00588 Options options = Notify);
00589
00613 static void error(QWidget *parent,
00614 const QString &text,
00615 const QString &caption = QString(),
00616 Options options = Notify);
00617
00622 static void errorWId(WId parent_id,
00623 const QString &text,
00624 const QString &caption = QString(),
00625 Options options = Notify);
00626
00653 static void errorList(QWidget *parent,
00654 const QString &text,
00655 const QStringList &strlist,
00656 const QString &caption = QString(),
00657 Options options = Notify);
00658
00664 static void errorListWId(WId parent_id,
00665 const QString &text,
00666 const QStringList &strlist,
00667 const QString &caption = QString(),
00668 Options options = Notify);
00669
00696 static void detailedError(QWidget *parent,
00697 const QString &text,
00698 const QString &details,
00699 const QString &caption = QString(),
00700 Options options = Notify);
00701
00706 static void detailedErrorWId(WId parent_id,
00707 const QString &text,
00708 const QString &details,
00709 const QString &caption = QString(),
00710 Options options = Notify);
00711
00722 static void queuedDetailedError( QWidget *parent,
00723 const QString &text,
00724 const QString &details,
00725 const QString &caption = QString());
00726
00731 static void queuedDetailedErrorWId( WId parent_id,
00732 const QString &text,
00733 const QString &details,
00734 const QString &caption = QString());
00735
00758 static void sorry(QWidget *parent,
00759 const QString &text,
00760 const QString &caption = QString(),
00761 Options options = Notify);
00762
00767 static void sorryWId(WId parent_id,
00768 const QString &text,
00769 const QString &caption = QString(),
00770 Options options = Notify);
00771
00800 static void detailedSorry(QWidget *parent,
00801 const QString &text,
00802 const QString &details,
00803 const QString &caption = QString(),
00804 Options options = Notify);
00805
00810 static void detailedSorryWId(WId parent_id,
00811 const QString &text,
00812 const QString &details,
00813 const QString &caption = QString(),
00814 Options options = Notify);
00815
00842 static void information(QWidget *parent,
00843 const QString &text,
00844 const QString &caption = QString(),
00845 const QString &dontShowAgainName = QString(),
00846 Options options = Notify);
00847
00852 static void informationWId(WId parent_id,
00853 const QString &text,
00854 const QString &caption = QString(),
00855 const QString &dontShowAgainName = QString(),
00856 Options options = Notify);
00857
00887 static void informationList(QWidget *parent,
00888 const QString &text,
00889 const QStringList & strlist,
00890 const QString &caption = QString(),
00891 const QString &dontShowAgainName = QString(),
00892 Options options = Notify);
00893
00898 static void informationListWId(WId parent_id,
00899 const QString &text,
00900 const QStringList & strlist,
00901 const QString &caption = QString(),
00902 const QString &dontShowAgainName = QString(),
00903 Options options = Notify);
00904
00909 static void enableAllMessages();
00910
00917 static void enableMessage(const QString &dontShowAgainName);
00918
00938 static void about(QWidget *parent,
00939 const QString& text,
00940 const QString& caption = QString(),
00941 Options options = Notify);
00942
00970 static int messageBox( QWidget *parent, DialogType type, const QString &text,
00971 const QString &caption = QString(),
00972 const KGuiItem &buttonYes = KStandardGuiItem::yes(),
00973 const KGuiItem &buttonNo = KStandardGuiItem::no(),
00974 const KGuiItem &buttonCancel = KStandardGuiItem::cancel(),
00975 const QString &dontShowAskAgainName = QString(),
00976 Options options = Notify);
00977
00982 static int messageBoxWId( WId parent_id, DialogType type, const QString &text,
00983 const QString &caption = QString(),
00984 const KGuiItem &buttonYes = KStandardGuiItem::yes(),
00985 const KGuiItem &buttonNo = KStandardGuiItem::no(),
00986 const KGuiItem &buttonCancel = KStandardGuiItem::cancel(),
00987 const QString &dontShowAskAgainName = QString(),
00988 Options options = Notify);
00989
01002 static void queuedMessageBox( QWidget *parent,
01003 DialogType type, const QString &text,
01004 const QString &caption,
01005 Options options );
01006
01011 static void queuedMessageBoxWId( WId parent_id,
01012 DialogType type, const QString &text,
01013 const QString &caption,
01014 Options options );
01015
01022 static void queuedMessageBox( QWidget *parent,
01023 DialogType type, const QString &text,
01024 const QString &caption = QString() );
01025
01030 static void queuedMessageBoxWId( WId parent_id,
01031 DialogType type, const QString &text,
01032 const QString &caption = QString() );
01033
01042 static bool shouldBeShownYesNo(const QString &dontShowAgainName,
01043 ButtonCode &result);
01050 static bool shouldBeShownContinue(const QString &dontShowAgainName);
01051
01059 static void saveDontShowAgainYesNo(const QString &dontShowAgainName,
01060 ButtonCode result);
01061
01068 static void saveDontShowAgainContinue(const QString &dontShowAgainName);
01069
01074 static void setDontShowAskAgainConfig(KConfig* cfg);
01075
01099 static int createKMessageBox(KDialog *dialog, QMessageBox::Icon icon,
01100 const QString &text, const QStringList &strlist,
01101 const QString &ask, bool *checkboxReturn,
01102 Options options, const QString &details=QString());
01103
01130 static int createKMessageBox(KDialog *dialog, const QIcon &icon,
01131 const QString &text, const QStringList &strlist,
01132 const QString &ask, bool *checkboxReturn,
01133 Options options, const QString &details=QString(),
01134 QMessageBox::Icon notifyType=QMessageBox::Information);
01135 };
01136
01137 Q_DECLARE_OPERATORS_FOR_FLAGS(KMessageBox::Options)
01138
01139
01140 #endif