• Skip to content
  • Skip to link menu
KDE 4.1 API Reference
  • KDE API Reference
  • kdelibs
  • Sitemap
  • Contact Us
 

KDEUI

kmessagebox.h

Go to the documentation of this file.
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 
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    // Reserved for: SSLMessageBox = 6
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

KDEUI

Skip menu "KDEUI"
  • Main Page
  • Modules
  • Namespace List
  • Class Hierarchy
  • Alphabetical List
  • Class List
  • File List
  • Namespace Members
  • Class Members
  • Related Pages

kdelibs

Skip menu "kdelibs"
  • DNSSD
  • Interfaces
  •   KHexEdit
  •   KMediaPlayer
  •   KSpeech
  •   KTextEditor
  • Kate
  • kconf_update
  • KDE3Support
  •   KUnitTest
  • KDECore
  • KDED
  • KDEsu
  • KDEUI
  • KDocTools
  • KFile
  • KHTML
  • KImgIO
  • KInit
  • KIO
  • KIOSlave
  • KJS
  •   KJS-API
  •   WTF
  • kjsembed
  • KNewStuff
  • KParts
  • Kross
  • KUtils
  • Nepomuk
  • Solid
  • Sonnet
  • ThreadWeaver
Generated for kdelibs by doxygen 1.5.4
This website is maintained by Adriaan de Groot and Allen Winter.
KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V. | Legal