KDEUI

kmessagebox.h

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  };
00098 
00099  Q_DECLARE_FLAGS(Options,Option)
00100 
00101  
00131  static int questionYesNo(QWidget *parent,
00132                           const QString &text,
00133                           const QString &caption = QString(),
00134                           const KGuiItem &buttonYes = KStandardGuiItem::yes(),
00135                           const KGuiItem &buttonNo =  KStandardGuiItem::no(),
00136                           const QString &dontAskAgainName = QString(),
00137                           Options options = Notify);
00142  static int questionYesNoWId(WId parent_id,
00143                           const QString &text,
00144                           const QString &caption = QString(),
00145                           const KGuiItem &buttonYes = KStandardGuiItem::yes(),
00146                           const KGuiItem &buttonNo =  KStandardGuiItem::no(),
00147                           const QString &dontAskAgainName = QString(),
00148                           Options options = Notify);
00181   static int questionYesNoCancel(QWidget *parent,
00182                           const QString &text,
00183                           const QString &caption = QString(),
00184                           const KGuiItem &buttonYes = KStandardGuiItem::yes(),
00185                           const KGuiItem &buttonNo = KStandardGuiItem::no(),
00186                           const KGuiItem &buttonCancel = KStandardGuiItem::cancel(),
00187                           const QString &dontAskAgainName = QString(),
00188                           Options options = Notify);
00189 
00194   static int questionYesNoCancelWId(WId parent_id,
00195                           const QString &text,
00196                           const QString &caption = QString(),
00197                           const KGuiItem &buttonYes = KStandardGuiItem::yes(),
00198                           const KGuiItem &buttonNo = KStandardGuiItem::no(),
00199                           const KGuiItem &buttonCancel = KStandardGuiItem::cancel(),
00200                           const QString &dontAskAgainName = QString(),
00201                           Options options = Notify);
00202 
00237  static int questionYesNoList(QWidget *parent,
00238                           const QString &text,
00239                           const QStringList &strlist,
00240                           const QString &caption = QString(),
00241                           const KGuiItem &buttonYes = KStandardGuiItem::yes(),
00242                           const KGuiItem &buttonNo = KStandardGuiItem::no(),
00243                           const QString &dontAskAgainName = QString(),
00244                           Options options = Notify);
00245 
00250  static int questionYesNoListWId(WId parent_id,
00251                           const QString &text,
00252                           const QStringList &strlist,
00253                           const QString &caption = QString(),
00254                           const KGuiItem &buttonYes = KStandardGuiItem::yes(),
00255                           const KGuiItem &buttonNo = KStandardGuiItem::no(),
00256                           const QString &dontAskAgainName = QString(),
00257                           Options options = Notify);
00258 
00289  static int warningYesNo(QWidget *parent,
00290                          const QString &text,
00291                          const QString &caption = QString(),
00292                          const KGuiItem &buttonYes = KStandardGuiItem::yes(),
00293                          const KGuiItem &buttonNo = KStandardGuiItem::no(),
00294                          const QString &dontAskAgainName = QString(),
00295                          Options options = Options(Notify | Dangerous));
00296 
00301  static int warningYesNoWId(WId parent_id,
00302                          const QString &text,
00303                          const QString &caption = QString(),
00304                          const KGuiItem &buttonYes = KStandardGuiItem::yes(),
00305                          const KGuiItem &buttonNo = KStandardGuiItem::no(),
00306                          const QString &dontAskAgainName = QString(),
00307                          Options options = Options(Notify | Dangerous));
00308 
00343  static int warningYesNoList(QWidget *parent,
00344                             const QString &text,
00345                             const QStringList &strlist,
00346                             const QString &caption = QString(),
00347                             const KGuiItem &buttonYes = KStandardGuiItem::yes(),
00348                             const KGuiItem &buttonNo = KStandardGuiItem::no(),
00349                             const QString &dontAskAgainName = QString(),
00350                             Options options = Options(Notify | Dangerous));
00351 
00356  static int warningYesNoListWId(WId parent_id,
00357                             const QString &text,
00358                             const QStringList &strlist,
00359                             const QString &caption = QString(),
00360                             const KGuiItem &buttonYes = KStandardGuiItem::yes(),
00361                             const KGuiItem &buttonNo = KStandardGuiItem::no(),
00362                             const QString &dontAskAgainName = QString(),
00363                             Options options = Options(Notify | Dangerous));
00364 
00395  static int warningContinueCancel(QWidget *parent,
00396                          const QString &text,
00397                          const QString &caption = QString(),
00398                          const KGuiItem &buttonContinue = KStandardGuiItem::cont(),
00399                          const KGuiItem &buttonCancel = KStandardGuiItem::cancel(),
00400                          const QString &dontAskAgainName = QString(),
00401                          Options options = Notify);
00402 
00407  static int warningContinueCancelWId(WId parent_id,
00408                          const QString &text,
00409                          const QString &caption = QString(),
00410                          const KGuiItem &buttonContinue = KStandardGuiItem::cont(),
00411                          const KGuiItem &buttonCancel = KStandardGuiItem::cancel(),
00412                          const QString &dontAskAgainName = QString(),
00413                          Options options = Notify);
00414 
00449  static int warningContinueCancelList(QWidget *parent,
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 
00462  static int warningContinueCancelListWId(WId parent_id,
00463                          const QString &text,
00464                          const QStringList &strlist,
00465                          const QString &caption = QString(),
00466                          const KGuiItem &buttonContinue = KStandardGuiItem::cont(),
00467                          const KGuiItem &buttonCancel = KStandardGuiItem::cancel(),
00468                          const QString &dontAskAgainName = QString(),
00469                          Options options = Notify);
00470 
00507   static int warningYesNoCancel(QWidget *parent,
00508                                 const QString &text,
00509                                 const QString &caption = QString(),
00510                                 const KGuiItem &buttonYes = KStandardGuiItem::yes(),
00511                                 const KGuiItem &buttonNo = KStandardGuiItem::no(),
00512                                 const KGuiItem &buttonCancel = KStandardGuiItem::cancel(),
00513                                 const QString &dontAskAgainName = QString(),
00514                                 Options options = Notify);
00515 
00520   static int warningYesNoCancelWId(WId parent_id,
00521                                 const QString &text,
00522                                 const QString &caption = QString(),
00523                                 const KGuiItem &buttonYes = KStandardGuiItem::yes(),
00524                                 const KGuiItem &buttonNo = KStandardGuiItem::no(),
00525                                 const KGuiItem &buttonCancel = KStandardGuiItem::cancel(),
00526                                 const QString &dontAskAgainName = QString(),
00527                                 Options options = Notify);
00528 
00568   static int warningYesNoCancelList(QWidget *parent,
00569                                 const QString &text,
00570                                 const QStringList &strlist,
00571                                 const QString &caption = QString(),
00572                                 const KGuiItem &buttonYes = KStandardGuiItem::yes(),
00573                                 const KGuiItem &buttonNo = KStandardGuiItem::no(),
00574                                 const KGuiItem &buttonCancel = KStandardGuiItem::cancel(),
00575                                 const QString &dontAskAgainName = QString(),
00576                                 Options options = Notify);
00577 
00582   static int warningYesNoCancelListWId(WId parent_id,
00583                                 const QString &text,
00584                                 const QStringList &strlist,
00585                                 const QString &caption = QString(),
00586                                 const KGuiItem &buttonYes = KStandardGuiItem::yes(),
00587                                 const KGuiItem &buttonNo = KStandardGuiItem::no(),
00588                                 const KGuiItem &buttonCancel = KStandardGuiItem::cancel(),
00589                                 const QString &dontAskAgainName = QString(),
00590                                 Options options = Notify);
00591 
00615   static void error(QWidget *parent,
00616                     const QString &text,
00617                     const QString &caption = QString(),
00618                     Options options = Notify);
00619 
00624   static void errorWId(WId parent_id,
00625                     const QString &text,
00626                     const QString &caption = QString(),
00627                     Options options = Notify);
00628 
00655   static void errorList(QWidget *parent,
00656                     const QString &text,
00657                     const QStringList &strlist,
00658                     const QString &caption = QString(),
00659                     Options options = Notify);
00660 
00666   static void errorListWId(WId parent_id,
00667                     const QString &text,
00668                     const QStringList &strlist,
00669                     const QString &caption = QString(),
00670                     Options options = Notify);
00671 
00698   static void detailedError(QWidget *parent,
00699                     const QString &text,
00700                     const QString &details,
00701                     const QString &caption = QString(),
00702                     Options options = Notify);
00703 
00708   static void detailedErrorWId(WId parent_id,
00709                     const QString &text,
00710                     const QString &details,
00711                     const QString &caption = QString(),
00712                     Options options = Notify);
00713 
00724   static void queuedDetailedError( QWidget *parent,
00725                     const QString &text,
00726                     const QString &details,
00727                     const QString &caption = QString());
00728 
00733   static void queuedDetailedErrorWId( WId parent_id,
00734                     const QString &text,
00735                     const QString &details,
00736                     const QString &caption = QString());
00737 
00760   static void sorry(QWidget *parent,
00761                     const QString &text,
00762                     const QString &caption = QString(),
00763                     Options options = Notify);
00764 
00769   static void sorryWId(WId parent_id,
00770                     const QString &text,
00771                     const QString &caption = QString(),
00772                     Options options = Notify);
00773 
00802   static void detailedSorry(QWidget *parent,
00803                     const QString &text,
00804                     const QString &details,
00805                     const QString &caption = QString(),
00806                     Options options = Notify);
00807 
00812   static void detailedSorryWId(WId parent_id,
00813                     const QString &text,
00814                     const QString &details,
00815                     const QString &caption = QString(),
00816                     Options options = Notify);
00817 
00844   static void information(QWidget *parent,
00845                           const QString &text,
00846                           const QString &caption = QString(),
00847                           const QString &dontShowAgainName = QString(),
00848                           Options options = Notify);
00849 
00854   static void informationWId(WId parent_id,
00855                           const QString &text,
00856                           const QString &caption = QString(),
00857                           const QString &dontShowAgainName = QString(),
00858                           Options options = Notify);
00859 
00889   static void informationList(QWidget *parent,
00890                   const QString &text,
00891                   const QStringList & strlist,
00892                   const QString &caption = QString(),
00893                   const QString &dontShowAgainName = QString(),
00894                   Options options = Notify);
00895 
00900   static void informationListWId(WId parent_id,
00901                   const QString &text,
00902                   const QStringList & strlist,
00903                   const QString &caption = QString(),
00904                   const QString &dontShowAgainName = QString(),
00905                   Options options = Notify);
00906 
00911   static void enableAllMessages();
00912 
00919   static void enableMessage(const QString &dontShowAgainName);
00920 
00940   static void about(QWidget *parent,
00941             const QString& text,
00942             const QString& caption = QString(),
00943                     Options options = Notify);
00944 
00972     static int messageBox( QWidget *parent, DialogType type, const QString &text,
00973                     const QString &caption = QString(),
00974                     const KGuiItem &buttonYes = KStandardGuiItem::yes(),
00975                     const KGuiItem &buttonNo = KStandardGuiItem::no(),
00976                     const KGuiItem &buttonCancel = KStandardGuiItem::cancel(),
00977                     const QString &dontShowAskAgainName = QString(),
00978                     Options options = Notify);
00979 
00984     static int messageBoxWId( WId parent_id, DialogType type, const QString &text,
00985                     const QString &caption = QString(),
00986                     const KGuiItem &buttonYes = KStandardGuiItem::yes(),
00987                     const KGuiItem &buttonNo = KStandardGuiItem::no(),
00988                     const KGuiItem &buttonCancel = KStandardGuiItem::cancel(),
00989                     const QString &dontShowAskAgainName = QString(),
00990                     Options options = Notify);
00991 
01004     static void queuedMessageBox( QWidget *parent,
01005                     DialogType type, const QString &text,
01006                     const QString &caption,
01007                     Options options );
01008 
01013     static void queuedMessageBoxWId( WId parent_id,
01014                     DialogType type, const QString &text,
01015                     const QString &caption,
01016                     Options options );
01017 
01024     static void queuedMessageBox( QWidget *parent,
01025                     DialogType type, const QString &text,
01026                     const QString &caption = QString() );
01027 
01032     static void queuedMessageBoxWId( WId parent_id,
01033                     DialogType type, const QString &text,
01034                     const QString &caption = QString() );
01035 
01044     static bool shouldBeShownYesNo(const QString &dontShowAgainName,
01045                                    ButtonCode &result);
01052     static bool shouldBeShownContinue(const QString &dontShowAgainName);
01053 
01061     static void saveDontShowAgainYesNo(const QString &dontShowAgainName,
01062                                        ButtonCode result);
01063 
01070     static void saveDontShowAgainContinue(const QString &dontShowAgainName);
01071 
01076     static void setDontShowAskAgainConfig(KConfig* cfg);
01077 
01101     static int createKMessageBox(KDialog *dialog, QMessageBox::Icon icon, //krazy:exclude=qclasses
01102                              const QString &text, const QStringList &strlist,
01103                              const QString &ask, bool *checkboxReturn,
01104                              Options options, const QString &details=QString());
01105 
01132     static int createKMessageBox(KDialog *dialog, const QIcon &icon,
01133                              const QString &text, const QStringList &strlist,
01134                              const QString &ask, bool *checkboxReturn,
01135                              Options options, const QString &details=QString(),
01136                              QMessageBox::Icon notifyType=QMessageBox::Information); //krazy:exclude=qclasses
01137 };
01138 
01139 Q_DECLARE_OPERATORS_FOR_FLAGS(KMessageBox::Options)
01140 
01141 
01142 #endif
KDEUI

kmessagebox.h

KDEUI

kdelibs
