• Skip to content
  • Skip to link menu
  • KDE API Reference
  • kdelibs-4.14.38 API Reference
  • KDE Home
  • Contact Us
 

KDEUI

  • kdeui
  • dialogs
kmessagebox.h
Go to the documentation of this file.
1/* This file is part of the KDE libraries
2 Copyright (C) 1999 Waldo Bastian (bastian@kde.org)
3
4 This library is free software; you can redistribute it and/or
5 modify it under the terms of the GNU Library General Public
6 License as published by the Free Software Foundation; version 2
7 of the License.
8
9 This library is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 Library General Public License for more details.
13
14 You should have received a copy of the GNU Library General Public License
15 along with this library; see the file COPYING.LIB. If not, write to
16 the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
17 Boston, MA 02110-1301, USA.
18*/
19
20//krazy:excludeall=dpointer
21
22#ifndef KMESSAGEBOX_H
23#define KMESSAGEBOX_H
24
25#include <QtGui/QMessageBox>
26
27#include <kguiitem.h>
28#include <kstandardguiitem.h>
29
30class QWidget;
31class QStringList;
32class KConfig;
33class KDialog;
34
62class KDEUI_EXPORT KMessageBox
63{
64public:
68 enum ButtonCode
69 {
70 Ok = 1,
71 Cancel = 2,
72 Yes = 3,
73 No = 4,
74 Continue = 5
75 };
76
77 enum DialogType
78 {
79 QuestionYesNo = 1,
80 WarningYesNo = 2,
81 WarningContinueCancel = 3,
82 WarningYesNoCancel = 4,
83 Information = 5,
84 // Reserved for: SSLMessageBox = 6
85 Sorry = 7,
86 Error = 8,
87 QuestionYesNoCancel = 9
88 };
89
90 enum Option
91 {
92 Notify = 1,
93 AllowLink = 2,
94 Dangerous = 4,
95 PlainCaption = 8,
96 NoExec = 16,
97 WindowModal = 32
98 };
99
100 Q_DECLARE_FLAGS(Options,Option)
101
102
130 static int questionYesNo(QWidget *parent,
131 const QString &text,
132 const QString &caption = QString(),
133 const KGuiItem &buttonYes = KStandardGuiItem::yes(),
134 const KGuiItem &buttonNo = KStandardGuiItem::no(),
135 const QString &dontAskAgainName = QString(),
136 Options options = Notify);
141 static int questionYesNoWId(WId parent_id,
142 const QString &text,
143 const QString &caption = QString(),
144 const KGuiItem &buttonYes = KStandardGuiItem::yes(),
145 const KGuiItem &buttonNo = KStandardGuiItem::no(),
146 const QString &dontAskAgainName = QString(),
147 Options options = Notify);
178 static int questionYesNoCancel(QWidget *parent,
179 const QString &text,
180 const QString &caption = QString(),
181 const KGuiItem &buttonYes = KStandardGuiItem::yes(),
182 const KGuiItem &buttonNo = KStandardGuiItem::no(),
183 const KGuiItem &buttonCancel = KStandardGuiItem::cancel(),
184 const QString &dontAskAgainName = QString(),
185 Options options = Notify);
186
191 static int questionYesNoCancelWId(WId parent_id,
192 const QString &text,
193 const QString &caption = QString(),
194 const KGuiItem &buttonYes = KStandardGuiItem::yes(),
195 const KGuiItem &buttonNo = KStandardGuiItem::no(),
196 const KGuiItem &buttonCancel = KStandardGuiItem::cancel(),
197 const QString &dontAskAgainName = QString(),
198 Options options = Notify);
199
232 static int questionYesNoList(QWidget *parent,
233 const QString &text,
234 const QStringList &strlist,
235 const QString &caption = QString(),
236 const KGuiItem &buttonYes = KStandardGuiItem::yes(),
237 const KGuiItem &buttonNo = KStandardGuiItem::no(),
238 const QString &dontAskAgainName = QString(),
239 Options options = Notify);
240
245 static int questionYesNoListWId(WId parent_id,
246 const QString &text,
247 const QStringList &strlist,
248 const QString &caption = QString(),
249 const KGuiItem &buttonYes = KStandardGuiItem::yes(),
250 const KGuiItem &buttonNo = KStandardGuiItem::no(),
251 const QString &dontAskAgainName = QString(),
252 Options options = Notify);
253
282 static int warningYesNo(QWidget *parent,
283 const QString &text,
284 const QString &caption = QString(),
285 const KGuiItem &buttonYes = KStandardGuiItem::yes(),
286 const KGuiItem &buttonNo = KStandardGuiItem::no(),
287 const QString &dontAskAgainName = QString(),
288 Options options = Options(Notify | Dangerous));
289
294 static int warningYesNoWId(WId parent_id,
295 const QString &text,
296 const QString &caption = QString(),
297 const KGuiItem &buttonYes = KStandardGuiItem::yes(),
298 const KGuiItem &buttonNo = KStandardGuiItem::no(),
299 const QString &dontAskAgainName = QString(),
300 Options options = Options(Notify | Dangerous));
301
334 static int warningYesNoList(QWidget *parent,
335 const QString &text,
336 const QStringList &strlist,
337 const QString &caption = QString(),
338 const KGuiItem &buttonYes = KStandardGuiItem::yes(),
339 const KGuiItem &buttonNo = KStandardGuiItem::no(),
340 const QString &dontAskAgainName = QString(),
341 Options options = Options(Notify | Dangerous));
342
347 static int warningYesNoListWId(WId parent_id,
348 const QString &text,
349 const QStringList &strlist,
350 const QString &caption = QString(),
351 const KGuiItem &buttonYes = KStandardGuiItem::yes(),
352 const KGuiItem &buttonNo = KStandardGuiItem::no(),
353 const QString &dontAskAgainName = QString(),
354 Options options = Options(Notify | Dangerous));
355
384 static int warningContinueCancel(QWidget *parent,
385 const QString &text,
386 const QString &caption = QString(),
387 const KGuiItem &buttonContinue = KStandardGuiItem::cont(),
388 const KGuiItem &buttonCancel = KStandardGuiItem::cancel(),
389 const QString &dontAskAgainName = QString(),
390 Options options = Notify);
391
396 static int warningContinueCancelWId(WId parent_id,
397 const QString &text,
398 const QString &caption = QString(),
399 const KGuiItem &buttonContinue = KStandardGuiItem::cont(),
400 const KGuiItem &buttonCancel = KStandardGuiItem::cancel(),
401 const QString &dontAskAgainName = QString(),
402 Options options = Notify);
403
436 static int warningContinueCancelList(QWidget *parent,
437 const QString &text,
438 const QStringList &strlist,
439 const QString &caption = QString(),
440 const KGuiItem &buttonContinue = KStandardGuiItem::cont(),
441 const KGuiItem &buttonCancel = KStandardGuiItem::cancel(),
442 const QString &dontAskAgainName = QString(),
443 Options options = Notify);
444
449 static int warningContinueCancelListWId(WId parent_id,
450 const QString &text,
451 const QStringList &strlist,
452 const QString &caption = QString(),
453 const KGuiItem &buttonContinue = KStandardGuiItem::cont(),
454 const KGuiItem &buttonCancel = KStandardGuiItem::cancel(),
455 const QString &dontAskAgainName = QString(),
456 Options options = Notify);
457
492 static int warningYesNoCancel(QWidget *parent,
493 const QString &text,
494 const QString &caption = QString(),
495 const KGuiItem &buttonYes = KStandardGuiItem::yes(),
496 const KGuiItem &buttonNo = KStandardGuiItem::no(),
497 const KGuiItem &buttonCancel = KStandardGuiItem::cancel(),
498 const QString &dontAskAgainName = QString(),
499 Options options = Notify);
500
505 static int warningYesNoCancelWId(WId parent_id,
506 const QString &text,
507 const QString &caption = QString(),
508 const KGuiItem &buttonYes = KStandardGuiItem::yes(),
509 const KGuiItem &buttonNo = KStandardGuiItem::no(),
510 const KGuiItem &buttonCancel = KStandardGuiItem::cancel(),
511 const QString &dontAskAgainName = QString(),
512 Options options = Notify);
513
551 static int warningYesNoCancelList(QWidget *parent,
552 const QString &text,
553 const QStringList &strlist,
554 const QString &caption = QString(),
555 const KGuiItem &buttonYes = KStandardGuiItem::yes(),
556 const KGuiItem &buttonNo = KStandardGuiItem::no(),
557 const KGuiItem &buttonCancel = KStandardGuiItem::cancel(),
558 const QString &dontAskAgainName = QString(),
559 Options options = Notify);
560
565 static int warningYesNoCancelListWId(WId parent_id,
566 const QString &text,
567 const QStringList &strlist,
568 const QString &caption = QString(),
569 const KGuiItem &buttonYes = KStandardGuiItem::yes(),
570 const KGuiItem &buttonNo = KStandardGuiItem::no(),
571 const KGuiItem &buttonCancel = KStandardGuiItem::cancel(),
572 const QString &dontAskAgainName = QString(),
573 Options options = Notify);
574
596 static void error(QWidget *parent,
597 const QString &text,
598 const QString &caption = QString(),
599 Options options = Notify);
600
605 static void errorWId(WId parent_id,
606 const QString &text,
607 const QString &caption = QString(),
608 Options options = Notify);
609
634 static void errorList(QWidget *parent,
635 const QString &text,
636 const QStringList &strlist,
637 const QString &caption = QString(),
638 Options options = Notify);
639
645 static void errorListWId(WId parent_id,
646 const QString &text,
647 const QStringList &strlist,
648 const QString &caption = QString(),
649 Options options = Notify);
650
675 static void detailedError(QWidget *parent,
676 const QString &text,
677 const QString &details,
678 const QString &caption = QString(),
679 Options options = Notify);
680
685 static void detailedErrorWId(WId parent_id,
686 const QString &text,
687 const QString &details,
688 const QString &caption = QString(),
689 Options options = Notify);
690
701 static void queuedDetailedError( QWidget *parent,
702 const QString &text,
703 const QString &details,
704 const QString &caption = QString());
705
710 static void queuedDetailedErrorWId( WId parent_id,
711 const QString &text,
712 const QString &details,
713 const QString &caption = QString());
714
735 static void sorry(QWidget *parent,
736 const QString &text,
737 const QString &caption = QString(),
738 Options options = Notify);
739
744 static void sorryWId(WId parent_id,
745 const QString &text,
746 const QString &caption = QString(),
747 Options options = Notify);
748
775 static void detailedSorry(QWidget *parent,
776 const QString &text,
777 const QString &details,
778 const QString &caption = QString(),
779 Options options = Notify);
780
785 static void detailedSorryWId(WId parent_id,
786 const QString &text,
787 const QString &details,
788 const QString &caption = QString(),
789 Options options = Notify);
790
815 static void information(QWidget *parent,
816 const QString &text,
817 const QString &caption = QString(),
818 const QString &dontShowAgainName = QString(),
819 Options options = Notify);
820
825 static void informationWId(WId parent_id,
826 const QString &text,
827 const QString &caption = QString(),
828 const QString &dontShowAgainName = QString(),
829 Options options = Notify);
830
858 static void informationList(QWidget *parent,
859 const QString &text,
860 const QStringList & strlist,
861 const QString &caption = QString(),
862 const QString &dontShowAgainName = QString(),
863 Options options = Notify);
864
869 static void informationListWId(WId parent_id,
870 const QString &text,
871 const QStringList & strlist,
872 const QString &caption = QString(),
873 const QString &dontShowAgainName = QString(),
874 Options options = Notify);
875
880 static void enableAllMessages();
881
888 static void enableMessage(const QString &dontShowAgainName);
889
907 static void about(QWidget *parent,
908 const QString& text,
909 const QString& caption = QString(),
910 Options options = Notify);
911
937 static int messageBox( QWidget *parent, DialogType type, const QString &text,
938 const QString &caption = QString(),
939 const KGuiItem &buttonYes = KStandardGuiItem::yes(),
940 const KGuiItem &buttonNo = KStandardGuiItem::no(),
941 const KGuiItem &buttonCancel = KStandardGuiItem::cancel(),
942 const QString &dontShowAskAgainName = QString(),
943 Options options = Notify);
944
949 static int messageBoxWId( WId parent_id, DialogType type, const QString &text,
950 const QString &caption = QString(),
951 const KGuiItem &buttonYes = KStandardGuiItem::yes(),
952 const KGuiItem &buttonNo = KStandardGuiItem::no(),
953 const KGuiItem &buttonCancel = KStandardGuiItem::cancel(),
954 const QString &dontShowAskAgainName = QString(),
955 Options options = Notify);
956
969 static void queuedMessageBox( QWidget *parent,
970 DialogType type, const QString &text,
971 const QString &caption,
972 Options options );
973
978 static void queuedMessageBoxWId( WId parent_id,
979 DialogType type, const QString &text,
980 const QString &caption,
981 Options options );
982
989 static void queuedMessageBox( QWidget *parent,
990 DialogType type, const QString &text,
991 const QString &caption = QString() );
992
997 static void queuedMessageBoxWId( WId parent_id,
998 DialogType type, const QString &text,
999 const QString &caption = QString() );
1000
1009 static bool shouldBeShownYesNo(const QString &dontShowAgainName,
1010 ButtonCode &result);
1017 static bool shouldBeShownContinue(const QString &dontShowAgainName);
1018
1026 static void saveDontShowAgainYesNo(const QString &dontShowAgainName,
1027 ButtonCode result);
1028
1035 static void saveDontShowAgainContinue(const QString &dontShowAgainName);
1036
1041 static void setDontShowAskAgainConfig(KConfig* cfg);
1042
1067 static int createKMessageBox(KDialog *dialog, QMessageBox::Icon icon, //krazy:exclude=qclasses
1068 const QString &text, const QStringList &strlist,
1069 const QString &ask, bool *checkboxReturn,
1070 Options options, const QString &details=QString());
1071
1099 static int createKMessageBox(KDialog *dialog, const QIcon &icon,
1100 const QString &text, const QStringList &strlist,
1101 const QString &ask, bool *checkboxReturn,
1102 Options options, const QString &details=QString(),
1103 QMessageBox::Icon notifyType=QMessageBox::Information); //krazy:exclude=qclasses
1104};
1105
1106Q_DECLARE_OPERATORS_FOR_FLAGS(KMessageBox::Options)
1107
1108
1109#endif
KConfig
KDialog
A dialog base class with standard buttons and predefined layouts.
Definition: kdialog.h:129
KGuiItem
An abstract class for GUI data such as ToolTip and Icon.
Definition: kguiitem.h:37
KMessageBox
Easy message dialog box.
Definition: kmessagebox.h:63
KMessageBox::ButtonCode
ButtonCode
Button types.
Definition: kmessagebox.h:69
KMessageBox::Option
Option
Definition: kmessagebox.h:91
KMessageBox::DialogType
DialogType
Definition: kmessagebox.h:78
QWidget
kguiitem.h
kstandardguiitem.h
Information
Information
Sorry
Sorry
Error
Error
Option
Option
KStandardGuiItem::yes
KGuiItem yes()
Returns the 'Yes' gui item.
Definition: kstandardguiitem.cpp:118
KStandardGuiItem::cont
KGuiItem cont()
Returns the 'Continue' gui item.
Definition: kstandardguiitem.cpp:234
KStandardGuiItem::no
KGuiItem no()
Returns the 'No' gui item.
Definition: kstandardguiitem.cpp:123
KStandardGuiItem::cancel
KGuiItem cancel()
Returns the 'Cancel' gui item.
Definition: kstandardguiitem.cpp:113
This file is part of the KDE documentation.
Documentation copyright © 1996-2023 The KDE developers.
Generated on Mon Feb 20 2023 00:00:00 by doxygen 1.9.6 written by Dimitri van Heesch, © 1997-2006

KDE's Doxygen guidelines are available online.

KDEUI

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

kdelibs-4.14.38 API Reference

Skip menu "kdelibs-4.14.38 API Reference"
  • DNSSD
  • Interfaces
  •   KHexEdit
  •   KMediaPlayer
  •   KSpeech
  •   KTextEditor
  • kconf_update
  • KDE3Support
  •   KUnitTest
  • KDECore
  • KDED
  • KDEsu
  • KDEUI
  • KDEWebKit
  • KDocTools
  • KFile
  • KHTML
  • KImgIO
  • KInit
  • kio
  • KIOSlave
  • KJS
  •   KJS-API
  •   WTF
  • kjsembed
  • KNewStuff
  • KParts
  • KPty
  • Kross
  • KUnitConversion
  • KUtils
  • Nepomuk
  • Plasma
  • Solid
  • Sonnet
  • ThreadWeaver
Report problems with this website to our bug tracking system.
Contact the specific authors with questions and comments about the page contents.

KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V. | Legal