KMessageBox

KMessageBox Namespace Reference

Typedefs

typedef QFlags< OptionOptions
 

Enumerations

enum  ButtonCode {
  Ok = 1, Cancel = 2, Yes = 3, No = 4,
  Continue = 5
}
 
enum  DialogType {
  QuestionYesNo = 1, WarningYesNo = 2, WarningContinueCancel = 3, WarningYesNoCancel = 4,
  Information = 5, Sorry = 7, Error = 8, QuestionYesNoCancel = 9
}
 
enum  Option {
  Notify = 1, AllowLink = 2, Dangerous = 4, PlainCaption = 8,
  NoExec = 16, WindowModal = 32
}
 

Functions

void about (QWidget *parent, const QString &text, const QString &caption=QString(), Options options=Notify)
 
static void applyOptions (QDialog *dialog, KMessageBox::Options options)
 
QDialogButtonBox::StandardButton createKMessageBox (QDialog *dialog, QDialogButtonBox *buttons, QMessageBox::Icon icon, const QString &text, const QStringList &strlist, const QString &ask, bool *checkboxReturn, Options options, const QString &details=QString())
 
QDialogButtonBox::StandardButton createKMessageBox (QDialog *dialog, QDialogButtonBox *buttons, const QIcon &icon, const QString &text, const QStringList &strlist, const QString &ask, bool *checkboxReturn, Options options, const QString &details=QString(), QMessageBox::Icon notifyType=QMessageBox::Information)
 
static QDialogcreateWIdDialog (WId parent_id)
 
void detailedError (QWidget *parent, const QString &text, const QString &details, const QString &caption=QString(), Options options=Notify)
 
static void detailedErrorInternal (QDialog *dialog, const QString &text, const QString &details, const QString &caption, Options options)
 
void detailedErrorWId (WId parent_id, const QString &text, const QString &details, const QString &caption=QString(), Options options=Notify)
 
void detailedSorry (QWidget *parent, const QString &text, const QString &details, const QString &caption=QString(), Options options=Notify)
 
void detailedSorry (QWidget *parent, const QString &text, const QString &details, const QString &caption, const KGuiItem &buttonOk, Options options=Notify)
 
static void detailedSorryInternal (QDialog *dialog, const QString &text, const QString &details, const QString &caption, const KGuiItem &buttonOk_, Options options)
 
void detailedSorryWId (WId parent_id, const QString &text, const QString &details, const QString &caption=QString(), Options options=Notify)
 
void detailedSorryWId (WId parent_id, const QString &text, const QString &details, const QString &caption, const KGuiItem &buttonOk, Options options=Notify)
 
void enableAllMessages ()
 
void enableMessage (const QString &dontShowAgainName)
 
void error (QWidget *parent, const QString &text, const QString &caption=QString(), Options options=Notify)
 
void errorList (QWidget *parent, const QString &text, const QStringList &strlist, const QString &caption=QString(), Options options=Notify)
 
static void errorListInternal (QDialog *dialog, const QString &text, const QStringList &strlist, const QString &caption, Options options)
 
void errorListWId (WId parent_id, const QString &text, const QStringList &strlist, const QString &caption=QString(), Options options=Notify)
 
void errorWId (WId parent_id, const QString &text, const QString &caption=QString(), Options options=Notify)
 
void information (QWidget *parent, const QString &text, const QString &caption=QString(), const QString &dontShowAgainName=QString(), Options options=Notify)
 
void informationList (QWidget *parent, const QString &text, const QStringList &strlist, const QString &caption=QString(), const QString &dontShowAgainName=QString(), Options options=Notify)
 
static void informationListInternal (QDialog *dialog, const QString &text, const QStringList &strlist, const QString &caption, const QString &dontShowAgainName, Options options)
 
void informationListWId (WId parent_id, const QString &text, const QStringList &strlist, const QString &caption=QString(), const QString &dontShowAgainName=QString(), Options options=Notify)
 
void informationWId (WId parent_id, const QString &text, const QString &caption=QString(), const QString &dontShowAgainName=QString(), Options options=Notify)
 
ButtonCode messageBox (QWidget *parent, DialogType type, const QString &text, const QString &caption=QString(), const KGuiItem &buttonYes=KStandardGuiItem::yes(), const KGuiItem &buttonNo=KStandardGuiItem::no(), const KGuiItem &buttonCancel=KStandardGuiItem::cancel(), const QString &dontShowAskAgainName=QString(), Options options=Notify)
 
static ButtonCode messageBoxInternal (QDialog *dialog, DialogType type, const QString &text, const QString &caption, const KGuiItem &buttonYes, const KGuiItem &buttonNo, const KGuiItem &buttonCancel, const QString &dontShow, Options options)
 
ButtonCode messageBoxWId (WId parent_id, DialogType type, const QString &text, const QString &caption=QString(), const KGuiItem &buttonYes=KStandardGuiItem::yes(), const KGuiItem &buttonNo=KStandardGuiItem::no(), const KGuiItem &buttonCancel=KStandardGuiItem::cancel(), const QString &dontShowAskAgainName=QString(), Options options=Notify)
 
ButtonCode questionYesNo (QWidget *parent, const QString &text, const QString &caption=QString(), const KGuiItem &buttonYes=KStandardGuiItem::yes(), const KGuiItem &buttonNo=KStandardGuiItem::no(), const QString &dontAskAgainName=QString(), Options options=Notify)
 
ButtonCode questionYesNoCancel (QWidget *parent, const QString &text, const QString &caption=QString(), const KGuiItem &buttonYes=KStandardGuiItem::yes(), const KGuiItem &buttonNo=KStandardGuiItem::no(), const KGuiItem &buttonCancel=KStandardGuiItem::cancel(), const QString &dontAskAgainName=QString(), Options options=Notify)
 
static ButtonCode questionYesNoCancelInternal (QDialog *dialog, const QString &text, const QString &caption, const KGuiItem &buttonYes_, const KGuiItem &buttonNo_, const KGuiItem &buttonCancel_, const QString &dontAskAgainName, Options options)
 
ButtonCode questionYesNoCancelWId (WId parent_id, const QString &text, const QString &caption=QString(), const KGuiItem &buttonYes=KStandardGuiItem::yes(), const KGuiItem &buttonNo=KStandardGuiItem::no(), const KGuiItem &buttonCancel=KStandardGuiItem::cancel(), const QString &dontAskAgainName=QString(), Options options=Notify)
 
ButtonCode questionYesNoList (QWidget *parent, const QString &text, const QStringList &strlist, const QString &caption=QString(), const KGuiItem &buttonYes=KStandardGuiItem::yes(), const KGuiItem &buttonNo=KStandardGuiItem::no(), const QString &dontAskAgainName=QString(), Options options=Notify)
 
static ButtonCode questionYesNoListInternal (QDialog *dialog, const QString &text, const QStringList &strlist, const QString &caption, const KGuiItem &buttonYes_, const KGuiItem &buttonNo_, const QString &dontAskAgainName, Options options)
 
ButtonCode questionYesNoListWId (WId parent_id, const QString &text, const QStringList &strlist, const QString &caption=QString(), const KGuiItem &buttonYes=KStandardGuiItem::yes(), const KGuiItem &buttonNo=KStandardGuiItem::no(), const QString &dontAskAgainName=QString(), Options options=Notify)
 
ButtonCode questionYesNoWId (WId parent_id, const QString &text, const QString &caption=QString(), const KGuiItem &buttonYes=KStandardGuiItem::yes(), const KGuiItem &buttonNo=KStandardGuiItem::no(), const QString &dontAskAgainName=QString(), Options options=Notify)
 
void saveDontShowAgainContinue (const QString &dontShowAgainName)
 
void saveDontShowAgainYesNo (const QString &dontShowAgainName, ButtonCode result)
 
void setDontShowAgainConfig (KConfig *cfg)
 
KWIDGETSADDONS_EXPORT void setDontShowAgainInterface (KMessageBoxDontAskAgainInterface *dontAskAgainInterface)
 
KWIDGETSADDONS_EXPORT void setDontShowAskAgainConfig (KConfig *cfg)
 
static void setMainWindow (QWidget *subWidget, WId mainWindowId)
 
KWIDGETSADDONS_EXPORT void setNotifyInterface (KMessageBoxNotifyInterface *notifyInterface)
 
bool shouldBeShownContinue (const QString &dontShowAgainName)
 
bool shouldBeShownYesNo (const QString &dontShowAgainName, ButtonCode &result)
 
void sorry (QWidget *parent, const QString &text, const QString &caption=QString(), Options options=Notify)
 
void sorry (QWidget *parent, const QString &text, const QString &caption, const KGuiItem &buttonOk, Options options=Notify)
 
static void sorryInternal (QDialog *dialog, const QString &text, const QString &caption, const KGuiItem &buttonOk_, Options options)
 
KWIDGETSADDONS_EXPORT void sorryWId (WId parent_id, const QString &text, const QString &caption, const KGuiItem &buttonOk, Options options=Notify)
 
void sorryWId (WId parent_id, const QString &text, const QString &caption=QString(), Options options=Notify)
 
ButtonCode warningContinueCancel (QWidget *parent, const QString &text, const QString &caption=QString(), const KGuiItem &buttonContinue=KStandardGuiItem::cont(), const KGuiItem &buttonCancel=KStandardGuiItem::cancel(), const QString &dontAskAgainName=QString(), Options options=Notify)
 
ButtonCode warningContinueCancelDetailed (QWidget *parent, const QString &text, const QString &caption=QString(), const KGuiItem &buttonContinue=KStandardGuiItem::cont(), const KGuiItem &buttonCancel=KStandardGuiItem::cancel(), const QString &dontAskAgainName=QString(), Options options=Notify, const QString &details=QString())
 
ButtonCode warningContinueCancelList (QWidget *parent, const QString &text, const QStringList &strlist, const QString &caption=QString(), const KGuiItem &buttonContinue=KStandardGuiItem::cont(), const KGuiItem &buttonCancel=KStandardGuiItem::cancel(), const QString &dontAskAgainName=QString(), Options options=Notify)
 
static ButtonCode warningContinueCancelListInternal (QDialog *dialog, const QString &text, const QStringList &strlist, const QString &caption, const KGuiItem &buttonContinue_, const KGuiItem &buttonCancel_, const QString &dontAskAgainName, Options options, const QString &details)
 
ButtonCode warningContinueCancelListWId (WId parent_id, const QString &text, const QStringList &strlist, const QString &caption=QString(), const KGuiItem &buttonContinue=KStandardGuiItem::cont(), const KGuiItem &buttonCancel=KStandardGuiItem::cancel(), const QString &dontAskAgainName=QString(), Options options=Notify)
 
ButtonCode warningContinueCancelWId (WId parent_id, const QString &text, const QString &caption=QString(), const KGuiItem &buttonContinue=KStandardGuiItem::cont(), const KGuiItem &buttonCancel=KStandardGuiItem::cancel(), const QString &dontAskAgainName=QString(), Options options=Notify)
 
ButtonCode warningYesNo (QWidget *parent, const QString &text, const QString &caption=QString(), const KGuiItem &buttonYes=KStandardGuiItem::yes(), const KGuiItem &buttonNo=KStandardGuiItem::no(), const QString &dontAskAgainName=QString(), Options options=Options(Notify|Dangerous))
 
ButtonCode warningYesNoCancel (QWidget *parent, const QString &text, const QString &caption=QString(), const KGuiItem &buttonYes=KStandardGuiItem::yes(), const KGuiItem &buttonNo=KStandardGuiItem::no(), const KGuiItem &buttonCancel=KStandardGuiItem::cancel(), const QString &dontAskAgainName=QString(), Options options=Notify)
 
ButtonCode warningYesNoCancelList (QWidget *parent, const QString &text, const QStringList &strlist, const QString &caption=QString(), const KGuiItem &buttonYes=KStandardGuiItem::yes(), const KGuiItem &buttonNo=KStandardGuiItem::no(), const KGuiItem &buttonCancel=KStandardGuiItem::cancel(), const QString &dontAskAgainName=QString(), Options options=Notify)
 
static ButtonCode warningYesNoCancelListInternal (QDialog *dialog, const QString &text, const QStringList &strlist, const QString &caption, const KGuiItem &buttonYes_, const KGuiItem &buttonNo_, const KGuiItem &buttonCancel_, const QString &dontAskAgainName, Options options)
 
ButtonCode warningYesNoCancelListWId (WId parent_id, const QString &text, const QStringList &strlist, const QString &caption=QString(), const KGuiItem &buttonYes=KStandardGuiItem::yes(), const KGuiItem &buttonNo=KStandardGuiItem::no(), const KGuiItem &buttonCancel=KStandardGuiItem::cancel(), const QString &dontAskAgainName=QString(), Options options=Notify)
 
ButtonCode warningYesNoCancelWId (WId parent_id, const QString &text, const QString &caption=QString(), const KGuiItem &buttonYes=KStandardGuiItem::yes(), const KGuiItem &buttonNo=KStandardGuiItem::no(), const KGuiItem &buttonCancel=KStandardGuiItem::cancel(), const QString &dontAskAgainName=QString(), Options options=Notify)
 
ButtonCode warningYesNoList (QWidget *parent, const QString &text, const QStringList &strlist, const QString &caption=QString(), const KGuiItem &buttonYes=KStandardGuiItem::yes(), const KGuiItem &buttonNo=KStandardGuiItem::no(), const QString &dontAskAgainName=QString(), Options options=Options(Notify|Dangerous))
 
static ButtonCode warningYesNoListInternal (QDialog *dialog, const QString &text, const QStringList &strlist, const QString &caption, const KGuiItem &buttonYes_, const KGuiItem &buttonNo_, const QString &dontAskAgainName, Options options)
 
ButtonCode warningYesNoListWId (WId parent_id, const QString &text, const QStringList &strlist, const QString &caption=QString(), const KGuiItem &buttonYes=KStandardGuiItem::yes(), const KGuiItem &buttonNo=KStandardGuiItem::no(), const QString &dontAskAgainName=QString(), Options options=Options(Notify|Dangerous))
 
ButtonCode warningYesNoWId (WId parent_id, const QString &text, const QString &caption=QString(), const KGuiItem &buttonYes=KStandardGuiItem::yes(), const KGuiItem &buttonNo=KStandardGuiItem::no(), const QString &dontAskAgainName=QString(), Options options=Options(Notify|Dangerous))
 

Variables

QDialogButtonBox::StandardButton KWIDGETSADDONS_EXPORT(* KMessageBox_exec_hook )(QDialog *) = nullptr
 

Detailed Description

Easy message dialog box.

Provides convenience functions for some i18n'ed standard dialogs, as well as audible notification via KNotification

The text in message boxes is wrapped automatically. The text may either be plaintext or richtext. If the text is plaintext, a newline-character may be used to indicate the end of a paragraph.

kmessagebox.png
KMessageBox (using questionYesNo())
Author
Waldo Bastian (basti[email protected][email protected][email protected]de.or[email protected]g)

Typedef Documentation

Stores a combination of Option values.

Definition at line 83 of file kmessagebox.h.

Enumeration Type Documentation

Button types.

Definition at line 48 of file kmessagebox.h.

See also
Options
Enumerator
Notify 

Emit a KNotify event.

AllowLink 

The message may contain links.

Dangerous 

The action to be confirmed by the dialog is a potentially destructive one. The default button will be set to Cancel or No, depending on which is available.

PlainCaption 

Do not use KApplication::makeStdCaption()

NoExec 

Do not call exec() in createKMessageBox()

WindowModal 

The window is to be modal relative to its parent. By default, it is application modal.

Definition at line 71 of file kmessagebox.h.

Function Documentation

KWIDGETSADDONS_EXPORT void KMessageBox::about ( QWidget parent,
const QString text,
const QString caption = QString(),
Options  options = Notify 
)

Display an "About" dialog.

Parameters
parentParent widget.
textMessage string.
captionMessage box title. The application name is added to the title. The default title is i18n("About \<appname\>").
optionssee Options

Your program wants to show some general information about the application like the authors's names and email addresses.

The default button is "&OK".

NOTE: The ok button will always have the i18n'ed text '&OK'.

Definition at line 936 of file kmessagebox.cpp.

KWIDGETSADDONS_EXPORT QDialogButtonBox::StandardButton KMessageBox::createKMessageBox ( QDialog dialog,
QDialogButtonBox buttons,
QMessageBox::Icon  icon,
const QString text,
const QStringList strlist,
const QString ask,
bool *  checkboxReturn,
Options  options,
const QString details = QString() 
)

Create content and layout of a standard dialog.

Parameters
dialogThe parent dialog base
buttonsa QDialogButtonBox instance. This function will take care of connecting to it.
iconWhich predefined icon the message box shall show.
textMessage string.
strlistList of strings to be written in the listbox. If the list is empty, it doesn't show any listbox
askThe text of the checkbox. If empty none will be shown.
checkboxReturnThe result of the checkbox. If it's initially true then the checkbox will be checked by default. May be a null pointer. Incompatible with NoExec.
optionssee Options
detailsDetailed message string.
Returns
A QDialogButtonBox::StandardButton button code, not a KMessageBox button code, based on the buttonmask given to the constructor of the dialog (ie. will return QDialogButtonBox::Yes instead of KMessageBox::Yes). Will return QDialogButtonBox::NoButton if the message box is queued for display instead of exec()ed immediately or if the option NoExec is set.
Note
Unless NoExec is used, the dialog that is passed in is deleted by this function. Do not delete it yourself.

Definition at line 154 of file kmessagebox.cpp.

KWIDGETSADDONS_EXPORT QDialogButtonBox::StandardButton KMessageBox::createKMessageBox ( QDialog dialog,
QDialogButtonBox buttons,
const QIcon icon,
const QString text,
const QStringList strlist,
const QString ask,
bool *  checkboxReturn,
Options  options,
const QString details = QString(),
QMessageBox::Icon  notifyType = QMessageBox::Information 
)

Create content and layout of a standard dialog.

Parameters
dialogThe parent dialog base
buttonsa QDialogButtonBox instance. This function will take care of connecting to it.
iconA QPixmap containing the icon to be displayed in the dialog next to the text.
textMessage string.
strlistList of strings to be written in the listbox. If the list is empty, it doesn't show any listbox
askThe text of the checkbox. If empty none will be shown.
checkboxReturnThe result of the checkbox. If it's initially true then the checkbox will be checked by default. May be a null pointer. Incompatible with NoExec.
optionssee Options
detailsDetailed message string.
notifyTypeThe type of notification to send when this message is presentend.
Returns
A QDialogButtonBox::StandardButton button code, not a KMessageBox button code, based on the buttonmask given to the constructor of the dialog (ie. will return QDialogButtonBox::Yes instead of KMessageBox::Yes). Will return QDialogButtonBox::NoButton if the message box is queued for display instead of exec()ed immediately or if the option NoExec is set.
Note
Unless NoExec is used, the dialog that is passed in is deleted by this function. Do not delete it yourself.

Definition at line 182 of file kmessagebox.cpp.

static QDialog* KMessageBox::createWIdDialog ( WId  parent_id)
static

Create a QDialog whose parent is a foreign window.

Definition at line 110 of file kmessagebox.cpp.

KWIDGETSADDONS_EXPORT void KMessageBox::detailedError ( QWidget parent,
const QString text,
const QString details,
const QString caption = QString(),
Options  options = Notify 
)

Displays an "Error" dialog with a "Details >>" button.

Parameters
parentParent widget.
textMessage string.
detailsDetailed message string.
captionMessage box title. The application name is added to the title. The default title is i18n("Error").
optionssee Options

Your program messed up and now it's time to inform the user. To be used for important things like "Sorry, I deleted your hard disk."

The details message can contain additional information about the problem and can be shown on request to advanced/interested users.

If your program detects the action specified by the user is somehow not allowed, this should never be reported with error(). Use sorry() instead to explain to the user that this action is not allowed.

The default button is "&OK". Pressing "Esc" selects the OK-button.

NOTE: The OK button will always have the i18n'ed text '&OK'.

Definition at line 820 of file kmessagebox.cpp.

KWIDGETSADDONS_EXPORT void KMessageBox::detailedErrorWId ( WId  parent_id,
const QString text,
const QString details,
const QString caption = QString(),
Options  options = Notify 
)

This function accepts the window id of the parent window, instead of QWidget*.

It should be used only when necessary.

Definition at line 1123 of file kmessagebox.cpp.

KWIDGETSADDONS_EXPORT void KMessageBox::detailedSorry ( QWidget parent,
const QString text,
const QString details,
const QString caption = QString(),
Options  options = Notify 
)

Displays a "Sorry" dialog with a "Details >>" button.

Parameters
parentParent widget.
textMessage string.
detailsDetailed message string.
captionMessage box title. The application name is added to the title. The default title is i18n("Sorry").
optionssee Options

Either your program messed up and asks for understanding or your user did something stupid.

To be used for small problems like "Sorry, I can't find the file you specified."

And then details can contain something like "foobar.txt was not found in any of the following directories: /usr/bin,/usr/local/bin,/usr/sbin"

The default button is "&OK". Pressing "Esc" selects the OK-button.

NOTE: The ok button will always have the i18n'ed text '&OK'. See the overload with a KGuiItem argument to change that.

Definition at line 881 of file kmessagebox.cpp.

KWIDGETSADDONS_EXPORT void KMessageBox::detailedSorry ( QWidget parent,
const QString text,
const QString details,
const QString caption,
const KGuiItem buttonOk,
Options  options = Notify 
)

Displays a "Sorry" dialog with a "Details >>" button.

Parameters
parentParent widget.
textMessage string.
detailsDetailed message string.
captionMessage box title. The application name is added to the title. The default title is i18n("Sorry").
buttonOkThe text for the only button. The default is KStandardGuiItem::ok().
optionssee Options

Either your program messed up and asks for understanding or your user did something stupid.

To be used for small problems like "Sorry, I can't find the file you specified."

And then details can contain something like "foobar.txt was not found in any of the following directories: /usr/bin,/usr/local/bin,/usr/sbin"

There is only one button, therefore it's the default button, and pressing "Esc" selects it as well.

Since
5.63

Definition at line 888 of file kmessagebox.cpp.

KWIDGETSADDONS_EXPORT void KMessageBox::detailedSorryWId ( WId  parent_id,
const QString text,
const QString details,
const QString caption = QString(),
Options  options = Notify 
)

This function accepts the window id of the parent window, instead of QWidget*.

It should be used only when necessary.

Definition at line 1149 of file kmessagebox.cpp.

KWIDGETSADDONS_EXPORT void KMessageBox::detailedSorryWId ( WId  parent_id,
const QString text,
const QString details,
const QString caption,
const KGuiItem buttonOk,
Options  options = Notify 
)

This function accepts the window id of the parent window, instead of QWidget*.

It should be used only when necessary.

Since
5.63

Definition at line 1156 of file kmessagebox.cpp.

KWIDGETSADDONS_EXPORT void KMessageBox::enableAllMessages ( )

Enable all messages which have been turned off with the dontShowAgainName feature.

Definition at line 429 of file kmessagebox.cpp.

KWIDGETSADDONS_EXPORT void KMessageBox::enableMessage ( const QString dontShowAgainName)

Re-enable a specific dontShowAgainName messages that had previously been turned off.

See also
saveDontShowAgainYesNo()
saveDontShowAgainContinue()

Definition at line 434 of file kmessagebox.cpp.

KWIDGETSADDONS_EXPORT void KMessageBox::error ( QWidget parent,
const QString text,
const QString caption = QString(),
Options  options = Notify 
)

Display an "Error" dialog.

Parameters
parentParent widget.
textMessage string.
captionMessage box title. The application name is added to the title. The default title is i18n("Error").
optionssee Options

Your program messed up and now it's time to inform the user. To be used for important things like "Sorry, I deleted your hard disk."

If your program detects the action specified by the user is somehow not allowed, this should never be reported with error(). Use sorry() instead to explain to the user that this action is not allowed.

The default button is "&OK". Pressing "Esc" selects the OK-button.

NOTE: The OK button will always have the i18n'ed text '&OK'.

Definition at line 778 of file kmessagebox.cpp.

KWIDGETSADDONS_EXPORT void KMessageBox::errorList ( QWidget parent,
const QString text,
const QStringList strlist,
const QString caption = QString(),
Options  options = Notify 
)

Display an "Error" dialog with a listbox.

Parameters
parentParent widget.
textMessage string.
strlistList of strings to be written in the listbox. If the list is empty, it doesn't show any listbox, working as error().
captionMessage box title. The application name is added to the title. The default title is i18n("Error").
optionssee Options

Your program messed up and now it's time to inform the user. To be used for important things like "Sorry, I deleted your hard disk."

If your program detects the action specified by the user is somehow not allowed, this should never be reported with error(). Use sorry() instead to explain to the user that this action is not allowed.

The default button is "&OK". Pressing "Esc" selects the OK-button.

NOTE: The OK button will always have the i18n'ed text '&OK'.

Definition at line 798 of file kmessagebox.cpp.

KWIDGETSADDONS_EXPORT void KMessageBox::errorListWId ( WId  parent_id,
const QString text,
const QStringList strlist,
const QString caption = QString(),
Options  options = Notify 
)

This function accepts the window id of the parent window, instead of QWidget*.

It should be used only when necessary.

Definition at line 1117 of file kmessagebox.cpp.

KWIDGETSADDONS_EXPORT void KMessageBox::errorWId ( WId  parent_id,
const QString text,
const QString caption = QString(),
Options  options = Notify 
)

This function accepts the window id of the parent window, instead of QWidget*.

It should be used only when necessary.

Definition at line 1111 of file kmessagebox.cpp.

KWIDGETSADDONS_EXPORT void KMessageBox::information ( QWidget parent,
const QString text,
const QString caption = QString(),
const QString dontShowAgainName = QString(),
Options  options = Notify 
)

Display an "Information" dialog.

Parameters
parentParent widget.
textMessage string.
captionMessage box title. The application name is added to the title. The default title is i18n("Information").
dontShowAgainNameIf provided, a checkbox is added with which further notifications can be turned off. The string is used to lookup and store the setting in the applications config file. The setting is stored in the "Notification Messages" group.
optionssee Options

Your program wants to tell the user something. To be used for things like: "Your bookmarks have been rearranged."

The default button is "&OK". Pressing "Esc" selects the OK-button.

NOTE: The OK button will always have the i18n'ed text '&OK'.

Definition at line 897 of file kmessagebox.cpp.

KWIDGETSADDONS_EXPORT void KMessageBox::informationList ( QWidget parent,
const QString text,
const QStringList strlist,
const QString caption = QString(),
const QString dontShowAgainName = QString(),
Options  options = Notify 
)

Display an "Information" dialog with a listbox.

Parameters
parentParent widget.
textMessage string.
strlistList of strings to be written in the listbox. If the list is empty, it doesn't show any listbox, working as information.
captionMessage box title. The application name is added to the title. The default title is i18n("Information").
dontShowAgainNameIf provided, a checkbox is added with which further notifications can be turned off. The string is used to lookup and store the setting in the applications config file. The setting is stored in the "Notification Messages" group.
optionssee Options

Your program wants to tell the user something. To be used for things like: "The following bookmarks have been rearranged:"

The default button is "&OK". Pressing "Esc" selects the OK-button.

NOTE: The OK button will always have the i18n'ed text '&OK'.

Definition at line 930 of file kmessagebox.cpp.

KWIDGETSADDONS_EXPORT void KMessageBox::informationListWId ( WId  parent_id,
const QString text,
const QStringList strlist,
const QString caption = QString(),
const QString dontShowAgainName = QString(),
Options  options = Notify 
)

This function accepts the window id of the parent window, instead of QWidget*.

It should be used only when necessary.

Definition at line 1171 of file kmessagebox.cpp.

KWIDGETSADDONS_EXPORT void KMessageBox::informationWId ( WId  parent_id,
const QString text,
const QString caption = QString(),
const QString dontShowAgainName = QString(),
Options  options = Notify 
)

This function accepts the window id of the parent window, instead of QWidget*.

It should be used only when necessary.

Definition at line 1165 of file kmessagebox.cpp.

KWIDGETSADDONS_EXPORT ButtonCode KMessageBox::messageBox ( QWidget parent,
DialogType  type,
const QString text,
const QString caption = QString(),
const KGuiItem buttonYes = KStandardGuiItem::yes(),
const KGuiItem buttonNo = KStandardGuiItem::no(),
const KGuiItem buttonCancel = KStandardGuiItem::cancel(),
const QString dontShowAskAgainName = QString(),
Options  options = Notify 
)

Alternate method to show a messagebox:

Parameters
parentParent widget.
typetype of message box: QuestionYesNo, WarningYesNo, WarningContinueCancel...
textMessage string.
captionMessage box title.
buttonYesThe text for the first button. The default is KStandardGuiItem::yes().
buttonNoThe text for the second button. The default is KStandardGuiItem::no().
buttonCancelThe text for the third button. The default is KStandardGuiItem::cancel().
dontShowAskAgainNameIf provided, a checkbox is added with which further questions/information can be turned off. If turned off all questions will be automatically answered with the last answer (either Yes or No), if the message box needs an answer. The string is used to lookup and store the setting in the applications config file.
optionssee Options Note: for ContinueCancel, buttonYes is the continue button and buttonNo is unused. and for Information, none is used.
Returns
a button code, as defined in KMessageBox.

Definition at line 994 of file kmessagebox.cpp.

KWIDGETSADDONS_EXPORT ButtonCode KMessageBox::messageBoxWId ( WId  parent_id,
DialogType  type,
const QString text,
const QString caption = QString(),
const KGuiItem buttonYes = KStandardGuiItem::yes(),
const KGuiItem buttonNo = KStandardGuiItem::no(),
const KGuiItem buttonCancel = KStandardGuiItem::cancel(),
const QString dontShowAskAgainName = QString(),
Options  options = Notify 
)

This function accepts the window id of the parent window, instead of QWidget*.

It should be used only when necessary.

Definition at line 1177 of file kmessagebox.cpp.

KWIDGETSADDONS_EXPORT ButtonCode KMessageBox::questionYesNo ( QWidget parent,
const QString text,
const QString caption = QString(),
const KGuiItem buttonYes = KStandardGuiItem::yes(),
const KGuiItem buttonNo = KStandardGuiItem::no(),
const QString dontAskAgainName = QString(),
Options  options = Notify 
)

Display a simple "question" dialog.

Parameters
parentParent widget.
textMessage string.
captionMessage box title. The application name is added to the title. The default title is i18n("Question").
buttonYesThe text for the first button. The default is KStandardGuiItem::yes().
buttonNoThe text for the second button. The default is KStandardGuiItem::no().
dontAskAgainNameIf provided, a checkbox is added with which further confirmation can be turned off. The string is used to lookup and store the setting in the applications config file. The setting is stored in the "Notification Messages" group. If dontAskAgainName starts with a ':' then the setting is stored in the global config file.
optionssee Option
Returns
'Yes' is returned if the Yes-button is pressed. 'No' is returned if the No-button is pressed.

To be used for questions like "Do you have a printer?"

The default button is "Yes". Pressing "Esc" selects "No".

Definition at line 384 of file kmessagebox.cpp.

KWIDGETSADDONS_EXPORT ButtonCode KMessageBox::questionYesNoCancel ( QWidget parent,
const QString text,
const QString caption = QString(),
const KGuiItem buttonYes = KStandardGuiItem::yes(),
const KGuiItem buttonNo = KStandardGuiItem::no(),
const KGuiItem buttonCancel = KStandardGuiItem::cancel(),
const QString dontAskAgainName = QString(),
Options  options = Notify 
)

Display a simple "question" dialog.

Parameters
parentParent widget.
textMessage string.
captionMessage box title. The application name is added to the title. The default title is i18n("Question").
buttonYesThe text for the first button. The default is KStandardGuiItem::yes().
buttonNoThe text for the second button. The default is KStandardGuiItem::no().
buttonCancelThe text for the third button. The default is KStandardGuiItem::cancel().
dontAskAgainNameIf provided, a checkbox is added with which further confirmation can be turned off. The string is used to lookup and store the setting in the applications config file. The setting is stored in the "Notification Messages" group. If dontAskAgainName starts with a ':' then the setting is stored in the global config file.
optionssee Options
Returns
'Yes' is returned if the Yes-button is pressed. 'No' is returned if the No-button is pressed.

To be used for questions like "Do you want to discard the message or save it for later?",

The default button is "Yes". Pressing "Esc" selects "Cancel".

Definition at line 547 of file kmessagebox.cpp.

KWIDGETSADDONS_EXPORT ButtonCode KMessageBox::questionYesNoCancelWId ( WId  parent_id,
const QString text,
const QString caption = QString(),
const KGuiItem buttonYes = KStandardGuiItem::yes(),
const KGuiItem buttonNo = KStandardGuiItem::no(),
const KGuiItem buttonCancel = KStandardGuiItem::cancel(),
const QString dontAskAgainName = QString(),
Options  options = Notify 
)

This function accepts the window id of the parent window, instead of QWidget*.

It should be used only when necessary.

Definition at line 1026 of file kmessagebox.cpp.

KWIDGETSADDONS_EXPORT ButtonCode KMessageBox::questionYesNoList ( QWidget parent,
const QString text,
const QStringList strlist,
const QString caption = QString(),
const KGuiItem buttonYes = KStandardGuiItem::yes(),
const KGuiItem buttonNo = KStandardGuiItem::no(),
const QString dontAskAgainName = QString(),
Options  options = Notify 
)

Display a "question" dialog with a listbox to show information to the user.

Parameters
parentParent widget.
textMessage string.
strlistList of strings to be written in the listbox. If the list is empty, it doesn't show any listbox, working as questionYesNo.
captionMessage box title. The application name is added to the title. The default title is i18n("Question").
buttonYesThe text for the first button. The default is KStandardGuiItem::yes().
buttonNoThe text for the second button. The default is KStandardGuiItem::no().
dontAskAgainNameIf provided, a checkbox is added with which further confirmation can be turned off. The string is used to lookup and store the setting in the applications config file. The setting is stored in the "Notification Messages" group. If dontAskAgainName starts with a ':' then the setting is stored in the global config file.
optionssee Options
Returns
'Yes' is returned if the Yes-button is pressed. 'No' is returned if the No-button is pressed.

To be used for questions like "Do you really want to delete these files?" And show the user exactly which files are going to be deleted in case he presses "Yes"

The default button is "Yes". Pressing "Esc" selects "No".

Definition at line 484 of file kmessagebox.cpp.

KWIDGETSADDONS_EXPORT ButtonCode KMessageBox::questionYesNoListWId ( WId  parent_id,
const QString text,
const QStringList strlist,
const QString caption = QString(),
const KGuiItem buttonYes = KStandardGuiItem::yes(),
const KGuiItem buttonNo = KStandardGuiItem::no(),
const QString dontAskAgainName = QString(),
Options  options = Notify 
)

This function accepts the window id of the parent window, instead of QWidget*.

It should be used only when necessary.

Definition at line 1014 of file kmessagebox.cpp.

KWIDGETSADDONS_EXPORT ButtonCode KMessageBox::questionYesNoWId ( WId  parent_id,
const QString text,
const QString caption = QString(),
const KGuiItem buttonYes = KStandardGuiItem::yes(),
const KGuiItem buttonNo = KStandardGuiItem::no(),
const QString dontAskAgainName = QString(),
Options  options = Notify 
)

This function accepts the window id of the parent window, instead of QWidget*.

It should be used only when necessary.

Definition at line 1003 of file kmessagebox.cpp.

KWIDGETSADDONS_EXPORT void KMessageBox::saveDontShowAgainContinue ( const QString dontShowAgainName)

Save the fact that the continue/cancel message box should not be shown again.

Parameters
dontShowAgainNamethe name that identify the message box. If empty, this method does nothing.

Definition at line 421 of file kmessagebox.cpp.

KWIDGETSADDONS_EXPORT void KMessageBox::saveDontShowAgainYesNo ( const QString dontShowAgainName,
ButtonCode  result 
)

Save the fact that the yes/no message box should not be shown again.

Parameters
dontShowAgainNamethe name that identify the message box. If empty, this method does nothing.
resultthe value (Yes or No) that should be used as the result for the message box.

Definition at line 412 of file kmessagebox.cpp.

KWIDGETSADDONS_EXPORT void KMessageBox::setDontShowAgainConfig ( KConfig cfg)

Use cfg for all settings related to the dontShowAgainName feature.

If cfg is 0 (default) KGlobal::config() will be used.

Definition at line 439 of file kmessagebox.cpp.

KWIDGETSADDONS_EXPORT void KMessageBox::setDontShowAgainInterface ( KMessageBoxDontAskAgainInterface dontAskAgainInterface)

Use dontAskAgainInterface for all settings related to the dontShowAgain feature.

This method does not take ownership of dontAskAgainInterface.

Since
5.0
KWIDGETSADDONS_EXPORT void KMessageBox::setDontShowAskAgainConfig ( KConfig cfg)
inline
Deprecated:
since 5.0, use setDontShowAgainConfig()

Definition at line 851 of file kmessagebox.h.

KWIDGETSADDONS_EXPORT void KMessageBox::setNotifyInterface ( KMessageBoxNotifyInterface notifyInterface)

Use notifyInterface to send notifications.

This method does not take ownership of notifyInterface.

Since
5.0
KWIDGETSADDONS_EXPORT bool KMessageBox::shouldBeShownContinue ( const QString dontShowAgainName)
Returns
true if the corresponding continue/cancel message box should be shown.
Parameters
dontShowAgainNamethe name that identify the message box. If empty, true is always returned.

Definition at line 404 of file kmessagebox.cpp.

KWIDGETSADDONS_EXPORT bool KMessageBox::shouldBeShownYesNo ( const QString dontShowAgainName,
ButtonCode result 
)
Returns
true if the corresponding yes/no message box should be shown.
Parameters
dontShowAgainNamethe name that identify the message box. If empty, true is always returned.
resultis set to the result (Yes or No) that was chosen the last time the message box was shown. Only meaningful, if the message box should not be shown.

Definition at line 395 of file kmessagebox.cpp.

KWIDGETSADDONS_EXPORT void KMessageBox::sorry ( QWidget parent,
const QString text,
const QString caption = QString(),
Options  options = Notify 
)

Display a "Sorry" dialog.

Parameters
parentParent widget.
textMessage string.
captionMessage box title. The application name is added to the title. The default title is i18n("Sorry").
optionssee OptionsType

Either your program messed up and asks for understanding or your user did something stupid.

To be used for small problems like "Sorry, I can't find the file you specified."

The default button is "&OK". Pressing "Esc" selects the OK-button.

NOTE: The ok button will always have the i18n'ed text '&OK'. See the overload with a KGuiItem argument to change that.

Definition at line 847 of file kmessagebox.cpp.

KWIDGETSADDONS_EXPORT void KMessageBox::sorry ( QWidget parent,
const QString text,
const QString caption,
const KGuiItem buttonOk,
Options  options = Notify 
)

Display a "Sorry" dialog.

Parameters
parentParent widget.
textMessage string.
captionMessage box title. The application name is added to the title. The default title is i18n("Sorry").
buttonOkThe text for the only button. The default is KStandardGuiItem::ok().
optionssee OptionsType

Either your program messed up and asks for understanding or your user did something stupid.

To be used for small problems like "Sorry, I can't find the file you specified."

The default button is "&OK". Pressing "Esc" selects the OK-button.

There is only one button, therefore it's the default button, and pressing "Esc" selects it as well.

Since
5.63

Definition at line 853 of file kmessagebox.cpp.

KWIDGETSADDONS_EXPORT void KMessageBox::sorryWId ( WId  parent_id,
const QString text,
const QString caption,
const KGuiItem buttonOk,
Options  options = Notify 
)

This function accepts the window id of the parent window, instead of QWidget*.

It should be used only when necessary.

Since
5.63
KWIDGETSADDONS_EXPORT void KMessageBox::sorryWId ( WId  parent_id,
const QString text,
const QString caption = QString(),
Options  options = Notify 
)

This function accepts the window id of the parent window, instead of QWidget*.

It should be used only when necessary.

Definition at line 1130 of file kmessagebox.cpp.

KWIDGETSADDONS_EXPORT ButtonCode KMessageBox::warningContinueCancel ( QWidget parent,
const QString text,
const QString caption = QString(),
const KGuiItem buttonContinue = KStandardGuiItem::cont(),
const KGuiItem buttonCancel = KStandardGuiItem::cancel(),
const QString dontAskAgainName = QString(),
Options  options = Notify 
)

Display a "warning" dialog.

Parameters
parentParent widget.
textMessage string.
captionMessage box title. The application name is added to the title. The default title is i18n("Warning").
buttonContinueThe text for the first button. The default is KStandardGuiItem::cont().
buttonCancelThe text for the second button. The default is KStandardGuiItem::cancel().
dontAskAgainNameIf provided, a checkbox is added with which further confirmation can be turned off. The string is used to lookup and store the setting in the applications config file. The setting is stored in the "Notification Messages" group. If dontAskAgainName starts with a ':' then the setting is stored in the global config file.
optionssee Options
Returns
Continue is returned if the Continue-button is pressed. Cancel is returned if the Cancel-button is pressed.

To be used for questions like "You are about to Print. Are you sure?" the continueButton should then be labeled "Print".

The default button is buttonContinue. Pressing "Esc" selects "Cancel".

Definition at line 623 of file kmessagebox.cpp.

KWIDGETSADDONS_EXPORT ButtonCode KMessageBox::warningContinueCancelDetailed ( QWidget parent,
const QString text,
const QString caption = QString(),
const KGuiItem buttonContinue = KStandardGuiItem::cont(),
const KGuiItem buttonCancel = KStandardGuiItem::cancel(),
const QString dontAskAgainName = QString(),
Options  options = Notify,
const QString details = QString() 
)

Display a "warning" dialog with a collapsible "Details" section.

Since
5.61

Definition at line 690 of file kmessagebox.cpp.

KWIDGETSADDONS_EXPORT ButtonCode KMessageBox::warningContinueCancelList ( QWidget parent,
const QString text,
const QStringList strlist,
const QString caption = QString(),
const KGuiItem buttonContinue = KStandardGuiItem::cont(),
const KGuiItem buttonCancel = KStandardGuiItem::cancel(),
const QString dontAskAgainName = QString(),
Options  options = Notify 
)

Display a "warning" dialog with a listbox to show information to the user.

Parameters
parentParent widget.
textMessage string.
strlistList of strings to be written in the listbox. If the list is empty, it doesn't show any listbox, working as warningContinueCancel.
captionMessage box title. The application name is added to the title. The default title is i18n("Warning").
buttonContinueThe text for the first button. The default is KStandardGuiItem::cont().
buttonCancelThe text for the second button. The default is KStandardGuiItem::cancel().
dontAskAgainNameIf provided, a checkbox is added with which further confirmation can be turned off. The string is used to lookup and store the setting in the applications config file. The setting is stored in the "Notification Messages" group. If dontAskAgainName starts with a ':' then the setting is stored in the global config file.
optionssee Options
Returns
Continue is returned if the Continue-button is pressed. Cancel is returned if the Cancel-button is pressed.

To be used for questions like "You are about to Print. Are you sure?" the continueButton should then be labeled "Print".

The default button is buttonContinue. Pressing "Esc" selects "Cancel".

Definition at line 677 of file kmessagebox.cpp.

KWIDGETSADDONS_EXPORT ButtonCode KMessageBox::warningContinueCancelListWId ( WId  parent_id,
const QString text,
const QStringList strlist,
const QString caption = QString(),
const KGuiItem buttonContinue = KStandardGuiItem::cont(),
const KGuiItem buttonCancel = KStandardGuiItem::cancel(),
const QString dontAskAgainName = QString(),
Options  options = Notify 
)

This function accepts the window id of the parent window, instead of QWidget*.

It should be used only when necessary.

Definition at line 1074 of file kmessagebox.cpp.

KWIDGETSADDONS_EXPORT ButtonCode KMessageBox::warningContinueCancelWId ( WId  parent_id,
const QString text,
const QString caption = QString(),
const KGuiItem buttonContinue = KStandardGuiItem::cont(),
const KGuiItem buttonCancel = KStandardGuiItem::cancel(),
const QString dontAskAgainName = QString(),
Options  options = Notify 
)

This function accepts the window id of the parent window, instead of QWidget*.

It should be used only when necessary.

Definition at line 1062 of file kmessagebox.cpp.

KWIDGETSADDONS_EXPORT ButtonCode KMessageBox::warningYesNo ( QWidget parent,
const QString text,
const QString caption = QString(),
const KGuiItem buttonYes = KStandardGuiItem::yes(),
const KGuiItem buttonNo = KStandardGuiItem::no(),
const QString dontAskAgainName = QString(),
Options  options = Options(Notify|Dangerous) 
)

Display a "warning" dialog.

Parameters
parentParent widget.
textMessage string.
captionMessage box title. The application name is added to the title. The default title is i18n("Warning").
buttonYesThe text for the first button. The default is KStandardGuiItem::yes().
buttonNoThe text for the second button. The default is KStandardGuiItem::no().
dontAskAgainNameIf provided, a checkbox is added with which further confirmation can be turned off. The string is used to lookup and store the setting in the applications config file. The setting is stored in the "Notification Messages" group. If dontAskAgainName starts with a ':' then the setting is stored in the global config file.
optionssee Options
Returns
Yes is returned if the Yes-button is pressed. No is returned if the No-button is pressed.

To be used for questions "Shall I update your configuration?" The text should explain the implication of both options.

The default button is "No". Pressing "Esc" selects "No".

Definition at line 560 of file kmessagebox.cpp.

KWIDGETSADDONS_EXPORT ButtonCode KMessageBox::warningYesNoCancel ( QWidget parent,
const QString text,
const QString caption = QString(),
const KGuiItem buttonYes = KStandardGuiItem::yes(),
const KGuiItem buttonNo = KStandardGuiItem::no(),
const KGuiItem buttonCancel = KStandardGuiItem::cancel(),
const QString dontAskAgainName = QString(),
Options  options = Notify 
)

Display a Yes/No/Cancel "warning" dialog.

Parameters
parentParent widget.
textMessage string.
captionMessage box title. The application name is added to the title. The default title is i18n("Warning").
buttonYesThe text for the first button. The default is KStandardGuiItem::yes().
buttonNoThe text for the second button. The default is KStandardGuiItem::no().
buttonCancelThe text for the third button. The default is KStandardGuiItem::cancel().
dontAskAgainNameIf provided, a checkbox is added with which further questions can be turned off. If turned off all questions will be automatically answered with the last answer (either Yes or No). The string is used to lookup and store the setting in the applications config file. The setting is stored in the "Notification Messages" group. If dontAskAgainName starts with a ':' then the setting is stored in the global config file.
optionssee Options
Returns
Yes is returned if the Yes-button is pressed. No is returned if the No-button is pressed. Cancel is retunred if the Cancel- button is pressed.

To be used for questions "Do you want to save your changes?" The text should explain the implication of choosing 'No'.

The default button is "Yes". Pressing "Esc" selects "Cancel"

Definition at line 703 of file kmessagebox.cpp.

KWIDGETSADDONS_EXPORT ButtonCode KMessageBox::warningYesNoCancelList ( QWidget parent,
const QString text,
const QStringList strlist,
const QString caption = QString(),
const KGuiItem buttonYes = KStandardGuiItem::yes(),
const KGuiItem buttonNo = KStandardGuiItem::no(),
const KGuiItem buttonCancel = KStandardGuiItem::cancel(),
const QString dontAskAgainName = QString(),
Options  options = Notify 
)

Display a Yes/No/Cancel "warning" dialog with a listbox to show information to the user.

Parameters
parentParent widget.
textMessage string.
strlistList of strings to be written in the listbox. If the list is empty, it doesn't show any listbox, working as warningYesNoCancel.
captionMessage box title. The application name is added to the title. The default title is i18n("Warning").
buttonYesThe text for the first button. The default is KStandardGuiItem::yes().
buttonNoThe text for the second button. The default is KStandardGuiItem::no().
buttonCancelThe text for the third button. The default is KStandardGuiItem::cancel().
dontAskAgainNameIf provided, a checkbox is added with which further questions can be turned off. If turned off all questions will be automatically answered with the last answer (either Yes or No). The string is used to lookup and store the setting in the applications config file. The setting is stored in the "Notification Messages" group. If dontAskAgainName starts with a ':' then the setting is stored in the global config file.
optionssee Options
Returns
Yes is returned if the Yes-button is pressed. No is returned if the No-button is pressed. Cancel is retunred if the Cancel- button is pressed.

To be used for questions "Do you want to save your changes?" The text should explain the implication of choosing 'No'.

The default button is "Yes". Pressing "Esc" selects "Cancel"

Definition at line 765 of file kmessagebox.cpp.

KWIDGETSADDONS_EXPORT ButtonCode KMessageBox::warningYesNoCancelListWId ( WId  parent_id,
const QString text,
const QStringList strlist,
const QString caption = QString(),
const KGuiItem buttonYes = KStandardGuiItem::yes(),
const KGuiItem buttonNo = KStandardGuiItem::no(),
const KGuiItem buttonCancel = KStandardGuiItem::cancel(),
const QString dontAskAgainName = QString(),
Options  options = Notify 
)

This function accepts the window id of the parent window, instead of QWidget*.

It should be used only when necessary.

Definition at line 1098 of file kmessagebox.cpp.

KWIDGETSADDONS_EXPORT ButtonCode KMessageBox::warningYesNoCancelWId ( WId  parent_id,
const QString text,
const QString caption = QString(),
const KGuiItem buttonYes = KStandardGuiItem::yes(),
const KGuiItem buttonNo = KStandardGuiItem::no(),
const KGuiItem buttonCancel = KStandardGuiItem::cancel(),
const QString dontAskAgainName = QString(),
Options  options = Notify 
)

This function accepts the window id of the parent window, instead of QWidget*.

It should be used only when necessary.

Definition at line 1086 of file kmessagebox.cpp.

KWIDGETSADDONS_EXPORT ButtonCode KMessageBox::warningYesNoList ( QWidget parent,
const QString text,
const QStringList strlist,
const QString caption = QString(),
const KGuiItem buttonYes = KStandardGuiItem::yes(),
const KGuiItem buttonNo = KStandardGuiItem::no(),
const QString dontAskAgainName = QString(),
Options  options = Options(Notify|Dangerous) 
)

Display a "warning" dialog with a listbox to show information to the user.

Parameters
parentParent widget.
textMessage string.
strlistList of strings to be written in the listbox. If the list is empty, it doesn't show any listbox, working as questionYesNo.
captionMessage box title. The application name is added to the title. The default title is i18n("Question").
buttonYesThe text for the first button. The default is KStandardGuiItem::yes().
buttonNoThe text for the second button. The default is KStandardGuiItem::no().
dontAskAgainNameIf provided, a checkbox is added with which further confirmation can be turned off. The string is used to lookup and store the setting in the applications config file. The setting is stored in the "Notification Messages" group. If dontAskAgainName starts with a ':' then the setting is stored in the global config file.
optionssee Options
Returns
'Yes' is returned if the Yes-button is pressed. 'No' is returned if the No-button is pressed.

To be used for questions like "Do you really want to delete these files?" And show the user exactly which files are going to be deleted in case he presses "Yes"

The default button is "No". Pressing "Esc" selects "No".

Definition at line 611 of file kmessagebox.cpp.

KWIDGETSADDONS_EXPORT ButtonCode KMessageBox::warningYesNoListWId ( WId  parent_id,
const QString text,
const QStringList strlist,
const QString caption = QString(),
const KGuiItem buttonYes = KStandardGuiItem::yes(),
const KGuiItem buttonNo = KStandardGuiItem::no(),
const QString dontAskAgainName = QString(),
Options  options = Options(Notify|Dangerous) 
)

This function accepts the window id of the parent window, instead of QWidget*.

It should be used only when necessary.

Definition at line 1050 of file kmessagebox.cpp.

KWIDGETSADDONS_EXPORT ButtonCode KMessageBox::warningYesNoWId ( WId  parent_id,
const QString text,
const QString caption = QString(),
const KGuiItem buttonYes = KStandardGuiItem::yes(),
const KGuiItem buttonNo = KStandardGuiItem::no(),
const QString dontAskAgainName = QString(),
Options  options = Options(Notify|Dangerous) 
)

This function accepts the window id of the parent window, instead of QWidget*.

It should be used only when necessary.

Definition at line 1039 of file kmessagebox.cpp.

This file is part of the KDE documentation.
Documentation copyright © 1996-2020 The KDE developers.
Generated on Sun Aug 2 2020 22:43:12 by doxygen 1.8.11 written by Dimitri van Heesch, © 1997-2006

KDE's Doxygen guidelines are available online.