KMessageBox Class Reference

`#include <kmessagebox.h>`

## Public Types

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 | OptionsType { Notify = 1, AllowLink = 2, Dangerous = 4, PlainCaption = 8, NoExec = 16 }

## Static Public Member Functions

static int | questionYesNo (QWidget *parent, const QString &text, const QString &caption=QString::null, const KGuiItem &buttonYes=KStdGuiItem::yes(), const KGuiItem &buttonNo=KStdGuiItem::no(), const QString &dontAskAgainName=QString::null, int options=Notify)
static int | questionYesNoWId (WId parent_id, const QString &text, const QString &caption=QString::null, const KGuiItem &buttonYes=KStdGuiItem::yes(), const KGuiItem &buttonNo=KStdGuiItem::no(), const QString &dontAskAgainName=QString::null, int options=Notify)
static int | questionYesNoCancel (QWidget *parent, const QString &text, const QString &caption=QString::null, const KGuiItem &buttonYes=KStdGuiItem::yes(), const KGuiItem &buttonNo=KStdGuiItem::no(), const QString &dontAskAgainName=QString::null, int options=Notify)
static int | questionYesNoCancelWId (WId parent_id, const QString &text, const QString &caption=QString::null, const KGuiItem &buttonYes=KStdGuiItem::yes(), const KGuiItem &buttonNo=KStdGuiItem::no(), const QString &dontAskAgainName=QString::null, int options=Notify)
static int | questionYesNoList (QWidget *parent, const QString &text, const QStringList &strlist, const QString &caption=QString::null, const KGuiItem &buttonYes=KStdGuiItem::yes(), const KGuiItem &buttonNo=KStdGuiItem::no(), const QString &dontAskAgainName=QString::null, int options=Notify)
static int | questionYesNoListWId (WId parent_id, const QString &text, const QStringList &strlist, const QString &caption=QString::null, const KGuiItem &buttonYes=KStdGuiItem::yes(), const KGuiItem &buttonNo=KStdGuiItem::no(), const QString &dontAskAgainName=QString::null, int options=Notify)
static int | warningYesNo (QWidget *parent, const QString &text, const QString &caption=QString::null, const KGuiItem &buttonYes=KStdGuiItem::yes(), const KGuiItem &buttonNo=KStdGuiItem::no(), const QString &dontAskAgainName=QString::null, int options=Notify|Dangerous)
static int | warningYesNoWId (WId parent_id, const QString &text, const QString &caption=QString::null, const KGuiItem &buttonYes=KStdGuiItem::yes(), const KGuiItem &buttonNo=KStdGuiItem::no(), const QString &dontAskAgainName=QString::null, int options=Notify|Dangerous)
static int | warningYesNoList (QWidget *parent, const QString &text, const QStringList &strlist, const QString &caption=QString::null, const KGuiItem &buttonYes=KStdGuiItem::yes(), const KGuiItem &buttonNo=KStdGuiItem::no(), const QString &dontAskAgainName=QString::null, int options=Notify|Dangerous)
static int | warningYesNoListWId (WId parent_id, const QString &text, const QStringList &strlist, const QString &caption=QString::null, const KGuiItem &buttonYes=KStdGuiItem::yes(), const KGuiItem &buttonNo=KStdGuiItem::no(), const QString &dontAskAgainName=QString::null, int options=Notify|Dangerous)
static int | warningContinueCancel (QWidget *parent, const QString &text, const QString &caption=QString::null, const KGuiItem &buttonContinue=KStdGuiItem::cont(), const QString &dontAskAgainName=QString::null, int options=Notify)
static int | warningContinueCancelWId (WId parent_id, const QString &text, const QString &caption=QString::null, const KGuiItem &buttonContinue=KStdGuiItem::cont(), const QString &dontAskAgainName=QString::null, int options=Notify)
static int | warningContinueCancelList (QWidget *parent, const QString &text, const QStringList &strlist, const QString &caption=QString::null, const KGuiItem &buttonContinue=KStdGuiItem::cont(), const QString &dontAskAgainName=QString::null, int options=Notify)
static int | warningContinueCancelListWId (WId parent_id, const QString &text, const QStringList &strlist, const QString &caption=QString::null, const KGuiItem &buttonContinue=KStdGuiItem::cont(), const QString &dontAskAgainName=QString::null, int options=Notify)
static int | warningYesNoCancel (QWidget *parent, const QString &text, const QString &caption=QString::null, const KGuiItem &buttonYes=KStdGuiItem::yes(), const KGuiItem &buttonNo=KStdGuiItem::no(), const QString &dontAskAgainName=QString::null, int options=Notify)
static int | warningYesNoCancelWId (WId parent_id, const QString &text, const QString &caption=QString::null, const KGuiItem &buttonYes=KStdGuiItem::yes(), const KGuiItem &buttonNo=KStdGuiItem::no(), const QString &dontAskAgainName=QString::null, int options=Notify)
static int | warningYesNoCancelList (QWidget *parent, const QString &text, const QStringList &strlist, const QString &caption=QString::null, const KGuiItem &buttonYes=KStdGuiItem::yes(), const KGuiItem &buttonNo=KStdGuiItem::no(), const QString &dontAskAgainName=QString::null, int options=Notify)
static int | warningYesNoCancelListWId (WId parent_id, const QString &text, const QStringList &strlist, const QString &caption=QString::null, const KGuiItem &buttonYes=KStdGuiItem::yes(), const KGuiItem &buttonNo=KStdGuiItem::no(), const QString &dontAskAgainName=QString::null, int options=Notify)
static void | error (QWidget *parent, const QString &text, const QString &caption=QString::null, int options=Notify)
static void | errorWId (WId parent_id, const QString &text, const QString &caption=QString::null, int options=Notify)
static void | errorList (QWidget *parent, const QString &text, const QStringList &strlist, const QString &caption=QString::null, int options=Notify)
static void | errorListWId (WId parent_id, const QString &text, const QStringList &strlist, const QString &caption=QString::null, int options=Notify)
static void | detailedError (QWidget *parent, const QString &text, const QString &details, const QString &caption=QString::null, int options=Notify)
static void | detailedErrorWId (WId parent_id, const QString &text, const QString &details, const QString &caption=QString::null, int options=Notify)
static void | queuedDetailedError (QWidget *parent, const QString &text, const QString &details, const QString &caption=QString::null)
static void | queuedDetailedErrorWId (WId parent_id, const QString &text, const QString &details, const QString &caption=QString::null)
static void | sorry (QWidget *parent, const QString &text, const QString &caption=QString::null, int options=Notify)
static void | sorryWId (WId parent_id, const QString &text, const QString &caption=QString::null, int options=Notify)
static void | detailedSorry (QWidget *parent, const QString &text, const QString &details, const QString &caption=QString::null, int options=Notify)
static void | detailedSorryWId (WId parent_id, const QString &text, const QString &details, const QString &caption=QString::null, int options=Notify)
static void | information (QWidget *parent, const QString &text, const QString &caption=QString::null, const QString &dontShowAgainName=QString::null, int options=Notify)
static void | informationWId (WId parent_id, const QString &text, const QString &caption=QString::null, const QString &dontShowAgainName=QString::null, int options=Notify)
static void | informationList (QWidget *parent, const QString &text, const QStringList &strlist, const QString &caption=QString::null, const QString &dontShowAgainName=QString::null, int options=Notify)
static void | informationListWId (WId parent_id, const QString &text, const QStringList &strlist, const QString &caption=QString::null, const QString &dontShowAgainName=QString::null, int options=Notify)
static void | enableAllMessages ()
static void | enableMessage (const QString &dontShowAgainName)
static void | about (QWidget *parent, const QString &text, const QString &caption=QString::null, int options=Notify)
static int | messageBox (QWidget *parent, DialogType type, const QString &text, const QString &caption, const KGuiItem &buttonYes, const KGuiItem &buttonNo, const QString &dontShowAskAgainName, int options=Notify)
static int | messageBox (QWidget *parent, DialogType type, const QString &text, const QString &caption=QString::null, const KGuiItem &buttonYes=KStdGuiItem::yes(), const KGuiItem &buttonNo=KStdGuiItem::no(), int options=Notify)
static int | messageBoxWId (WId parent_id, DialogType type, const QString &text, const QString &caption=QString::null, const KGuiItem &buttonYes=KStdGuiItem::yes(), const KGuiItem &buttonNo=KStdGuiItem::no(), const QString &dontShowAskAgainName=QString::null, int options=Notify)
static void | queuedMessageBox (QWidget *parent, DialogType type, const QString &text, const QString &caption, int options)
static void | queuedMessageBoxWId (WId parent_id, DialogType type, const QString &text, const QString &caption, int options)
static void | queuedMessageBox (QWidget *parent, DialogType type, const QString &text, const QString &caption=QString::null)
static void | queuedMessageBoxWId (WId parent_id, DialogType type, const QString &text, const QString &caption=QString::null)
static bool | shouldBeShownYesNo (const QString &dontShowAgainName, ButtonCode &result)
static bool | shouldBeShownContinue (const QString &dontShowAgainName)
static void | saveDontShowAgainYesNo (const QString &dontShowAgainName, ButtonCode result)
static void | saveDontShowAgainContinue (const QString &dontShowAgainName)
static void | setDontShowAskAgainConfig (KConfig *cfg)
static int | createKMessageBox (KDialogBase *dialog, QMessageBox::Icon icon, const QString &text, const QStringList &strlist, const QString &ask, bool *checkboxReturn, int options, const QString &details=QString::null)
static int | createKMessageBox (KDialogBase *dialog, QPixmap icon, const QString &text, const QStringList &strlist, const QString &ask, bool *checkboxReturn, int options, const QString &details=QString::null, QMessageBox::Icon notifyType=QMessageBox::Information)

## Detailed Description

Easy message dialog box.

Provides convenience functions for some i18n'ed standard dialogs.

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.

Author
  Waldo Bastian (basti.nosp@m.an@k.nosp@m.de.or.nosp@m.g)

Definition at line 44 of file kmessagebox.h.

## Member Enumeration Documentation

enum KMessageBox::ButtonCode

Button types.

Definition at line 50 of file kmessagebox.h.

enum KMessageBox::OptionsType

Enumerator
Notify | Emit a KNotifyClient event.
AllowLink | The message may contain links.
Dangerous | The action to be confirmed by the dialog is a potentially destructive one.

PlainCaption

Do not use KApplication::makeStdCaption()

Since
  3.4

NoExec

Do not call exec() in createKMessageBox()

Since
  3.4

Definition at line 72 of file kmessagebox.h.

## Member Function Documentation

void KMessageBox::about | ( | QWidget * | parent,
|  | const QString & | text,
|  | const QString & | caption = `QString::null`,
|  | int | options = `Notify`
| ) |  |

static

Display an "About" dialog.

Parameters

  parent | If `parent` is 0, then the message box becomes an application-global modal dialog box. If `parent` is a widget, the message box becomes modal relative to parent.
  text | Message string.
  caption | Message box title. The application name is added to the title. The default title is i18n("About \<appname\>").
  options | see OptionsType

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 970 of file kmessagebox.cpp.

int KMessageBox::createKMessageBox | ( | KDialogBase * | dialog,
|  | QMessageBox::Icon | icon,
|  | const QString & | text,
|  | const QStringList & | strlist,
|  | const QString & | ask,
|  | bool * | checkboxReturn,
|  | int | options,
|  | const QString & | details = `QString::null`
| ) |  |

static

Create content and layout of a standard dialog.

Parameters

  dialog | The parent dialog base
  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.
  options | see OptionsType
  details | Detailed message string.

Since
  3.3

Returns
  A KDialogBase button code, not a KMessageBox button code, based on the buttonmask given to the constructor of the `dialog` (ie. will return KDialogBase::Yes [256] instead of KMessageBox::Yes [3]). Will return KMessageBox::Cancel if the message box is queued for display instead of exec()ed immediately or if the option NoExec is set.

Note
  The `dialog` that is passed in is deleted by this function. Do not delete it yourself.

Definition at line 140 of file kmessagebox.cpp.

int KMessageBox::createKMessageBox | ( | KDialogBase * | dialog,
|  | QPixmap | icon,
|  | const QString & | text,
|  | const QStringList & | strlist,
|  | const QString & | ask,
|  | bool * | checkboxReturn,
|  | int | options,
|  | const QString & | details = `QString::null`,
|  | QMessageBox::Icon | notifyType = `QMessageBox::Information`
| ) |  |

static

Create content and layout of a standard dialog.

Parameters

  dialog | The parent dialog base
  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.
  options | see OptionsType
  details | Detailed message string.
  notifyType | The type of notification to send when this message is presentend.

Since
  3.3

Returns
  A KDialogBase button code, not a KMessageBox button code, based on the buttonmask given to the constructor of the `dialog` (ie. will return KDialogBase::Yes [256] instead of KMessageBox::Yes [3]). Will return KMessageBox::Cancel if the message box is queued for display instead of exec()ed immediately or if the option NoExec is set.

Note
  The `dialog` that is passed in is deleted by this function. Do not delete it yourself.

Definition at line 149 of file kmessagebox.cpp.

void KMessageBox::detailedError | ( | QWidget * | parent,
|  | const QString & | text,
|  | const QString & | details,
|  | const QString & | caption = `QString::null`,
|  | int | options = `Notify`
| ) |  |

static

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

Parameters

  parent | If `parent` is 0, then the message box becomes an application-global modal dialog box. If `parent` is a widget, the message box becomes modal relative to parent.
  text | Message string.
  details | Detailed message string.
  caption | Message box title. The application name is added to the title. The default title is i18n("Error").
  options | see OptionsType

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 conatin 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 776 of file kmessagebox.cpp.

void KMessageBox::detailedErrorWId | ( | WId | parent_id,
|  | const QString & | text,
|  | const QString & | details,
|  | const QString & | caption = `QString::null`,
|  | int | options = `Notify`
| ) |  |

static

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

It should be used only when necessary.

Since
  3.2

Definition at line 784 of file kmessagebox.cpp.

void KMessageBox::detailedSorry | ( | QWidget * | parent,
|  | const QString & | text,
|  | const QString & | details,
|  | const QString & | caption = `QString::null`,
|  | int | options = `Notify`
| ) |  |

static

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

Parameters

  parent | If `parent` is 0, then the message box becomes an application-global modal dialog box. If `parent` is a widget, the message box becomes modal relative to parent.
  text | Message string.
  details | Detailed message string.
  caption | Message box title. The application name is added to the title. The default title is i18n("Sorry").
  options | see 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."

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

Definition at line 853 of file kmessagebox.cpp.

void KMessageBox::detailedSorryWId | ( | WId | parent_id,
|  | const QString & | text,
|  | const QString & | details,
|  | const QString & | caption = `QString::null`,
|  | int | options = `Notify`
| ) |  |

static

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

It should be used only when necessary.

Since
  3.2

Definition at line 861 of file kmessagebox.cpp.

void KMessageBox::enableAllMessages | ( |  | ) |

static

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

Definition at line 936 of file kmessagebox.cpp.

void KMessageBox::enableMessage | ( | const QString & | dontShowAgainName | ) |

static

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

See also
  saveDontShowAgainYesNo()
  saveDontShowAgainContinue()

Since
  3.2

Definition at line 956 of file kmessagebox.cpp.

void KMessageBox::error | ( | QWidget * | parent,
|  | const QString & | text,
|  | const QString & | caption = `QString::null`,
|  | int | options = `Notify`
| ) |  |

static

Display an "Error" dialog.

Parameters

  parent | If `parent` is 0, then the message box becomes an application-global modal dialog box. If `parent` is a widget, the message box becomes modal relative to parent.
  text | Message string.
  caption | Message box title. The application name is added to the title. The default title is i18n("Error").
  options | see OptionsType

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 734 of file kmessagebox.cpp.

void KMessageBox::errorList | ( | QWidget * | parent,
|  | const QString & | text,
|  | const QStringList & | strlist,
|  | const QString & | caption = `QString::null`,
|  | int | options = `Notify`
| ) |  |

static

Display an "Error" dialog with a listbox.

Parameters

  parent | If `parent` is 0, then the message box becomes an application-global modal dialog box. If `parent` is a widget, the message box becomes modal relative to parent.
  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().
  caption | Message box title. The application name is added to the title. The default title is i18n("Error").
  options | see OptionsType

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

Since
  3.4

Definition at line 748 of file kmessagebox.cpp.

void KMessageBox::errorListWId | ( | WId | parent_id,
|  | const QString & | text,
|  | const QStringList & | strlist,
|  | const QString & | caption = `QString::null`,
|  | int | options = `Notify`
| ) |  |

static

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

It should be used only when necessary.

Since
  3.4

Definition at line 755 of file kmessagebox.cpp.

void KMessageBox::errorWId | ( | WId | parent_id,
|  | const QString & | text,
|  | const QString & | caption = `QString::null`,
|  | int | options = `Notify`
| ) |  |

static

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

It should be used only when necessary.

Since
  3.2

Definition at line 741 of file kmessagebox.cpp.

void KMessageBox::information | ( | QWidget * | parent,
|  | const QString & | text,
|  | const QString & | caption = `QString::null`,
|  | const QString & | dontShowAgainName = `QString::null`,
|  | int | options = `Notify`
| ) |  |

static

Display an "Information" dialog.

Parameters

  parent | If `parent` is 0, then the message box becomes an application-global modal dialog box. If `parent` is a widget, the message box becomes modal relative to parent.
  text | Message string.
  caption | 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 OptionsType

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 883 of file kmessagebox.cpp.

void KMessageBox::informationList | ( | QWidget * | parent,
|  | const QString & | text,
|  | const QStringList & | strlist,
|  | const QString & | caption = `QString::null`,
|  | const QString & | dontShowAgainName = `QString::null`,
|  | int | options = `Notify`
| ) |  |

static

Display an "Information" dialog with a listbox.

Parameters

  parent | If `parent` is 0, then the message box becomes an application-global modal dialog box. If `parent` is a widget, the message box becomes modal relative to parent.
  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.
  caption | 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 OptionsType

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

Since
  3.1

Definition at line 897 of file kmessagebox.cpp.

void KMessageBox::informationListWId | ( | WId | parent_id,
|  | const QString & | text,
|  | const QStringList & | strlist,
|  | const QString & | caption = `QString::null`,
|  | const QString & | dontShowAgainName = `QString::null`,
|  | int | options = `Notify`
| ) |  |

static

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

It should be used only when necessary.

Since
  3.2

Definition at line 905 of file kmessagebox.cpp.

void KMessageBox::informationWId | ( | WId | parent_id,
|  | const QString & | text,
|  | const QString & | caption = `QString::null`,
|  | const QString & | dontShowAgainName = `QString::null`,
|  | int | options = `Notify`
| ) |  |

static

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

It should be used only when necessary.

Since
  3.2

Definition at line 890 of file kmessagebox.cpp.

int KMessageBox::messageBox | ( | QWidget * | parent,
|  | DialogType | type,
|  | const QString & | text,
|  | const QString & | caption,
|  | const KGuiItem & | buttonYes,
|  | const KGuiItem & | buttonNo,
|  | const QString & | dontShowAskAgainName,
|  | int | options = `Notify`
| ) |  |

static

Alternate method to show a messagebox:

Parameters

  parent | If `parent` is 0, then the message box becomes an application-global modal dialog box. If `parent` is a widget, the message box becomes modal relative to parent.
  type | type of message box: QuestionYesNo, WarningYesNo, WarningContinueCancel...
  text | Message string.
  caption | Message box title.
  buttonYes | The text for the first button. The default is i18n("&Yes").
  buttonNo | The text for the second button. The default is i18n("&No").
  dontShowAskAgainName | If provided, a checkbox is added with which further questions/informations 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.
  options | see OptionsType 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.

int KMessageBox::messageBox | ( | QWidget * | parent,
|  | DialogType | type,
|  | const QString & | text,
|  | const QString & | caption = `QString::null`,
|  | const KGuiItem & | buttonYes = `KStdGuiItem::yes()`,
|  | const KGuiItem & | buttonNo = `KStdGuiItem::no()`,
|  | int | options = `Notify`
| ) |  |

static

Alternate method to show a messagebox:

Parameters

  parent | If `parent` is 0, then the message box becomes an application-global modal dialog box. If `parent` is a widget, the message box becomes modal relative to parent.
  type | type of message box: QuestionYesNo, WarningYesNo, WarningContinueCancel...
  text | Message string.
  caption | Message box title.
  buttonYes | The text for the first button. The default is i18n("&Yes").
  buttonNo | The text for the second button. The default is i18n("&No").
  options | see OptionsType 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 1003 of file kmessagebox.cpp.

int KMessageBox::messageBoxWId | ( | WId | parent_id,
|  | DialogType | type,
|  | const QString & | text,
|  | const QString & | caption = `QString::null`,
|  | const KGuiItem & | buttonYes = `KStdGuiItem::yes()`,
|  | const KGuiItem & | buttonNo = `KStdGuiItem::no()`,
|  | const QString & | dontShowAskAgainName = `QString::null`,
|  | int | options = `Notify`
| ) |  |

static

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

It should be used only when necessary.

Since
  3.2

Definition at line 1011 of file kmessagebox.cpp.

int KMessageBox::questionYesNo | ( | QWidget * | parent,
|  | const QString & | text,
|  | const QString & | caption = `QString::null`,
|  | const KGuiItem & | buttonYes = `KStdGuiItem::yes()`,
|  | const KGuiItem & | buttonNo = `KStdGuiItem::no()`,
|  | const QString & | dontAskAgainName = `QString::null`,
|  | int | options = `Notify`
| ) |  |

static

Display a simple "question" dialog.

Parameters

  parent | If `parent` is 0, then the message box becomes an application-global modal dialog box. If `parent` is a widget, the message box becomes modal relative to parent.
  text | Message string.
  caption | Message box title. The application name is added to the title. The default title is i18n("Question").
  buttonYes | The text for the first button. The default is i18n("&Yes").
  buttonNo | The text for the second button. The default is i18n("&No").
  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 OptionsType

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 317 of file kmessagebox.cpp.

int KMessageBox::questionYesNoCancel | ( | QWidget * | parent,
|  | const QString & | text,
|  | const QString & | caption = `QString::null`,
|  | const KGuiItem & | buttonYes = `KStdGuiItem::yes()`,
|  | const KGuiItem & | buttonNo = `KStdGuiItem::no()`,
|  | const QString & | dontAskAgainName = `QString::null`,
|  | int | options = `Notify`
| ) |  |

static

Display a simple "question" dialog.

Parameters

  parent | If `parent` is 0, then the message box becomes an application-global modal dialog box. If `parent` is a widget, the message box becomes modal relative to parent.
  text | Message string.
  caption | Message box title. The application name is added to the title. The default title is i18n("Question").
  buttonYes | The text for the first button. The default is i18n("&Yes").
  buttonNo | The text for the second button. The default is i18n("&No").
  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 OptionsType

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

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

Definition at line 452 of file kmessagebox.cpp.

int KMessageBox::questionYesNoCancelWId | ( | WId | parent_id,
|  | const QString & | text,
|  | const QString & | caption = `QString::null`,
|  | const KGuiItem & | buttonYes = `KStdGuiItem::yes()`,
|  | const KGuiItem & | buttonNo = `KStdGuiItem::no()`,
|  | const QString & | dontAskAgainName = `QString::null`,
|  | int | options = `Notify`
| ) |  |

static

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

It should be used only when necessary.

Since
  3.2

Definition at line 465 of file kmessagebox.cpp.

int KMessageBox::questionYesNoList | ( | QWidget * | parent,
|  | const QString & | text,
|  | const QStringList & | strlist,
|  | const QString & | caption = `QString::null`,
|  | const KGuiItem & | buttonYes = `KStdGuiItem::yes()`,
|  | const KGuiItem & | buttonNo = `KStdGuiItem::no()`,
|  | const QString & | dontAskAgainName = `QString::null`,
|  | int | options = `Notify`
| ) |  |

static

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

Parameters

  parent | If `parent` is 0, then the message box becomes an application-global modal dialog box. If `parent` is a widget, the message box becomes modal relative to parent.
  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 questionYesNo.
  caption | Message box title. The application name is added to the title. The default title is i18n("Question").
  buttonYes | The text for the first button. The default is i18n("&Yes").
  buttonNo | The text for the second button. The default is i18n("&No").
  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 OptionsType

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 401 of file kmessagebox.cpp.

int KMessageBox::questionYesNoListWId | ( | WId | parent_id,
|  | const QString & | text,
|  | const QStringList & | strlist,
|  | const QString & | caption = `QString::null`,
|  | const KGuiItem & | buttonYes = `KStdGuiItem::yes()`,
|  | const KGuiItem & | buttonNo = `KStdGuiItem::no()`,
|  | const QString & | dontAskAgainName = `QString::null`,
|  | int | options = `Notify`
| ) |  |

static

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

It should be used only when necessary.

Since
  3.2

Definition at line 414 of file kmessagebox.cpp.

int KMessageBox::questionYesNoWId | ( | WId | parent_id,
|  | const QString & | text,
|  | const QString & | caption = `QString::null`,
|  | const KGuiItem & | buttonYes = `KStdGuiItem::yes()`,
|  | const KGuiItem & | buttonNo = `KStdGuiItem::no()`,
|  | const QString & | dontAskAgainName = `QString::null`,
|  | int | options = `Notify`
| ) |  |

static

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

It should be used only when necessary.

Since
  3.2

Definition at line 329 of file kmessagebox.cpp.

void KMessageBox::queuedDetailedError | ( | QWidget * | parent,
|  | const QString & | text,
|  | const QString & | details,
|  | const QString & | caption = `QString::null`
| ) |  |

static

Like detailedError.

This function will return immediately, the messagebox will be shown once the application enters an event loop and no other messagebox is being shown.

Note that if the parent gets deleted, the messagebox will not be shown.

Definition at line 806 of file kmessagebox.cpp.

void KMessageBox::queuedDetailedErrorWId | ( | WId | parent_id,
|  | const QString & | text,
|  | const QString & | details,
|  | const QString & | caption = `QString::null`
| ) |  |

static

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

It should be used only when necessary.

Since
  3.2

Definition at line 814 of file kmessagebox.cpp.

void KMessageBox::queuedMessageBox | ( | QWidget * | parent,
|  | DialogType | type,
|  | const QString & | text,
|  | const QString & | caption,
|  | int | options
| ) |  |

static

Like messageBox.

Only for message boxes of type Information, Sorry or Error.

This function will return immediately, the messagebox will be shown once the application enters an event loop and no other messagebox is being shown.

Note that if the parent gets deleted, the messagebox will not be shown.

Definition at line 1048 of file kmessagebox.cpp.

void KMessageBox::queuedMessageBox | ( | QWidget * | parent,
|  | DialogType | type,
|  | const QString & | text,
|  | const QString & | caption = `QString::null`
| ) |  |

static

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.This is an overloaded member function, provided for convenience.

It behaves essentially like the above function.

Definition at line 1061 of file kmessagebox.cpp.

void KMessageBox::queuedMessageBoxWId | ( | WId | parent_id,
|  | DialogType | type,
|  | const QString & | text,
|  | const QString & | caption,
|  | int | options
| ) |  |

static

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

It should be used only when necessary.

Since
  3.2

Definition at line 1053 of file kmessagebox.cpp.

void KMessageBox::queuedMessageBoxWId | ( | WId | parent_id,
|  | DialogType | type,
|  | const QString & | text,
|  | const QString & | caption = `QString::null`
| ) |  |

static

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

It should be used only when necessary.

Since
  3.2

Definition at line 1066 of file kmessagebox.cpp.

void KMessageBox::saveDontShowAgainContinue | ( | const QString & | dontShowAgainName | ) |

static

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

Parameters

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

Since
  3.2

Definition at line 383 of file kmessagebox.cpp.

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

static

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

Parameters

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

Since
  3.2

Definition at line 371 of file kmessagebox.cpp.

void KMessageBox::setDontShowAskAgainConfig | ( | KConfig * | cfg | ) |

static

Use `cfg` for all settings related to the dontShowAgainName feature.

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

Since
  3.2

Definition at line 395 of file kmessagebox.cpp.

bool KMessageBox::shouldBeShownContinue | ( | const QString & | dontShowAgainName | ) |

static

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

Parameters

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

Since
  3.2

Definition at line 361 of file kmessagebox.cpp.

bool KMessageBox::shouldBeShownYesNo | ( | const QString & | dontShowAgainName,
|  | ButtonCode & | result
| ) |  |

static

Returns
  true if the corresponding yes/no message box should be shown.

Parameters

  dontShowAgainName | the name that identify the message box. If empty, true is always returned.
  result | is 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.

Since
  3.2

Definition at line 341 of file kmessagebox.cpp.

void KMessageBox::sorry | ( | QWidget * | parent,
|  | const QString & | text,
|  | const QString & | caption = `QString::null`,
|  | int | options = `Notify`
| ) |  |

static

Display an "Sorry" dialog.

Parameters

  parent | If `parent` is 0, then the message box becomes an application-global modal dialog box. If `parent` is a widget, the message box becomes modal relative to parent.
  text | Message string.
  caption | Message box title. The application name is added to the title. The default title is i18n("Sorry").
  options | see 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'.

Definition at line 825 of file kmessagebox.cpp.

void KMessageBox::sorryWId | ( | WId | parent_id,
|  | const QString & | text,
|  | const QString & | caption = `QString::null`,
|  | int | options = `Notify`
| ) |  |

static

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

It should be used only when necessary.

Since
  3.2

Definition at line 832 of file kmessagebox.cpp.

int KMessageBox::warningContinueCancel | ( | QWidget * | parent,
|  | const QString & | text,
|  | const QString & | caption = `QString::null`,
|  | const KGuiItem & | buttonContinue = `KStdGuiItem::cont()`,
|  | const QString & | dontAskAgainName = `QString::null`,
|  | int | options = `Notify`
| ) |  |

static

Display a "warning" dialog.

Parameters

  parent | If `parent` is 0, then the message box becomes an application-global modal dialog box. If `parent` is a widget, the message box becomes modal relative to parent.
  text | Message string.
  caption | Message box title. The application name is added to the title. The default title is i18n("Warning").
  buttonContinue | The text for the first button.
  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 OptionsType

The second button always has the text "Cancel".

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 585 of file kmessagebox.cpp.

int KMessageBox::warningContinueCancelList | ( | QWidget * | parent,
|  | const QString & | text,
|  | const QStringList & | strlist,
|  | const QString & | caption = `QString::null`,
|  | const KGuiItem & | buttonContinue = `KStdGuiItem::cont()`,
|  | const QString & | dontAskAgainName = `QString::null`,
|  | int | options = `Notify`
| ) |  |

static

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

Parameters

  parent | If `parent` is 0, then the message box becomes an application-global modal dialog box. If `parent` is a widget, the message box becomes modal relative to parent.
  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.
  caption | Message box title. The application name is added to the title. The default title is i18n("Warning").
  buttonContinue | The text for the first button.
  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 OptionsType

The second button always has the text "Cancel".

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 609 of file kmessagebox.cpp.

int KMessageBox::warningContinueCancelListWId | ( | WId | parent_id,
|  | const QString & | text,
|  | const QStringList & | strlist,
|  | const QString & | caption = `QString::null`,
|  | const KGuiItem & | buttonContinue = `KStdGuiItem::cont()`,
|  | const QString & | dontAskAgainName = `QString::null`,
|  | int | options = `Notify`
| ) |  |

static

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

It should be used only when necessary.

Since
  3.2

Definition at line 621 of file kmessagebox.cpp.

int KMessageBox::warningContinueCancelWId | ( | WId | parent_id,
|  | const QString & | text,
|  | const QString & | caption = `QString::null`,
|  | const KGuiItem & | buttonContinue = `KStdGuiItem::cont()`,
|  | const QString & | dontAskAgainName = `QString::null`,
|  | int | options = `Notify`
| ) |  |

static

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

It should be used only when necessary.

Since
  3.2

Definition at line 597 of file kmessagebox.cpp.

int KMessageBox::warningYesNo | ( | QWidget * | parent,
|  | const QString & | text,
|  | const QString & | caption = `QString::null`,
|  | const KGuiItem & | buttonYes = `KStdGuiItem::yes()`,
|  | const KGuiItem & | buttonNo = `KStdGuiItem::no()`,
|  | const QString & | dontAskAgainName = `QString::null`,
|  | int | options = `Notify | Dangerous`
| ) |  |

static

Display a "warning" dialog.

Parameters

  parent | If `parent` is 0, then the message box becomes an application-global modal dialog box. If `parent` is a widget, the message box becomes modal relative to parent.
  text | Message string.
  caption | Message box title. The application name is added to the title. The default title is i18n("Warning").
  buttonYes | The text for the first button. The default is i18n("&Yes").
  buttonNo | The text for the second button. The default is i18n("&No").
  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 OptionsType

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 505 of file kmessagebox.cpp.

int KMessageBox::warningYesNoCancel | ( | QWidget * | parent,
|  | const QString & | text,
|  | const QString & | caption = `QString::null`,
|  | const KGuiItem & | buttonYes = `KStdGuiItem::yes()`,
|  | const KGuiItem & | buttonNo = `KStdGuiItem::no()`,
|  | const QString & | dontAskAgainName = `QString::null`,
|  | int | options = `Notify`
| ) |  |

static

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

Parameters

  parent | If `parent` is 0, then the message box becomes an application-global modal dialog box. If `parent` is a widget, the message box becomes modal relative to parent.
  text | Message string.
  caption | Message box title. The application name is added to the title. The default title is i18n("Warning").
  buttonYes | The text for the first button. The default is i18n("&Yes").
  buttonNo | The text for the second button. The default is i18n("&No").

  dontAskAgainName

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

  options | see OptionsType

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"

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

Definition at line 658 of file kmessagebox.cpp.

int KMessageBox::warningYesNoCancelList | ( | QWidget * | parent,
|  | const QString & | text,
|  | const QStringList & | strlist,
|  | const QString & | caption = `QString::null`,
|  | const KGuiItem & | buttonYes = `KStdGuiItem::yes()`,
|  | const KGuiItem & | buttonNo = `KStdGuiItem::no()`,
|  | const QString & | dontAskAgainName = `QString::null`,
|  | int | options = `Notify`
| ) |  |

static

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

Parameters

  parent | If `parent` is 0, then the message box becomes an application-global modal dialog box. If `parent` is a widget, the message box becomes modal relative to parent.
  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 warningYesNoCancel.
  caption | Message box title. The application name is added to the title. The default title is i18n("Warning").
  buttonYes | The text for the first button. The default is i18n("&Yes").
  buttonNo | The text for the second button. The default is i18n("&No").

  dontAskAgainName

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

  options | see OptionsType

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"

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

Since
  3.2

Definition at line 682 of file kmessagebox.cpp.

int KMessageBox::warningYesNoCancelListWId | ( | WId | parent_id,
|  | const QString & | text,
|  | const QStringList & | strlist,
|  | const QString & | caption = `QString::null`,
|  | const KGuiItem & | buttonYes = `KStdGuiItem::yes()`,
|  | const KGuiItem & | buttonNo = `KStdGuiItem::no()`,
|  | const QString & | dontAskAgainName = `QString::null`,
|  | int | options = `Notify`
| ) |  |

static

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

It should be used only when necessary.

Since
  3.2

Definition at line 695 of file kmessagebox.cpp.

int KMessageBox::warningYesNoCancelWId | ( | WId | parent_id,
|  | const QString & | text,
|  | const QString & | caption = `QString::null`,
|  | const KGuiItem & | buttonYes = `KStdGuiItem::yes()`,
|  | const KGuiItem & | buttonNo = `KStdGuiItem::no()`,
|  | const QString & | dontAskAgainName = `QString::null`,
|  | int | options = `Notify`
| ) |  |

static

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

It should be used only when necessary.

Since
  3.2

Definition at line 670 of file kmessagebox.cpp.

int KMessageBox::warningYesNoList | ( | QWidget * | parent,
|  | const QString & | text,
|  | const QStringList & | strlist,
|  | const QString & | caption = `QString::null`,
|  | const KGuiItem & | buttonYes = `KStdGuiItem::yes()`,
|  | const KGuiItem & | buttonNo = `KStdGuiItem::no()`,
|  | const QString & | dontAskAgainName = `QString::null`,
|  | int | options = `Notify | Dangerous`
| ) |  |

static

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

Parameters

  parent | If `parent` is 0, then the message box becomes an application-global modal dialog box. If `parent` is a widget, the message box becomes modal relative to parent.
  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 questionYesNo.
  caption | Message box title. The application name is added to the title. The default title is i18n("Question").
  buttonYes | The text for the first button. The default is i18n("&Yes").
  buttonNo | The text for the second button. The default is i18n("&No").
  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 OptionsType

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 529 of file kmessagebox.cpp.

int KMessageBox::warningYesNoListWId | ( | WId | parent_id,
|  | const QString & | text,
|  | const QStringList & | strlist,
|  | const QString & | caption = `QString::null`,
|  | const KGuiItem & | buttonYes = `KStdGuiItem::yes()`,
|  | const KGuiItem & | buttonNo = `KStdGuiItem::no()`,
|  | const QString & | dontAskAgainName = `QString::null`,
|  | int | options = `Notify | Dangerous`
| ) |  |

static

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

It should be used only when necessary.

Since
  3.2

Definition at line 542 of file kmessagebox.cpp.

int KMessageBox::warningYesNoWId | ( | WId | parent_id,
|  | const QString & | text,
|  | const QString & | caption = `QString::null`,
|  | const KGuiItem & | buttonYes = `KStdGuiItem::yes()`,
|  | const KGuiItem & | buttonNo = `KStdGuiItem::no()`,
|  | const QString & | dontAskAgainName = `QString::null`,
|  | int | options = `Notify | Dangerous`
| ) |  |

static

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

It should be used only when necessary.

Since
  3.2

Definition at line 517 of file kmessagebox.cpp.

The documentation for this class was generated from the following files:

- kmessagebox.h
- kmessagebox.cpp

KDE Home | KDE Accessibility Home | Description of Access Keys