00001
00002
00003
00004
00005
00006
00007
00008
00009
00010
00011
00012
00013
00014
00015
00016
00017
00018
00019 #ifndef _KMESSAGEBOX_H_
00020 #define _KMESSAGEBOX_H_
00021
00022 #include <qstring.h>
00023
00024 #include <kguiitem.h>
00025 #include <kstdguiitem.h>
00026 #include <qmessagebox.h>
00027
00028 class QWidget;
00029 class QStringList;
00030 class KConfig;
00031 class KDialogBase;
00032
00044 class KMessageBox
00045 {
00046 public:
00050 enum ButtonCode
00051 {
00052 Ok = 1,
00053 Cancel = 2,
00054 Yes = 3,
00055 No = 4,
00056 Continue = 5
00057 };
00058
00059 enum DialogType
00060 {
00061 QuestionYesNo = 1,
00062 WarningYesNo = 2,
00063 WarningContinueCancel = 3,
00064 WarningYesNoCancel = 4,
00065 Information = 5,
00066
00067 Sorry = 7,
00068 Error = 8,
00069 QuestionYesNoCancel = 9
00070 };
00071
00077 enum OptionsType
00078 {
00079 Notify = 1,
00080 AllowLink = 2,
00081 Dangerous = 4
00082 };
00083
00114 static int questionYesNo(QWidget *parent,
00115 const QString &text,
00116 const QString &caption = QString::null,
00117 const KGuiItem &buttonYes = KStdGuiItem::yes(),
00118 const KGuiItem &buttonNo = KStdGuiItem::no(),
00119 const QString &dontAskAgainName = QString::null,
00120 int options = Notify);
00126 static int questionYesNoWId(WId parent_id,
00127 const QString &text,
00128 const QString &caption = QString::null,
00129 const KGuiItem &buttonYes = KStdGuiItem::yes(),
00130 const KGuiItem &buttonNo = KStdGuiItem::no(),
00131 const QString &dontAskAgainName = QString::null,
00132 int options = Notify);
00165 static int questionYesNoCancel(QWidget *parent,
00166 const QString &text,
00167 const QString &caption = QString::null,
00168 const KGuiItem &buttonYes = KStdGuiItem::yes(),
00169 const KGuiItem &buttonNo = KStdGuiItem::no(),
00170 const QString &dontAskAgainName = QString::null,
00171 int options = Notify);
00172
00178 static int questionYesNoCancelWId(WId parent_id,
00179 const QString &text,
00180 const QString &caption = QString::null,
00181 const KGuiItem &buttonYes = KStdGuiItem::yes(),
00182 const KGuiItem &buttonNo = KStdGuiItem::no(),
00183 const QString &dontAskAgainName = QString::null,
00184 int options = Notify);
00185
00220 static int questionYesNoList(QWidget *parent,
00221 const QString &text,
00222 const QStringList &strlist,
00223 const QString &caption = QString::null,
00224 const KGuiItem &buttonYes = KStdGuiItem::yes(),
00225 const KGuiItem &buttonNo = KStdGuiItem::no(),
00226 const QString &dontAskAgainName = QString::null,
00227 int options = Notify);
00228
00234 static int questionYesNoListWId(WId parent_id,
00235 const QString &text,
00236 const QStringList &strlist,
00237 const QString &caption = QString::null,
00238 const KGuiItem &buttonYes = KStdGuiItem::yes(),
00239 const KGuiItem &buttonNo = KStdGuiItem::no(),
00240 const QString &dontAskAgainName = QString::null,
00241 int options = Notify);
00242
00273 static int warningYesNo(QWidget *parent,
00274 const QString &text,
00275 const QString &caption = QString::null,
00276 const KGuiItem &buttonYes = KStdGuiItem::yes(),
00277 const KGuiItem &buttonNo = KStdGuiItem::no(),
00278 const QString &dontAskAgainName = QString::null,
00279 int options = Notify | Dangerous);
00280
00286 static int warningYesNoWId(WId parent_id,
00287 const QString &text,
00288 const QString &caption = QString::null,
00289 const KGuiItem &buttonYes = KStdGuiItem::yes(),
00290 const KGuiItem &buttonNo = KStdGuiItem::no(),
00291 const QString &dontAskAgainName = QString::null,
00292 int options = Notify | Dangerous);
00293
00328 static int warningYesNoList(QWidget *parent,
00329 const QString &text,
00330 const QStringList &strlist,
00331 const QString &caption = QString::null,
00332 const KGuiItem &buttonYes = KStdGuiItem::yes(),
00333 const KGuiItem &buttonNo = KStdGuiItem::no(),
00334 const QString &dontAskAgainName = QString::null,
00335 int options = Notify | Dangerous);
00336
00342 static int warningYesNoListWId(WId parent_id,
00343 const QString &text,
00344 const QStringList &strlist,
00345 const QString &caption = QString::null,
00346 const KGuiItem &buttonYes = KStdGuiItem::yes(),
00347 const KGuiItem &buttonNo = KStdGuiItem::no(),
00348 const QString &dontAskAgainName = QString::null,
00349 int options = Notify | Dangerous);
00350
00380 static int warningContinueCancel(QWidget *parent,
00381 const QString &text,
00382 const QString &caption = QString::null,
00383 const KGuiItem &buttonContinue = KStdGuiItem::cont(),
00384 const QString &dontAskAgainName = QString::null,
00385 int options = Notify);
00386
00392 static int warningContinueCancelWId(WId parent_id,
00393 const QString &text,
00394 const QString &caption = QString::null,
00395 const KGuiItem &buttonContinue = KStdGuiItem::cont(),
00396 const QString &dontAskAgainName = QString::null,
00397 int options = Notify);
00398
00432 static int warningContinueCancelList(QWidget *parent,
00433 const QString &text,
00434 const QStringList &strlist,
00435 const QString &caption = QString::null,
00436 const KGuiItem &buttonContinue = KStdGuiItem::cont(),
00437 const QString &dontAskAgainName = QString::null,
00438 int options = Notify);
00439
00445 static int warningContinueCancelListWId(WId parent_id,
00446 const QString &text,
00447 const QStringList &strlist,
00448 const QString &caption = QString::null,
00449 const KGuiItem &buttonContinue = KStdGuiItem::cont(),
00450 const QString &dontAskAgainName = QString::null,
00451 int options = Notify);
00452
00489 static int warningYesNoCancel(QWidget *parent,
00490 const QString &text,
00491 const QString &caption = QString::null,
00492 const KGuiItem &buttonYes = KStdGuiItem::yes(),
00493 const KGuiItem &buttonNo = KStdGuiItem::no(),
00494 const QString &dontAskAgainName = QString::null,
00495 int options = Notify);
00496
00502 static int warningYesNoCancelWId(WId parent_id,
00503 const QString &text,
00504 const QString &caption = QString::null,
00505 const KGuiItem &buttonYes = KStdGuiItem::yes(),
00506 const KGuiItem &buttonNo = KStdGuiItem::no(),
00507 const QString &dontAskAgainName = QString::null,
00508 int options = Notify);
00509
00551 static int warningYesNoCancelList(QWidget *parent,
00552 const QString &text,
00553 const QStringList &strlist,
00554 const QString &caption = QString::null,
00555 const KGuiItem &buttonYes = KStdGuiItem::yes(),
00556 const KGuiItem &buttonNo = KStdGuiItem::no(),
00557 const QString &dontAskAgainName = QString::null,
00558 int options = Notify);
00559
00565 static int warningYesNoCancelListWId(WId parent_id,
00566 const QString &text,
00567 const QStringList &strlist,
00568 const QString &caption = QString::null,
00569 const KGuiItem &buttonYes = KStdGuiItem::yes(),
00570 const KGuiItem &buttonNo = KStdGuiItem::no(),
00571 const QString &dontAskAgainName = QString::null,
00572 int options = Notify);
00573
00597 static void error(QWidget *parent,
00598 const QString &text,
00599 const QString &caption = QString::null,
00600 int options = Notify);
00601
00607 static void errorWId(WId parent_id,
00608 const QString &text,
00609 const QString &caption = QString::null,
00610 int options = Notify);
00611
00638 static void detailedError(QWidget *parent,
00639 const QString &text,
00640 const QString &details,
00641 const QString &caption = QString::null,
00642 int options = Notify);
00643
00649 static void detailedErrorWId(WId parent_id,
00650 const QString &text,
00651 const QString &details,
00652 const QString &caption = QString::null,
00653 int options = Notify);
00654
00665 static void queuedDetailedError( QWidget *parent,
00666 const QString &text,
00667 const QString &details,
00668 const QString &caption = QString::null);
00669
00675 static void queuedDetailedErrorWId( WId parent_id,
00676 const QString &text,
00677 const QString &details,
00678 const QString &caption = QString::null);
00679
00702 static void sorry(QWidget *parent,
00703 const QString &text,
00704 const QString &caption = QString::null,
00705 int options = Notify);
00706
00712 static void sorryWId(WId parent_id,
00713 const QString &text,
00714 const QString &caption = QString::null,
00715 int options = Notify);
00716
00745 static void detailedSorry(QWidget *parent,
00746 const QString &text,
00747 const QString &details,
00748 const QString &caption = QString::null,
00749 int options = Notify);
00750
00756 static void detailedSorryWId(WId parent_id,
00757 const QString &text,
00758 const QString &details,
00759 const QString &caption = QString::null,
00760 int options = Notify);
00761
00788 static void information(QWidget *parent,
00789 const QString &text,
00790 const QString &caption = QString::null,
00791 const QString &dontShowAgainName = QString::null,
00792 int options = Notify);
00793
00799 static void informationWId(WId parent_id,
00800 const QString &text,
00801 const QString &caption = QString::null,
00802 const QString &dontShowAgainName = QString::null,
00803 int options = Notify);
00804
00835 static void informationList(QWidget *parent,
00836 const QString &text,
00837 const QStringList & strlist,
00838 const QString &caption = QString::null,
00839 const QString &dontShowAgainName = QString::null,
00840 int options = Notify);
00841
00847 static void informationListWId(WId parent_id,
00848 const QString &text,
00849 const QStringList & strlist,
00850 const QString &caption = QString::null,
00851 const QString &dontShowAgainName = QString::null,
00852 int options = Notify);
00853
00858 static void enableAllMessages();
00859
00867 static void enableMessage(const QString &dontShowAgainName);
00868
00888 static void about(QWidget *parent,
00889 const QString& text,
00890 const QString& caption = QString::null,
00891 int options = Notify);
00892
00917 static int messageBox( QWidget *parent, DialogType type, const QString &text,
00918 const QString &caption,
00919 const KGuiItem &buttonYes,
00920 const KGuiItem &buttonNo,
00921 const QString &dontShowAskAgainName,
00922 int options = Notify);
00923
00942
00943 static int messageBox( QWidget *parent, DialogType type, const QString &text,
00944 const QString &caption = QString::null,
00945 const KGuiItem &buttonYes = KStdGuiItem::yes(),
00946 const KGuiItem &buttonNo = KStdGuiItem::no(),
00947 int options = Notify);
00948
00954 static int messageBoxWId( WId parent_id, DialogType type, const QString &text,
00955 const QString &caption = QString::null,
00956 const KGuiItem &buttonYes = KStdGuiItem::yes(),
00957 const KGuiItem &buttonNo = KStdGuiItem::no(),
00958 const QString &dontShowAskAgainName = QString::null,
00959 int options = Notify);
00960
00973 static void queuedMessageBox( QWidget *parent,
00974 DialogType type, const QString &text,
00975 const QString &caption,
00976 int options );
00977
00983 static void queuedMessageBoxWId( WId parent_id,
00984 DialogType type, const QString &text,
00985 const QString &caption,
00986 int options );
00987
00994 static void queuedMessageBox( QWidget *parent,
00995 DialogType type, const QString &text,
00996 const QString &caption = QString::null );
00997
01003 static void queuedMessageBoxWId( WId parent_id,
01004 DialogType type, const QString &text,
01005 const QString &caption = QString::null );
01006
01016 static bool shouldBeShownYesNo(const QString &dontShowAgainName,
01017 ButtonCode &result);
01025 static bool shouldBeShownContinue(const QString &dontShowAgainName);
01026
01035 static void saveDontShowAgainYesNo(const QString &dontShowAgainName,
01036 ButtonCode result);
01037
01045 static void saveDontShowAgainContinue(const QString &dontShowAgainName);
01046
01052 static void setDontShowAskAgainConfig(KConfig* cfg);
01053
01069 static int createKMessageBox(KDialogBase *dialog, QMessageBox::Icon icon,
01070 const QString &text, const QStringList &strlist,
01071 const QString &ask, bool *checkboxReturn,
01072 int options, const QString &details=QString::null);
01073
01092 static int createKMessageBox(KDialogBase *dialog, QPixmap icon,
01093 const QString &text, const QStringList &strlist,
01094 const QString &ask, bool *checkboxReturn,
01095 int options, const QString &details=QString::null,
01096 QMessageBox::Icon notifyType=QMessageBox::Information);
01097
01098 private:
01099 static KConfig* againConfig;
01100 };
01101
01102 #endif