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
00027 class QWidget;
00028 class QStringList;
00029 class KConfig;
00030
00042 class KMessageBox
00043 {
00044 public:
00048 enum ButtonCode
00049 {
00050 Ok = 1,
00051 Cancel = 2,
00052 Yes = 3,
00053 No = 4,
00054 Continue = 5
00055 };
00056
00057 enum DialogType
00058 {
00059 QuestionYesNo = 1,
00060 WarningYesNo = 2,
00061 WarningContinueCancel = 3,
00062 WarningYesNoCancel = 4,
00063 Information = 5,
00064
00065 Sorry = 7,
00066 Error = 8,
00067 QuestionYesNoCancel = 9
00068 };
00069
00075 enum OptionsType
00076 {
00077 Notify = 1,
00078 AllowLink = 2,
00079 Dangerous = 4
00080 };
00081
00109 static int questionYesNo(QWidget *parent,
00110 const QString &text,
00111 const QString &caption = QString::null,
00112 const KGuiItem &buttonYes = KStdGuiItem::yes(),
00113 const KGuiItem &buttonNo = KStdGuiItem::no(),
00114 const QString &dontAskAgainName = QString::null,
00115 int options = Notify);
00121 static int questionYesNoWId(WId parent_id,
00122 const QString &text,
00123 const QString &caption = QString::null,
00124 const KGuiItem &buttonYes = KStdGuiItem::yes(),
00125 const KGuiItem &buttonNo = KStdGuiItem::no(),
00126 const QString &dontAskAgainName = QString::null,
00127 int options = Notify);
00157 static int questionYesNoCancel(QWidget *parent,
00158 const QString &text,
00159 const QString &caption = QString::null,
00160 const KGuiItem &buttonYes = KStdGuiItem::yes(),
00161 const KGuiItem &buttonNo = KStdGuiItem::no(),
00162 const QString &dontAskAgainName = QString::null,
00163 int options = Notify);
00164
00170 static int questionYesNoCancelWId(WId parent_id,
00171 const QString &text,
00172 const QString &caption = QString::null,
00173 const KGuiItem &buttonYes = KStdGuiItem::yes(),
00174 const KGuiItem &buttonNo = KStdGuiItem::no(),
00175 const QString &dontAskAgainName = QString::null,
00176 int options = Notify);
00177
00209 static int questionYesNoList(QWidget *parent,
00210 const QString &text,
00211 const QStringList &strlist,
00212 const QString &caption = QString::null,
00213 const KGuiItem &buttonYes = KStdGuiItem::yes(),
00214 const KGuiItem &buttonNo = KStdGuiItem::no(),
00215 const QString &dontAskAgainName = QString::null,
00216 int options = Notify);
00217
00223 static int questionYesNoListWId(WId parent_id,
00224 const QString &text,
00225 const QStringList &strlist,
00226 const QString &caption = QString::null,
00227 const KGuiItem &buttonYes = KStdGuiItem::yes(),
00228 const KGuiItem &buttonNo = KStdGuiItem::no(),
00229 const QString &dontAskAgainName = QString::null,
00230 int options = Notify);
00231
00259 static int warningYesNo(QWidget *parent,
00260 const QString &text,
00261 const QString &caption = QString::null,
00262 const KGuiItem &buttonYes = KStdGuiItem::yes(),
00263 const KGuiItem &buttonNo = KStdGuiItem::no(),
00264 const QString &dontAskAgainName = QString::null,
00265 int options = Notify | Dangerous);
00266
00272 static int warningYesNoWId(WId parent_id,
00273 const QString &text,
00274 const QString &caption = QString::null,
00275 const KGuiItem &buttonYes = KStdGuiItem::yes(),
00276 const KGuiItem &buttonNo = KStdGuiItem::no(),
00277 const QString &dontAskAgainName = QString::null,
00278 int options = Notify | Dangerous);
00279
00311 static int warningYesNoList(QWidget *parent,
00312 const QString &text,
00313 const QStringList &strlist,
00314 const QString &caption = QString::null,
00315 const KGuiItem &buttonYes = KStdGuiItem::yes(),
00316 const KGuiItem &buttonNo = KStdGuiItem::no(),
00317 const QString &dontAskAgainName = QString::null,
00318 int options = Notify | Dangerous);
00319
00325 static int warningYesNoListWId(WId parent_id,
00326 const QString &text,
00327 const QStringList &strlist,
00328 const QString &caption = QString::null,
00329 const KGuiItem &buttonYes = KStdGuiItem::yes(),
00330 const KGuiItem &buttonNo = KStdGuiItem::no(),
00331 const QString &dontAskAgainName = QString::null,
00332 int options = Notify | Dangerous);
00333
00360 static int warningContinueCancel(QWidget *parent,
00361 const QString &text,
00362 const QString &caption = QString::null,
00363 const KGuiItem &buttonContinue = KStdGuiItem::cont(),
00364 const QString &dontAskAgainName = QString::null,
00365 int options = Notify);
00366
00372 static int warningContinueCancelWId(WId parent_id,
00373 const QString &text,
00374 const QString &caption = QString::null,
00375 const KGuiItem &buttonContinue = KStdGuiItem::cont(),
00376 const QString &dontAskAgainName = QString::null,
00377 int options = Notify);
00378
00410 static int warningContinueCancelList(QWidget *parent,
00411 const QString &text,
00412 const QStringList &strlist,
00413 const QString &caption = QString::null,
00414 const KGuiItem &buttonContinue = KStdGuiItem::cont(),
00415 const QString &dontAskAgainName = QString::null,
00416 int options = Notify);
00417
00423 static int warningContinueCancelListWId(WId parent_id,
00424 const QString &text,
00425 const QStringList &strlist,
00426 const QString &caption = QString::null,
00427 const KGuiItem &buttonContinue = KStdGuiItem::cont(),
00428 const QString &dontAskAgainName = QString::null,
00429 int options = Notify);
00430
00464 static int warningYesNoCancel(QWidget *parent,
00465 const QString &text,
00466 const QString &caption = QString::null,
00467 const KGuiItem &buttonYes = KStdGuiItem::yes(),
00468 const KGuiItem &buttonNo = KStdGuiItem::no(),
00469 const QString &dontAskAgainName = QString::null,
00470 int options = Notify);
00471
00477 static int warningYesNoCancelWId(WId parent_id,
00478 const QString &text,
00479 const QString &caption = QString::null,
00480 const KGuiItem &buttonYes = KStdGuiItem::yes(),
00481 const KGuiItem &buttonNo = KStdGuiItem::no(),
00482 const QString &dontAskAgainName = QString::null,
00483 int options = Notify);
00484
00523 static int warningYesNoCancelList(QWidget *parent,
00524 const QString &text,
00525 const QStringList &strlist,
00526 const QString &caption = QString::null,
00527 const KGuiItem &buttonYes = KStdGuiItem::yes(),
00528 const KGuiItem &buttonNo = KStdGuiItem::no(),
00529 const QString &dontAskAgainName = QString::null,
00530 int options = Notify);
00531
00537 static int warningYesNoCancelListWId(WId parent_id,
00538 const QString &text,
00539 const QStringList &strlist,
00540 const QString &caption = QString::null,
00541 const KGuiItem &buttonYes = KStdGuiItem::yes(),
00542 const KGuiItem &buttonNo = KStdGuiItem::no(),
00543 const QString &dontAskAgainName = QString::null,
00544 int options = Notify);
00545
00569 static void error(QWidget *parent,
00570 const QString &text,
00571 const QString &caption = QString::null,
00572 int options = Notify);
00573
00579 static void errorWId(WId parent_id,
00580 const QString &text,
00581 const QString &caption = QString::null,
00582 int options = Notify);
00583
00610 static void detailedError(QWidget *parent,
00611 const QString &text,
00612 const QString &details,
00613 const QString &caption = QString::null,
00614 int options = Notify);
00615
00621 static void detailedErrorWId(WId parent_id,
00622 const QString &text,
00623 const QString &details,
00624 const QString &caption = QString::null,
00625 int options = Notify);
00626
00637 static void queuedDetailedError( QWidget *parent,
00638 const QString &text,
00639 const QString &details,
00640 const QString &caption = QString::null);
00641
00647 static void queuedDetailedErrorWId( WId parent_id,
00648 const QString &text,
00649 const QString &details,
00650 const QString &caption = QString::null);
00651
00674 static void sorry(QWidget *parent,
00675 const QString &text,
00676 const QString &caption = QString::null,
00677 int options = Notify);
00678
00684 static void sorryWId(WId parent_id,
00685 const QString &text,
00686 const QString &caption = QString::null,
00687 int options = Notify);
00688
00717 static void detailedSorry(QWidget *parent,
00718 const QString &text,
00719 const QString &details,
00720 const QString &caption = QString::null,
00721 int options = Notify);
00722
00728 static void detailedSorryWId(WId parent_id,
00729 const QString &text,
00730 const QString &details,
00731 const QString &caption = QString::null,
00732 int options = Notify);
00733
00760 static void information(QWidget *parent,
00761 const QString &text,
00762 const QString &caption = QString::null,
00763 const QString &dontShowAgainName = QString::null,
00764 int options = Notify);
00765
00771 static void informationWId(WId parent_id,
00772 const QString &text,
00773 const QString &caption = QString::null,
00774 const QString &dontShowAgainName = QString::null,
00775 int options = Notify);
00776
00807 static void informationList(QWidget *parent,
00808 const QString &text,
00809 const QStringList & strlist,
00810 const QString &caption = QString::null,
00811 const QString &dontShowAgainName = QString::null,
00812 int options = Notify);
00813
00819 static void informationListWId(WId parent_id,
00820 const QString &text,
00821 const QStringList & strlist,
00822 const QString &caption = QString::null,
00823 const QString &dontShowAgainName = QString::null,
00824 int options = Notify);
00825
00830 static void enableAllMessages();
00831
00839 static void enableMessage(const QString &dontShowAgainName);
00840
00860 static void about(QWidget *parent,
00861 const QString& text,
00862 const QString& caption = QString::null,
00863 int options = Notify);
00864
00889 static int messageBox( QWidget *parent, DialogType type, const QString &text,
00890 const QString &caption,
00891 const KGuiItem &buttonYes,
00892 const KGuiItem &buttonNo,
00893 const QString &dontShowAskAgainName,
00894 int options = Notify);
00895
00914
00915 static int messageBox( QWidget *parent, DialogType type, const QString &text,
00916 const QString &caption = QString::null,
00917 const KGuiItem &buttonYes = KStdGuiItem::yes(),
00918 const KGuiItem &buttonNo = KStdGuiItem::no(),
00919 int options = Notify);
00920
00926 static int messageBoxWId( WId parent_id, DialogType type, const QString &text,
00927 const QString &caption = QString::null,
00928 const KGuiItem &buttonYes = KStdGuiItem::yes(),
00929 const KGuiItem &buttonNo = KStdGuiItem::no(),
00930 const QString &dontShowAskAgainName = QString::null,
00931 int options = Notify);
00932
00945 static void queuedMessageBox( QWidget *parent,
00946 DialogType type, const QString &text,
00947 const QString &caption,
00948 int options );
00949
00955 static void queuedMessageBoxWId( WId parent_id,
00956 DialogType type, const QString &text,
00957 const QString &caption,
00958 int options );
00959
00966 static void queuedMessageBox( QWidget *parent,
00967 DialogType type, const QString &text,
00968 const QString &caption = QString::null );
00969
00975 static void queuedMessageBoxWId( WId parent_id,
00976 DialogType type, const QString &text,
00977 const QString &caption = QString::null );
00978
00988 static bool shouldBeShownYesNo(const QString &dontShowAgainName,
00989 ButtonCode &result);
00997 static bool shouldBeShownContinue(const QString &dontShowAgainName);
00998
01007 static void saveDontShowAgainYesNo(const QString &dontShowAgainName,
01008 ButtonCode result);
01009
01017 static void saveDontShowAgainContinue(const QString &dontShowAgainName);
01018
01024 static void setDontShowAskAgainConfig(KConfig* cfg);
01025 private:
01026 static KConfig* againConfig;
01027 };
01028
01029 #endif