KMessageBox Namespace

Function Documentation

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

Create content and layout of a standard dialog

dialog The parent dialog base

buttons a QDialogButtonBox instance. This function will take care of connecting to it.

icon Which predefined icon the message box shall show.

text Message string.

strlist List of strings to be written in the listbox. If the list is empty, it doesn't show any listbox

ask The text of the checkbox. If empty none will be shown.

checkboxReturn The 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.

options see Options

details Detailed 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::PrimaryAction). Will return QDialogButtonBox::NoButton if the message box is queued for display instead of exec()ed immediately or if the option NoExec is set.

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

Create content and layout of a standard dialog

dialog The parent dialog base

buttons a QDialogButtonBox instance. This function will take care of connecting to it.

icon A QPixmap containing the icon to be displayed in the dialog next to the text.

text Message string.

strlist List of strings to be written in the listbox. If the list is empty, it doesn't show any listbox

ask The text of the checkbox. If empty none will be shown.

checkboxReturn The 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.

options see Options

details Detailed message string.

notifyType The 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::PrimaryAction). Will return QDialogButtonBox::NoButton if the message box is queued for display instead of exec()ed immediately or if the option NoExec is set.

void KMessageBox::detailedError(QWidget *parent, const QString &text, const QString &details, const QString &title = QString(), KMessageBox::Options options = Notify)

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

parent Parent widget.

text Message string.

details Detailed message string.

title Message box title. The application name is added to the title. The default title is i18n("Error").

options see 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.

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

[since 5.97] void KMessageBox::detailedError(QWidget *parent, const QString &text, const QString &details, const QString &title, const KGuiItem &buttonOk, KMessageBox::Options options = Notify)

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

parent Parent widget.

text Message string.

details Detailed message string.

title Message box title. The application name is added to the title. The default title is i18n("Error").

buttonOk The text for the only button. The default is KStandardGuiItem::ok().

options see 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.

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

This function was introduced in 5.97.

void KMessageBox::detailedErrorWId(WId parent_id, const QString &text, const QString &details, const QString &title = QString(), KMessageBox::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.97] void KMessageBox::detailedErrorWId(WId parent_id, const QString &text, const QString &details, const QString &title, const KGuiItem &buttonOk, KMessageBox::Options options = Notify)

This function accepts the window id of the parent window, instead of QWidget*. It should be used only when necessary.

This function was introduced in 5.97.

void KMessageBox::enableAllMessages()

Enable all messages which have been turned off with the

dontShowAgainName feature.

void KMessageBox::enableMessage(const QString &dontShowAgainName)

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

See also saveDontShowAgainTwoActions() and saveDontShowAgainContinue().

void KMessageBox::error(QWidget *parent, const QString &text, const QString &title = QString(), KMessageBox::Options options = Notify)

Display an "Error" dialog.

parent Parent widget.

text Message string.

title Message box title. The application name is added to the title. The default title is i18n("Error").

options see 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 default button is "&OK". Pressing "Esc" selects the OK-button.

[since 5.97] void KMessageBox::error(QWidget *parent, const QString &text, const QString &title, const KGuiItem &buttonOk, KMessageBox::Options options = Notify)

Display an "Error" dialog.

parent Parent widget.

text Message string.

title Message box title. The application name is added to the title. The default title is i18n("Error").

buttonOk The text for the only button. The default is KStandardGuiItem::ok().

options see Options

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

This function was introduced in 5.97.

void KMessageBox::errorList(QWidget *parent, const QString &text, const QStringList &strlist, const QString &title = QString(), KMessageBox::Options options = Notify)

Display an "Error" dialog with a listbox.

parent Parent widget.

text Message string.

strlist List of strings to be written in the listbox. If the list is empty, it doesn't show any listbox, working as error().

title Message box title. The application name is added to the title. The default title is i18n("Error").

options see 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 default button is "&OK". Pressing "Esc" selects the OK-button.

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

This function accepts the window id of the parent window, instead of QWidget*. It should be used only when necessary.

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

This function accepts the window id of the parent window, instead of QWidget*. It should be used only when necessary.

void KMessageBox::information(QWidget *parent, const QString &text, const QString &title = QString(), const QString &dontShowAgainName = QString(), KMessageBox::Options options = Notify)

Display an "Information" dialog.

parent Parent widget.

text Message string.

title Message box title. The application name is added to the title. The default title is i18n("Information").

dontShowAgainName If 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.

options see 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.

void KMessageBox::informationList(QWidget *parent, const QString &text, const QStringList &strlist, const QString &title = QString(), const QString &dontShowAgainName = QString(), KMessageBox::Options options = Notify)

Display an "Information" dialog with a listbox.

parent Parent widget.

text Message string.

strlist List of strings to be written in the listbox. If the list is empty, it doesn't show any listbox, working as information.

title Message box title. The application name is added to the title. The default title is i18n("Information").

dontShowAgainName If 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.

options see 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.

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

This function accepts the window id of the parent window, instead of QWidget*. It should be used only when necessary.

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

This function accepts the window id of the parent window, instead of QWidget*. It should be used only when necessary.

KMessageBox::ButtonCode KMessageBox::messageBox(QWidget *parent, KMessageBox::DialogType type, const QString &text, const QString &title, const KGuiItem &primaryAction, const KGuiItem &secondaryAction, const KGuiItem &cancelAction = KStandardGuiItem::cancel(), const QString &dontShowAskAgainName = QString(), KMessageBox::Options options = Notify)

Alternate method to show a messagebox:

parent Parent widget.

type type of message box: QuestionTwoActions, WarningTwoActions, WarningContinueCancel...

text Message string.

title Message box title.

primaryAction The KGuiItem for the first button.

secondaryAction The KGuiItem for the second button.

cancelAction The text for the third button. The default is KStandardGuiItem::cancel().

dontShowAskAgainName If 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 PrimaryAction or SecondaryAction), if the message box needs an answer. The string is used to lookup and store the setting in the applications config file.

options see Options

Note: for ContinueCancel, primaryAction is the continue button and secondaryAction is unused. and for Information, none is used.

Returns a button code, as defined in KMessageBox.

KMessageBox::ButtonCode KMessageBox::messageBoxWId(WId parent_id, KMessageBox::DialogType type, const QString &text, const QString &title, const KGuiItem &primaryAction, const KGuiItem &secondaryAction, const KGuiItem &cancelAction = KStandardGuiItem::cancel(), const QString &dontShowAskAgainName = QString(), KMessageBox::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.100] KMessageBox::ButtonCode KMessageBox::questionTwoActions(QWidget *parent, const QString &text, const QString &title, const KGuiItem &primaryAction, const KGuiItem &secondaryAction, const QString &dontAskAgainName = QString(), KMessageBox::Options options = Notify)

Display a "question" dialog with two action buttons.

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

The default button is the primary button. Pressing "Esc" triggers the secondary button.

parent the parent widget

text the message string

title the message box title. If an empty string, defaults to i18n("Question").

primaryAction the action for the primary button

secondaryAction the action for the secondary button

dontAskAgainName If not an empty string, 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.

options see Option

Returns PrimaryAction if the primary button is triggered, SecondaryAction if the secondary button is triggered.

This function was introduced in 5.100.

[since 5.100] KMessageBox::ButtonCode KMessageBox::questionTwoActionsCancel(QWidget *parent, const QString &text, const QString &title, const KGuiItem &primaryAction, const KGuiItem &secondaryAction, const KGuiItem &cancelAction = KStandardGuiItem::cancel(), const QString &dontAskAgainName = QString(), KMessageBox::Options options = Notify)

Display a "question" dialog with two action buttons and a cancel button.

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

The default button is the primary button. Pressing "Esc" triggers the cancel button.

parent the parent widget

text the message string

title the message box title. If an empty string, defaults to i18n("Question").

primaryAction the action for the primary button

secondaryAction the action for the secondary button

cancelAction the action for the cancel button

dontAskAgainName If not an empty string, 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.

options see Option

Returns PrimaryAction if the primary button is triggered, SecondaryAction if the secondary button is triggered. Cancel if the cancel button is triggered.

This function was introduced in 5.100.

[since 5.100] KMessageBox::ButtonCode KMessageBox::questionTwoActionsCancelWId(WId parent_id, const QString &text, const QString &title, const KGuiItem &primaryAction, const KGuiItem &secondaryAction, const KGuiItem &cancelAction = KStandardGuiItem::cancel(), const QString &dontAskAgainName = QString(), KMessageBox::Options options = Notify)

This function accepts the window id of the parent window, instead of QWidget*. It should be used only when necessary.

This function was introduced in 5.100.

See also questionTwoActionsCancel().

[since 5.100] KMessageBox::ButtonCode KMessageBox::questionTwoActionsList(QWidget *parent, const QString &text, const QStringList &strlist, const QString &title, const KGuiItem &primaryAction, const KGuiItem &secondaryAction, const QString &dontAskAgainName = QString(), KMessageBox::Options options = Notify)

Display a "question" dialog with a listbox to show information to the user and two action buttons.

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.

The default button is the primary button. Pressing "Esc" triggers the secondary button.

parent the parent widget

text the message string

strlist List of strings to be written in the listbox. If the list is empty, it doesn't show any listbox, working as questionTwoActions().

title the message box title. If an empty string, defaults to i18n("Question").

primaryAction the action for the primary button

secondaryAction the action for the secondary button

dontAskAgainName If not an empty string, 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. options see Option

Returns PrimaryAction if the primary button is triggered, SecondaryAction if the secondary button is triggered.

This function was introduced in 5.100.

[since 5.100] KMessageBox::ButtonCode KMessageBox::questionTwoActionsListWId(WId parent_id, const QString &text, const QStringList &strlist, const QString &title, const KGuiItem &primaryAction, const KGuiItem &secondaryAction, const QString &dontAskAgainName = QString(), KMessageBox::Options options = Notify)

This function accepts the window id of the parent window, instead of QWidget*. It should be used only when necessary.

This function was introduced in 5.100.

See also questionTwoActionsList().

[since 5.100] KMessageBox::ButtonCode KMessageBox::questionTwoActionsWId(WId parent_id, const QString &text, const QString &title, const KGuiItem &primaryAction, const KGuiItem &secondaryAction, const QString &dontAskAgainName = QString(), KMessageBox::Options options = Notify)

This function accepts the window id of the parent window, instead of QWidget*. It should be used only when necessary.

This function was introduced in 5.100.

See also questionTwoActions().

void KMessageBox::saveDontShowAgainContinue(const QString &dontShowAgainName)

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

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

[since 5.100] void KMessageBox::saveDontShowAgainTwoActions(const QString &dontShowAgainName, KMessageBox::ButtonCode result)

Save the fact that a two actions message box should not be shown again.

dontShowAgainName the name that identifies the message box. If empty, this method does nothing.

result the value (PrimaryAction or SecondaryAction) that should be used as the result for the message box.

This function was introduced in 5.100.

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.

[since 5.0] void KMessageBox::setDontShowAgainInterface(KMessageBoxDontAskAgainInterface *dontAskAgainInterface)

Use dontAskAgainInterface for all settings related to the dontShowAgain feature.

This method does not take ownership of dontAskAgainInterface.

This function was introduced in 5.0.

[since 5.0] void KMessageBox::setNotifyInterface(KMessageBoxNotifyInterface *notifyInterface)

Use notifyInterface to send notifications.

This method does not take ownership of notifyInterface.

This function was introduced in 5.0.

bool KMessageBox::shouldBeShownContinue(const QString &dontShowAgainName)

Returns true if the corresponding continue/cancel message box should be shown.

dontShowAgainName the name that identify the message box. If empty, true is always returned.

[since 5.100] bool KMessageBox::shouldBeShownTwoActions(const QString &dontShowAgainName, KMessageBox::ButtonCode &result)

dontShowAgainName the name that identifies the message box. If empty, true is always returned.

result reference to a variable to be set to the choice (PrimaryAction or SecondaryAction) that was chosen the last time the message box was shown. Only meaningful if the message box should not be shown.

Returns true if the corresponding two actions message box should be shown, false otherwise.

This function was introduced in 5.100.

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

Display a "warning" dialog.

parent Parent widget.

text Message string.

title Message box title. The application name is added to the title. The default title is i18n("Warning").

buttonContinue The text for the first button. The default is KStandardGuiItem::cont().

buttonCancel The text for the second button. The default is KStandardGuiItem::cancel().

dontAskAgainName If 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.

options see Options

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".

[since 5.61] KMessageBox::ButtonCode KMessageBox::warningContinueCancelDetailed(QWidget *parent, const QString &text, const QString &title = QString(), const KGuiItem &buttonContinue = KStandardGuiItem::cont(), const KGuiItem &buttonCancel = KStandardGuiItem::cancel(), const QString &dontAskAgainName = QString(), KMessageBox::Options options = Notify, const QString &details = QString())

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

This function was introduced in 5.61.

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

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

parent Parent widget.

text Message string.

strlist List of strings to be written in the listbox. If the list is empty, it doesn't show any listbox, working as warningContinueCancel.

title Message box title. The application name is added to the title. The default title is i18n("Warning").

buttonContinue The text for the first button. The default is KStandardGuiItem::cont().

buttonCancel The text for the second button. The default is KStandardGuiItem::cancel().

dontAskAgainName If 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.

options see Options

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".

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

This function accepts the window id of the parent window, instead of QWidget*. It should be used only when necessary.

KMessageBox::ButtonCode KMessageBox::warningContinueCancelWId(WId parent_id, const QString &text, const QString &title = QString(), const KGuiItem &buttonContinue = KStandardGuiItem::cont(), const KGuiItem &buttonCancel = KStandardGuiItem::cancel(), const QString &dontAskAgainName = QString(), KMessageBox::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.100] KMessageBox::ButtonCode KMessageBox::warningTwoActions(QWidget *parent, const QString &text, const QString &title, const KGuiItem &primaryAction, const KGuiItem &secondaryAction, const QString &dontAskAgainName = QString(), KMessageBox::Options options = Options(Notify | Dangerous))

Display a "warning" dialog with two action buttons.

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

The default button is the secondary button. Pressing "Esc" triggers the secondary button.

parent the parent widget

text the message string

title the message box title. If an empty string, defaults to i18n("Warning").

primaryAction the action for the primary button

secondaryAction the action for the secondary button

dontAskAgainName If not an empty string, 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.

options see Options

Returns PrimaryAction if the primary button is triggered, SecondaryAction if the secondary button is triggered.

This function was introduced in 5.100.

[since 5.100] KMessageBox::ButtonCode KMessageBox::warningTwoActionsCancel(QWidget *parent, const QString &text, const QString &title, const KGuiItem &primaryAction, const KGuiItem &secondaryAction, const KGuiItem &cancelAction = KStandardGuiItem::cancel(), const QString &dontAskAgainName = QString(), KMessageBox::Options options = Options(Notify | Dangerous))

Display a "warning" dialog with two action buttons and a cancel button.

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

The default button is the cancel button. Pressing "Esc" triggers the cancel button.

parent the parent widget

text the message string

title the message box title. If an empty string, defaults to i18n("Warning").

primaryAction the action for the primary button

secondaryAction the action for the secondary button

cancelAction the action for the cancel button

dontAskAgainName If not an empty string, 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.

options see Options

Returns PrimaryAction if the primary button is triggered, SecondaryAction if the secondary button is triggered. Cancel if the cancel button is triggered.

This function was introduced in 5.100.

[since 5.100] KMessageBox::ButtonCode KMessageBox::warningTwoActionsCancelList(QWidget *parent, const QString &text, const QStringList &strlist, const QString &title, const KGuiItem &primaryAction, const KGuiItem &secondaryAction, const KGuiItem &cancelAction = KStandardGuiItem::cancel(), const QString &dontAskAgainName = QString(), KMessageBox::Options options = Options(Notify | Dangerous))

Display a "warning" dialog with a listbox to show information to the user, two action buttons and a cancel button.

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

The default button is the cancel button. Pressing "Esc" triggers the cancel button.

parent the parent widget

text the message string

strlist a List of strings to be written in the listbox. If the list is empty, it doesn't show any listbox, working as warningTwoActionsCancel().

title the message box title. If an empty string, defaults to i18n("Warning").

primaryAction the action for the primary button

secondaryAction the action for the secondary button

cancelAction the action for the cancel button

dontAskAgainName If not an empty string, 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.

options see Options

Returns PrimaryAction if the primary button is triggered, SecondaryAction if the secondary button is triggered. Cancel if the cancel button is triggered.

This function was introduced in 5.100.

[since 5.100] KMessageBox::ButtonCode KMessageBox::warningTwoActionsCancelListWId(WId parent_id, const QString &text, const QStringList &strlist, const QString &title, const KGuiItem &primaryAction, const KGuiItem &secondaryAction, const KGuiItem &cancelAction = KStandardGuiItem::cancel(), const QString &dontAskAgainName = QString(), KMessageBox::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.

This function was introduced in 5.100.

See also warningTwoActionsCancelList().

[since 5.100] KMessageBox::ButtonCode KMessageBox::warningTwoActionsCancelWId(WId parent_id, const QString &text, const QString &title, const KGuiItem &primaryAction, const KGuiItem &secondaryAction, const KGuiItem &cancelAction = KStandardGuiItem::cancel(), const QString &dontAskAgainName = QString(), KMessageBox::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.

This function was introduced in 5.100.

See also warningTwoActionsCancel().

[since 5.100] KMessageBox::ButtonCode KMessageBox::warningTwoActionsList(QWidget *parent, const QString &text, const QStringList &strlist, const QString &title, const KGuiItem &primaryAction, const KGuiItem &secondaryAction, const QString &dontAskAgainName = QString(), KMessageBox::Options options = Options(Notify | Dangerous))

Display a "warning" dialog with a listbox to show information to the user and two action buttons.

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

The default button is the secondary button. Pressing "Esc" triggers the secondary button.

parent the parent widget

text the message string

strlist List of strings to be written in the listbox. If the list is empty, it doesn't show any listbox, working as warningTwoActions.

title the message box title. If an empty string, defaults to i18n("Warning").

primaryAction the action for the primary button

secondaryAction the action for the secondary button

dontAskAgainName If not an empty string, 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.

options see Options

Returns PrimaryAction if the primary button is triggered, SecondaryAction if the secondary button is triggered.

This function was introduced in 5.100.

[since 5.100] KMessageBox::ButtonCode KMessageBox::warningTwoActionsListWId(WId parent_id, const QString &text, const QStringList &strlist, const QString &title, const KGuiItem &primaryAction, const KGuiItem &secondaryAction, const QString &dontAskAgainName = QString(), KMessageBox::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.

This function was introduced in 5.100.

See also warningTwoActionsList().

[since 5.100] KMessageBox::ButtonCode KMessageBox::warningTwoActionsWId(WId parent_id, const QString &text, const QString &title, const KGuiItem &primaryAction, const KGuiItem &secondaryAction, const QString &dontAskAgainName = QString(), KMessageBox::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.

This function was introduced in 5.100.

See also warningTwoActions().