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