.TH "KMessageBox" kde3 "11 Jun 2005" "Version Version 3.4.1" "kdeui Library" \" -*- nroff -*-
.ad l
.nh
.SH NAME
KMessageBox \- Easy message dialog box.  

.PP
.SH SYNOPSIS
.br
.PP
\fC#include <kmessagebox.h>\fP
.PP
.SS "Public Types"

.in +1c
.ti -1c
.RI "enum \fBButtonCode\fP { \fBOk\fP =  1, \fBCancel\fP =  2, \fBYes\fP =  3, \fBNo\fP =  4, \fBContinue\fP =  5 }"
.br
.ti -1c
.RI "enum \fBDialogType\fP { \fBQuestionYesNo\fP =  1, \fBWarningYesNo\fP =  2, \fBWarningContinueCancel\fP =  3, \fBWarningYesNoCancel\fP =  4, \fBInformation\fP =  5, \fBSorry\fP =  7, \fBError\fP =  8, \fBQuestionYesNoCancel\fP =  9 }"
.br
.ti -1c
.RI "enum \fBOptionsType\fP { \fBNotify\fP =  1, \fBAllowLink\fP =  2, \fBDangerous\fP =  4, \fBPlainCaption\fP =  8, \fBNoExec\fP =  16 }"
.br
.in -1c
.SS "Static Public Member Functions"

.in +1c
.ti -1c
.RI "static int \fBquestionYesNo\fP (\fBQWidget\fP *parent, const \fBQString\fP &text, const \fBQString\fP &caption=QString::null, const \fBKGuiItem\fP &buttonYes=KStdGuiItem::yes(), const \fBKGuiItem\fP &buttonNo=KStdGuiItem::no(), const \fBQString\fP &dontAskAgainName=QString::null, int options=Notify)"
.br
.ti -1c
.RI "static int \fBquestionYesNoWId\fP (WId parent_id, const \fBQString\fP &text, const \fBQString\fP &caption=QString::null, const \fBKGuiItem\fP &buttonYes=KStdGuiItem::yes(), const \fBKGuiItem\fP &buttonNo=KStdGuiItem::no(), const \fBQString\fP &dontAskAgainName=QString::null, int options=Notify)"
.br
.ti -1c
.RI "static int \fBquestionYesNoCancel\fP (\fBQWidget\fP *parent, const \fBQString\fP &text, const \fBQString\fP &caption=QString::null, const \fBKGuiItem\fP &buttonYes=KStdGuiItem::yes(), const \fBKGuiItem\fP &buttonNo=KStdGuiItem::no(), const \fBQString\fP &dontAskAgainName=QString::null, int options=Notify)"
.br
.ti -1c
.RI "static int \fBquestionYesNoCancelWId\fP (WId parent_id, const \fBQString\fP &text, const \fBQString\fP &caption=QString::null, const \fBKGuiItem\fP &buttonYes=KStdGuiItem::yes(), const \fBKGuiItem\fP &buttonNo=KStdGuiItem::no(), const \fBQString\fP &dontAskAgainName=QString::null, int options=Notify)"
.br
.ti -1c
.RI "static int \fBquestionYesNoList\fP (\fBQWidget\fP *parent, const \fBQString\fP &text, const \fBQStringList\fP &strlist, const \fBQString\fP &caption=QString::null, const \fBKGuiItem\fP &buttonYes=KStdGuiItem::yes(), const \fBKGuiItem\fP &buttonNo=KStdGuiItem::no(), const \fBQString\fP &dontAskAgainName=QString::null, int options=Notify)"
.br
.ti -1c
.RI "static int \fBquestionYesNoListWId\fP (WId parent_id, const \fBQString\fP &text, const \fBQStringList\fP &strlist, const \fBQString\fP &caption=QString::null, const \fBKGuiItem\fP &buttonYes=KStdGuiItem::yes(), const \fBKGuiItem\fP &buttonNo=KStdGuiItem::no(), const \fBQString\fP &dontAskAgainName=QString::null, int options=Notify)"
.br
.ti -1c
.RI "static int \fBwarningYesNo\fP (\fBQWidget\fP *parent, const \fBQString\fP &text, const \fBQString\fP &caption=QString::null, const \fBKGuiItem\fP &buttonYes=KStdGuiItem::yes(), const \fBKGuiItem\fP &buttonNo=KStdGuiItem::no(), const \fBQString\fP &dontAskAgainName=QString::null, int options=Notify|Dangerous)"
.br
.ti -1c
.RI "static int \fBwarningYesNoWId\fP (WId parent_id, const \fBQString\fP &text, const \fBQString\fP &caption=QString::null, const \fBKGuiItem\fP &buttonYes=KStdGuiItem::yes(), const \fBKGuiItem\fP &buttonNo=KStdGuiItem::no(), const \fBQString\fP &dontAskAgainName=QString::null, int options=Notify|Dangerous)"
.br
.ti -1c
.RI "static int \fBwarningYesNoList\fP (\fBQWidget\fP *parent, const \fBQString\fP &text, const \fBQStringList\fP &strlist, const \fBQString\fP &caption=QString::null, const \fBKGuiItem\fP &buttonYes=KStdGuiItem::yes(), const \fBKGuiItem\fP &buttonNo=KStdGuiItem::no(), const \fBQString\fP &dontAskAgainName=QString::null, int options=Notify|Dangerous)"
.br
.ti -1c
.RI "static int \fBwarningYesNoListWId\fP (WId parent_id, const \fBQString\fP &text, const \fBQStringList\fP &strlist, const \fBQString\fP &caption=QString::null, const \fBKGuiItem\fP &buttonYes=KStdGuiItem::yes(), const \fBKGuiItem\fP &buttonNo=KStdGuiItem::no(), const \fBQString\fP &dontAskAgainName=QString::null, int options=Notify|Dangerous)"
.br
.ti -1c
.RI "static int \fBwarningContinueCancel\fP (\fBQWidget\fP *parent, const \fBQString\fP &text, const \fBQString\fP &caption=QString::null, const \fBKGuiItem\fP &buttonContinue=KStdGuiItem::cont(), const \fBQString\fP &dontAskAgainName=QString::null, int options=Notify)"
.br
.ti -1c
.RI "static int \fBwarningContinueCancelWId\fP (WId parent_id, const \fBQString\fP &text, const \fBQString\fP &caption=QString::null, const \fBKGuiItem\fP &buttonContinue=KStdGuiItem::cont(), const \fBQString\fP &dontAskAgainName=QString::null, int options=Notify)"
.br
.ti -1c
.RI "static int \fBwarningContinueCancelList\fP (\fBQWidget\fP *parent, const \fBQString\fP &text, const \fBQStringList\fP &strlist, const \fBQString\fP &caption=QString::null, const \fBKGuiItem\fP &buttonContinue=KStdGuiItem::cont(), const \fBQString\fP &dontAskAgainName=QString::null, int options=Notify)"
.br
.ti -1c
.RI "static int \fBwarningContinueCancelListWId\fP (WId parent_id, const \fBQString\fP &text, const \fBQStringList\fP &strlist, const \fBQString\fP &caption=QString::null, const \fBKGuiItem\fP &buttonContinue=KStdGuiItem::cont(), const \fBQString\fP &dontAskAgainName=QString::null, int options=Notify)"
.br
.ti -1c
.RI "static int \fBwarningYesNoCancel\fP (\fBQWidget\fP *parent, const \fBQString\fP &text, const \fBQString\fP &caption=QString::null, const \fBKGuiItem\fP &buttonYes=KStdGuiItem::yes(), const \fBKGuiItem\fP &buttonNo=KStdGuiItem::no(), const \fBQString\fP &dontAskAgainName=QString::null, int options=Notify)"
.br
.ti -1c
.RI "static int \fBwarningYesNoCancelWId\fP (WId parent_id, const \fBQString\fP &text, const \fBQString\fP &caption=QString::null, const \fBKGuiItem\fP &buttonYes=KStdGuiItem::yes(), const \fBKGuiItem\fP &buttonNo=KStdGuiItem::no(), const \fBQString\fP &dontAskAgainName=QString::null, int options=Notify)"
.br
.ti -1c
.RI "static int \fBwarningYesNoCancelList\fP (\fBQWidget\fP *parent, const \fBQString\fP &text, const \fBQStringList\fP &strlist, const \fBQString\fP &caption=QString::null, const \fBKGuiItem\fP &buttonYes=KStdGuiItem::yes(), const \fBKGuiItem\fP &buttonNo=KStdGuiItem::no(), const \fBQString\fP &dontAskAgainName=QString::null, int options=Notify)"
.br
.ti -1c
.RI "static int \fBwarningYesNoCancelListWId\fP (WId parent_id, const \fBQString\fP &text, const \fBQStringList\fP &strlist, const \fBQString\fP &caption=QString::null, const \fBKGuiItem\fP &buttonYes=KStdGuiItem::yes(), const \fBKGuiItem\fP &buttonNo=KStdGuiItem::no(), const \fBQString\fP &dontAskAgainName=QString::null, int options=Notify)"
.br
.ti -1c
.RI "static void \fBerror\fP (\fBQWidget\fP *parent, const \fBQString\fP &text, const \fBQString\fP &caption=QString::null, int options=Notify)"
.br
.ti -1c
.RI "static void \fBerrorWId\fP (WId parent_id, const \fBQString\fP &text, const \fBQString\fP &caption=QString::null, int options=Notify)"
.br
.ti -1c
.RI "static void \fBerrorList\fP (\fBQWidget\fP *parent, const \fBQString\fP &text, const \fBQStringList\fP &strlist, const \fBQString\fP &caption=QString::null, int options=Notify)"
.br
.ti -1c
.RI "static void \fBerrorListWId\fP (WId parent_id, const \fBQString\fP &text, const \fBQStringList\fP &strlist, const \fBQString\fP &caption=QString::null, int options=Notify)"
.br
.ti -1c
.RI "static void \fBdetailedError\fP (\fBQWidget\fP *parent, const \fBQString\fP &text, const \fBQString\fP &details, const \fBQString\fP &caption=QString::null, int options=Notify)"
.br
.ti -1c
.RI "static void \fBdetailedErrorWId\fP (WId parent_id, const \fBQString\fP &text, const \fBQString\fP &details, const \fBQString\fP &caption=QString::null, int options=Notify)"
.br
.ti -1c
.RI "static void \fBqueuedDetailedError\fP (\fBQWidget\fP *parent, const \fBQString\fP &text, const \fBQString\fP &details, const \fBQString\fP &caption=QString::null)"
.br
.ti -1c
.RI "static void \fBqueuedDetailedErrorWId\fP (WId parent_id, const \fBQString\fP &text, const \fBQString\fP &details, const \fBQString\fP &caption=QString::null)"
.br
.ti -1c
.RI "static void \fBsorry\fP (\fBQWidget\fP *parent, const \fBQString\fP &text, const \fBQString\fP &caption=QString::null, int options=Notify)"
.br
.ti -1c
.RI "static void \fBsorryWId\fP (WId parent_id, const \fBQString\fP &text, const \fBQString\fP &caption=QString::null, int options=Notify)"
.br
.ti -1c
.RI "static void \fBdetailedSorry\fP (\fBQWidget\fP *parent, const \fBQString\fP &text, const \fBQString\fP &details, const \fBQString\fP &caption=QString::null, int options=Notify)"
.br
.ti -1c
.RI "static void \fBdetailedSorryWId\fP (WId parent_id, const \fBQString\fP &text, const \fBQString\fP &details, const \fBQString\fP &caption=QString::null, int options=Notify)"
.br
.ti -1c
.RI "static void \fBinformation\fP (\fBQWidget\fP *parent, const \fBQString\fP &text, const \fBQString\fP &caption=QString::null, const \fBQString\fP &dontShowAgainName=QString::null, int options=Notify)"
.br
.ti -1c
.RI "static void \fBinformationWId\fP (WId parent_id, const \fBQString\fP &text, const \fBQString\fP &caption=QString::null, const \fBQString\fP &dontShowAgainName=QString::null, int options=Notify)"
.br
.ti -1c
.RI "static void \fBinformationList\fP (\fBQWidget\fP *parent, const \fBQString\fP &text, const \fBQStringList\fP &strlist, const \fBQString\fP &caption=QString::null, const \fBQString\fP &dontShowAgainName=QString::null, int options=Notify)"
.br
.ti -1c
.RI "static void \fBinformationListWId\fP (WId parent_id, const \fBQString\fP &text, const \fBQStringList\fP &strlist, const \fBQString\fP &caption=QString::null, const \fBQString\fP &dontShowAgainName=QString::null, int options=Notify)"
.br
.ti -1c
.RI "static void \fBenableAllMessages\fP ()"
.br
.ti -1c
.RI "static void \fBenableMessage\fP (const \fBQString\fP &dontShowAgainName)"
.br
.ti -1c
.RI "static void \fBabout\fP (\fBQWidget\fP *parent, const \fBQString\fP &text, const \fBQString\fP &caption=QString::null, int options=Notify)"
.br
.ti -1c
.RI "static int \fBmessageBox\fP (\fBQWidget\fP *parent, DialogType type, const \fBQString\fP &text, const \fBQString\fP &caption, const \fBKGuiItem\fP &buttonYes, const \fBKGuiItem\fP &buttonNo, const \fBQString\fP &dontShowAskAgainName, int options=Notify)"
.br
.ti -1c
.RI "static int \fBmessageBox\fP (\fBQWidget\fP *parent, DialogType type, const \fBQString\fP &text, const \fBQString\fP &caption=QString::null, const \fBKGuiItem\fP &buttonYes=KStdGuiItem::yes(), const \fBKGuiItem\fP &buttonNo=KStdGuiItem::no(), int options=Notify)"
.br
.ti -1c
.RI "static int \fBmessageBoxWId\fP (WId parent_id, DialogType type, const \fBQString\fP &text, const \fBQString\fP &caption=QString::null, const \fBKGuiItem\fP &buttonYes=KStdGuiItem::yes(), const \fBKGuiItem\fP &buttonNo=KStdGuiItem::no(), const \fBQString\fP &dontShowAskAgainName=QString::null, int options=Notify)"
.br
.ti -1c
.RI "static void \fBqueuedMessageBox\fP (\fBQWidget\fP *parent, DialogType type, const \fBQString\fP &text, const \fBQString\fP &caption, int options)"
.br
.ti -1c
.RI "static void \fBqueuedMessageBoxWId\fP (WId parent_id, DialogType type, const \fBQString\fP &text, const \fBQString\fP &caption, int options)"
.br
.ti -1c
.RI "static void \fBqueuedMessageBox\fP (\fBQWidget\fP *parent, DialogType type, const \fBQString\fP &text, const \fBQString\fP &caption=QString::null)"
.br
.ti -1c
.RI "static void \fBqueuedMessageBoxWId\fP (WId parent_id, DialogType type, const \fBQString\fP &text, const \fBQString\fP &caption=QString::null)"
.br
.ti -1c
.RI "static bool \fBshouldBeShownYesNo\fP (const \fBQString\fP &dontShowAgainName, \fBButtonCode\fP &result)"
.br
.ti -1c
.RI "static bool \fBshouldBeShownContinue\fP (const \fBQString\fP &dontShowAgainName)"
.br
.ti -1c
.RI "static void \fBsaveDontShowAgainYesNo\fP (const \fBQString\fP &dontShowAgainName, \fBButtonCode\fP result)"
.br
.ti -1c
.RI "static void \fBsaveDontShowAgainContinue\fP (const \fBQString\fP &dontShowAgainName)"
.br
.ti -1c
.RI "static void \fBsetDontShowAskAgainConfig\fP (\fBKConfig\fP *cfg)"
.br
.ti -1c
.RI "static int \fBcreateKMessageBox\fP (\fBKDialogBase\fP *dialog, QMessageBox::Icon icon, const \fBQString\fP &text, const \fBQStringList\fP &strlist, const \fBQString\fP &ask, bool *checkboxReturn, int options, const \fBQString\fP &details=QString::null)"
.br
.ti -1c
.RI "static int \fBcreateKMessageBox\fP (\fBKDialogBase\fP *dialog, \fBQPixmap\fP icon, const \fBQString\fP &text, const \fBQStringList\fP &strlist, const \fBQString\fP &ask, bool *checkboxReturn, int options, const \fBQString\fP &details=QString::null, QMessageBox::Icon notifyType=QMessageBox::Information)"
.br
.in -1c
.SH "Detailed Description"
.PP 
Easy message dialog box. 

Provides convenience functions for some i18n'ed standard dialogs.
.PP
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.
.PP
\fBAuthor:\fP
.RS 4
Waldo Bastian (bastian@kde.org) 
.RE
.PP

.PP
Definition at line 44 of file kmessagebox.h.
.SH "Member Enumeration Documentation"
.PP 
.SS "enum \fBKMessageBox::ButtonCode\fP"
.PP
Button types. 
.PP
Definition at line 50 of file kmessagebox.h.
.SS "enum \fBKMessageBox::OptionsType\fP"
.PP
.PD 0
.IP "\(bu" 2
Notify Emit a \fBKNotifyClient\fP event 
.IP "\(bu" 2
AllowLink The message may contain links. 
.PP

.PP
.PD 0
.IP "\(bu" 2
Dangerous The action to be confirmed by the dialog is a potentially destructive one 
.IP "\(bu" 2
PlainCaption Do not use \fBKApplication::makeStdCaption()\fP 
.IP "\(bu" 2
NoExec Do not call exec() in \fBcreateKMessageBox()\fP 
.PP

.PP
\fBEnumeration values: \fP
.in +1c
.TP
\fB\fIPlainCaption \fP\fP
\fBSince:\fP
.RS 4
3.4 
.RE
.PP

.TP
\fB\fINoExec \fP\fP
\fBSince:\fP
.RS 4
3.4 
.RE
.PP

.PP
Definition at line 79 of file kmessagebox.h.
.SH "Member Function Documentation"
.PP 
.SS "int KMessageBox::questionYesNo (\fBQWidget\fP * parent, const \fBQString\fP & text, const \fBQString\fP & caption = \fCQString::null\fP, const \fBKGuiItem\fP & buttonYes = \fCKStdGuiItem::yes()\fP, const \fBKGuiItem\fP & buttonNo = \fCKStdGuiItem::no()\fP, const \fBQString\fP & dontAskAgainName = \fCQString::null\fP, int options = \fCNotify\fP)\fC [static]\fP"
.PP
Display a simple 'question' dialog. 
.PP
\fBParameters:\fP
.RS 4
\fIparent\fP If \fCparent\fP is 0, then the message box becomes an application-global modal dialog box. If \fCparent\fP is a widget, the message box becomes modal relative to parent. 
.br
\fItext\fP Message string. 
.br
\fIcaption\fP Message box title. The application name is added to the title. The default title is i18n('Question'). 
.br
\fIbuttonYes\fP The text for the first button. The default is i18n('&Yes'). 
.br
\fIbuttonNo\fP The text for the second button. The default is i18n('&No'). 
.br
\fIdontAskAgainName\fP 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 \fCdontAskAgainName\fP starts with a ':' then the setting is stored in the global config file. 
.br
\fIoptions\fP see OptionsType
.RE
.PP
\fBReturns:\fP
.RS 4
'Yes' is returned if the Yes-button is pressed. 'No' is returned if the No-button is pressed.
.RE
.PP
To be used for questions like 'Do you have a printer?'
.PP
The default button is 'Yes'. Pressing 'Esc' selects 'No'. 
.PP
Definition at line 319 of file kmessagebox.cpp.
.PP
References questionYesNoList().
.SS "int KMessageBox::questionYesNoWId (WId parent_id, const \fBQString\fP & text, const \fBQString\fP & caption = \fCQString::null\fP, const \fBKGuiItem\fP & buttonYes = \fCKStdGuiItem::yes()\fP, const \fBKGuiItem\fP & buttonNo = \fCKStdGuiItem::no()\fP, const \fBQString\fP & dontAskAgainName = \fCQString::null\fP, int options = \fCNotify\fP)\fC [static]\fP"
.PP
This function accepts the window id of the parent window, instead of QWidget*. 
.PP
It should be used only when necessary. 
.PP
\fBSince:\fP
.RS 4
3.2 
.RE
.PP

.PP
Definition at line 331 of file kmessagebox.cpp.
.PP
References questionYesNoListWId().
.PP
Referenced by messageBoxWId().
.SS "int KMessageBox::questionYesNoCancel (\fBQWidget\fP * parent, const \fBQString\fP & text, const \fBQString\fP & caption = \fCQString::null\fP, const \fBKGuiItem\fP & buttonYes = \fCKStdGuiItem::yes()\fP, const \fBKGuiItem\fP & buttonNo = \fCKStdGuiItem::no()\fP, const \fBQString\fP & dontAskAgainName = \fCQString::null\fP, int options = \fCNotify\fP)\fC [static]\fP"
.PP
Display a simple 'question' dialog. 
.PP
\fBParameters:\fP
.RS 4
\fIparent\fP If \fCparent\fP is 0, then the message box becomes an application-global modal dialog box. If \fCparent\fP is a widget, the message box becomes modal relative to parent. 
.br
\fItext\fP Message string. 
.br
\fIcaption\fP Message box title. The application name is added to the title. The default title is i18n('Question'). 
.br
\fIbuttonYes\fP The text for the first button. The default is i18n('&Yes'). 
.br
\fIbuttonNo\fP The text for the second button. The default is i18n('&No'). 
.br
\fIdontAskAgainName\fP 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 \fCdontAskAgainName\fP starts with a ':' then the setting is stored in the global config file. 
.br
\fIoptions\fP see OptionsType
.RE
.PP
\fBReturns:\fP
.RS 4
'Yes' is returned if the Yes-button is pressed. 'No' is returned if the No-button is pressed.
.RE
.PP
To be used for questions like 'Do you want to discard the message or save it for later?',
.PP
The default button is 'Yes'. Pressing 'Esc' selects 'Cancel'.
.PP
NOTE: The cancel button will always have the i18n'ed text '&Cancel'. 
.PP
Definition at line 454 of file kmessagebox.cpp.
.PP
References questionYesNoCancelWId().
.SS "int KMessageBox::questionYesNoCancelWId (WId parent_id, const \fBQString\fP & text, const \fBQString\fP & caption = \fCQString::null\fP, const \fBKGuiItem\fP & buttonYes = \fCKStdGuiItem::yes()\fP, const \fBKGuiItem\fP & buttonNo = \fCKStdGuiItem::no()\fP, const \fBQString\fP & dontAskAgainName = \fCQString::null\fP, int options = \fCNotify\fP)\fC [static]\fP"
.PP
This function accepts the window id of the parent window, instead of QWidget*. 
.PP
It should be used only when necessary. 
.PP
\fBSince:\fP
.RS 4
3.2 
.RE
.PP

.PP
Definition at line 467 of file kmessagebox.cpp.
.PP
References createKMessageBox(), QWidget::find(), PlainCaption, saveDontShowAgainYesNo(), KDialog::setPlainCaption(), and shouldBeShownYesNo().
.PP
Referenced by messageBoxWId(), and questionYesNoCancel().
.SS "int KMessageBox::questionYesNoList (\fBQWidget\fP * parent, const \fBQString\fP & text, const \fBQStringList\fP & strlist, const \fBQString\fP & caption = \fCQString::null\fP, const \fBKGuiItem\fP & buttonYes = \fCKStdGuiItem::yes()\fP, const \fBKGuiItem\fP & buttonNo = \fCKStdGuiItem::no()\fP, const \fBQString\fP & dontAskAgainName = \fCQString::null\fP, int options = \fCNotify\fP)\fC [static]\fP"
.PP
Display a 'question' dialog with a listbox to show information to the user. 
.PP
\fBParameters:\fP
.RS 4
\fIparent\fP If \fCparent\fP is 0, then the message box becomes an application-global modal dialog box. If \fCparent\fP is a widget, the message box becomes modal relative to parent. 
.br
\fItext\fP Message string. 
.br
\fIstrlist\fP List of strings to be written in the listbox. If the list is empty, it doesn't show any listbox, working as questionYesNo. 
.br
\fIcaption\fP Message box title. The application name is added to the title. The default title is i18n('Question'). 
.br
\fIbuttonYes\fP The text for the first button. The default is i18n('&Yes'). 
.br
\fIbuttonNo\fP The text for the second button. The default is i18n('&No'). 
.br
\fIdontAskAgainName\fP 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 \fCdontAskAgainName\fP starts with a ':' then the setting is stored in the global config file. 
.br
\fIoptions\fP see OptionsType
.RE
.PP
\fBReturns:\fP
.RS 4
'Yes' is returned if the Yes-button is pressed. 'No' is returned if the No-button is pressed.
.RE
.PP
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'
.PP
The default button is 'Yes'. Pressing 'Esc' selects 'No'. 
.PP
Definition at line 403 of file kmessagebox.cpp.
.PP
References questionYesNoListWId().
.PP
Referenced by questionYesNo().
.SS "int KMessageBox::questionYesNoListWId (WId parent_id, const \fBQString\fP & text, const \fBQStringList\fP & strlist, const \fBQString\fP & caption = \fCQString::null\fP, const \fBKGuiItem\fP & buttonYes = \fCKStdGuiItem::yes()\fP, const \fBKGuiItem\fP & buttonNo = \fCKStdGuiItem::no()\fP, const \fBQString\fP & dontAskAgainName = \fCQString::null\fP, int options = \fCNotify\fP)\fC [static]\fP"
.PP
This function accepts the window id of the parent window, instead of QWidget*. 
.PP
It should be used only when necessary. 
.PP
\fBSince:\fP
.RS 4
3.2 
.RE
.PP

.PP
Definition at line 416 of file kmessagebox.cpp.
.PP
References createKMessageBox(), QWidget::find(), PlainCaption, saveDontShowAgainYesNo(), KDialog::setPlainCaption(), and shouldBeShownYesNo().
.PP
Referenced by questionYesNoList(), and questionYesNoWId().
.SS "int KMessageBox::warningYesNo (\fBQWidget\fP * parent, const \fBQString\fP & text, const \fBQString\fP & caption = \fCQString::null\fP, const \fBKGuiItem\fP & buttonYes = \fCKStdGuiItem::yes()\fP, const \fBKGuiItem\fP & buttonNo = \fCKStdGuiItem::no()\fP, const \fBQString\fP & dontAskAgainName = \fCQString::null\fP, int options = \fCNotify|Dangerous\fP)\fC [static]\fP"
.PP
Display a 'warning' dialog. 
.PP
\fBParameters:\fP
.RS 4
\fIparent\fP If \fCparent\fP is 0, then the message box becomes an application-global modal dialog box. If \fCparent\fP is a widget, the message box becomes modal relative to parent. 
.br
\fItext\fP Message string. 
.br
\fIcaption\fP Message box title. The application name is added to the title. The default title is i18n('Warning'). 
.br
\fIbuttonYes\fP The text for the first button. The default is i18n('&Yes'). 
.br
\fIbuttonNo\fP The text for the second button. The default is i18n('&No'). 
.br
\fIdontAskAgainName\fP 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 \fCdontAskAgainName\fP starts with a ':' then the setting is stored in the global config file. 
.br
\fIoptions\fP see OptionsType
.RE
.PP
\fBReturns:\fP
.RS 4
\fCYes\fP is returned if the Yes-button is pressed. \fCNo\fP is returned if the No-button is pressed.
.RE
.PP
To be used for questions 'Shall I update your configuration?' The text should explain the implication of both options.
.PP
The default button is 'No'. Pressing 'Esc' selects 'No'. 
.PP
Definition at line 507 of file kmessagebox.cpp.
.PP
References warningYesNoList().
.PP
Referenced by KBugReport::slotCancel(), and KPasswordDialog::slotOk().
.SS "int KMessageBox::warningYesNoWId (WId parent_id, const \fBQString\fP & text, const \fBQString\fP & caption = \fCQString::null\fP, const \fBKGuiItem\fP & buttonYes = \fCKStdGuiItem::yes()\fP, const \fBKGuiItem\fP & buttonNo = \fCKStdGuiItem::no()\fP, const \fBQString\fP & dontAskAgainName = \fCQString::null\fP, int options = \fCNotify|Dangerous\fP)\fC [static]\fP"
.PP
This function accepts the window id of the parent window, instead of QWidget*. 
.PP
It should be used only when necessary. 
.PP
\fBSince:\fP
.RS 4
3.2 
.RE
.PP

.PP
Definition at line 519 of file kmessagebox.cpp.
.PP
References warningYesNoListWId().
.PP
Referenced by messageBoxWId().
.SS "int KMessageBox::warningYesNoList (\fBQWidget\fP * parent, const \fBQString\fP & text, const \fBQStringList\fP & strlist, const \fBQString\fP & caption = \fCQString::null\fP, const \fBKGuiItem\fP & buttonYes = \fCKStdGuiItem::yes()\fP, const \fBKGuiItem\fP & buttonNo = \fCKStdGuiItem::no()\fP, const \fBQString\fP & dontAskAgainName = \fCQString::null\fP, int options = \fCNotify|Dangerous\fP)\fC [static]\fP"
.PP
Display a 'warning' dialog with a listbox to show information to the user. 
.PP
\fBParameters:\fP
.RS 4
\fIparent\fP If \fCparent\fP is 0, then the message box becomes an application-global modal dialog box. If \fCparent\fP is a widget, the message box becomes modal relative to parent. 
.br
\fItext\fP Message string. 
.br
\fIstrlist\fP List of strings to be written in the listbox. If the list is empty, it doesn't show any listbox, working as questionYesNo. 
.br
\fIcaption\fP Message box title. The application name is added to the title. The default title is i18n('Question'). 
.br
\fIbuttonYes\fP The text for the first button. The default is i18n('&Yes'). 
.br
\fIbuttonNo\fP The text for the second button. The default is i18n('&No'). 
.br
\fIdontAskAgainName\fP 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 \fCdontAskAgainName\fP starts with a ':' then the setting is stored in the global config file. 
.br
\fIoptions\fP see OptionsType
.RE
.PP
\fBReturns:\fP
.RS 4
'Yes' is returned if the Yes-button is pressed. 'No' is returned if the No-button is pressed.
.RE
.PP
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'
.PP
The default button is 'No'. Pressing 'Esc' selects 'No'. 
.PP
Definition at line 531 of file kmessagebox.cpp.
.PP
References warningYesNoListWId().
.PP
Referenced by warningYesNo().
.SS "int KMessageBox::warningYesNoListWId (WId parent_id, const \fBQString\fP & text, const \fBQStringList\fP & strlist, const \fBQString\fP & caption = \fCQString::null\fP, const \fBKGuiItem\fP & buttonYes = \fCKStdGuiItem::yes()\fP, const \fBKGuiItem\fP & buttonNo = \fCKStdGuiItem::no()\fP, const \fBQString\fP & dontAskAgainName = \fCQString::null\fP, int options = \fCNotify|Dangerous\fP)\fC [static]\fP"
.PP
This function accepts the window id of the parent window, instead of QWidget*. 
.PP
It should be used only when necessary. 
.PP
\fBSince:\fP
.RS 4
3.2 
.RE
.PP

.PP
Definition at line 544 of file kmessagebox.cpp.
.PP
References createKMessageBox(), QWidget::find(), PlainCaption, saveDontShowAgainYesNo(), KDialog::setPlainCaption(), and shouldBeShownYesNo().
.PP
Referenced by warningYesNoList(), and warningYesNoWId().
.SS "int KMessageBox::warningContinueCancel (\fBQWidget\fP * parent, const \fBQString\fP & text, const \fBQString\fP & caption = \fCQString::null\fP, const \fBKGuiItem\fP & buttonContinue = \fCKStdGuiItem::cont()\fP, const \fBQString\fP & dontAskAgainName = \fCQString::null\fP, int options = \fCNotify\fP)\fC [static]\fP"
.PP
Display a 'warning' dialog. 
.PP
\fBParameters:\fP
.RS 4
\fIparent\fP If \fCparent\fP is 0, then the message box becomes an application-global modal dialog box. If \fCparent\fP is a widget, the message box becomes modal relative to parent. 
.br
\fItext\fP Message string. 
.br
\fIcaption\fP Message box title. The application name is added to the title. The default title is i18n('Warning'). 
.br
\fIbuttonContinue\fP The text for the first button. 
.br
\fIdontAskAgainName\fP 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 \fCdontAskAgainName\fP starts with a ':' then the setting is stored in the global config file. 
.br
\fIoptions\fP see OptionsType
.RE
.PP
The second button always has the text 'Cancel'.
.PP
\fBReturns:\fP
.RS 4
\fCContinue\fP is returned if the Continue-button is pressed. \fCCancel\fP is returned if the Cancel-button is pressed.
.RE
.PP
To be used for questions like 'You are about to Print. Are you sure?' the continueButton should then be labeled 'Print'.
.PP
The default button is buttonContinue. Pressing 'Esc' selects 'Cancel'. 
.PP
Definition at line 587 of file kmessagebox.cpp.
.PP
References warningContinueCancelList().
.SS "int KMessageBox::warningContinueCancelWId (WId parent_id, const \fBQString\fP & text, const \fBQString\fP & caption = \fCQString::null\fP, const \fBKGuiItem\fP & buttonContinue = \fCKStdGuiItem::cont()\fP, const \fBQString\fP & dontAskAgainName = \fCQString::null\fP, int options = \fCNotify\fP)\fC [static]\fP"
.PP
This function accepts the window id of the parent window, instead of QWidget*. 
.PP
It should be used only when necessary. 
.PP
\fBSince:\fP
.RS 4
3.2 
.RE
.PP

.PP
Definition at line 599 of file kmessagebox.cpp.
.PP
References warningContinueCancelListWId().
.PP
Referenced by messageBoxWId().
.SS "int KMessageBox::warningContinueCancelList (\fBQWidget\fP * parent, const \fBQString\fP & text, const \fBQStringList\fP & strlist, const \fBQString\fP & caption = \fCQString::null\fP, const \fBKGuiItem\fP & buttonContinue = \fCKStdGuiItem::cont()\fP, const \fBQString\fP & dontAskAgainName = \fCQString::null\fP, int options = \fCNotify\fP)\fC [static]\fP"
.PP
Display a 'warning' dialog with a listbox to show information to the user. 
.PP
\fBParameters:\fP
.RS 4
\fIparent\fP If \fCparent\fP is 0, then the message box becomes an application-global modal dialog box. If \fCparent\fP is a widget, the message box becomes modal relative to parent. 
.br
\fItext\fP Message string. 
.br
\fIstrlist\fP List of strings to be written in the listbox. If the list is empty, it doesn't show any listbox, working as warningContinueCancel. 
.br
\fIcaption\fP Message box title. The application name is added to the title. The default title is i18n('Warning'). 
.br
\fIbuttonContinue\fP The text for the first button. 
.br
\fIdontAskAgainName\fP 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 \fCdontAskAgainName\fP starts with a ':' then the setting is stored in the global config file.
.br
\fIoptions\fP see OptionsType
.RE
.PP
The second button always has the text 'Cancel'.
.PP
\fBReturns:\fP
.RS 4
\fCContinue\fP is returned if the Continue-button is pressed. \fCCancel\fP is returned if the Cancel-button is pressed.
.RE
.PP
To be used for questions like 'You are about to Print. Are you sure?' the continueButton should then be labeled 'Print'.
.PP
The default button is buttonContinue. Pressing 'Esc' selects 'Cancel'. 
.PP
Definition at line 611 of file kmessagebox.cpp.
.PP
References warningContinueCancelListWId().
.PP
Referenced by warningContinueCancel().
.SS "int KMessageBox::warningContinueCancelListWId (WId parent_id, const \fBQString\fP & text, const \fBQStringList\fP & strlist, const \fBQString\fP & caption = \fCQString::null\fP, const \fBKGuiItem\fP & buttonContinue = \fCKStdGuiItem::cont()\fP, const \fBQString\fP & dontAskAgainName = \fCQString::null\fP, int options = \fCNotify\fP)\fC [static]\fP"
.PP
This function accepts the window id of the parent window, instead of QWidget*. 
.PP
It should be used only when necessary. 
.PP
\fBSince:\fP
.RS 4
3.2 
.RE
.PP

.PP
Definition at line 623 of file kmessagebox.cpp.
.PP
References createKMessageBox(), QWidget::find(), PlainCaption, saveDontShowAgainContinue(), KDialog::setPlainCaption(), and shouldBeShownContinue().
.PP
Referenced by warningContinueCancelList(), and warningContinueCancelWId().
.SS "int KMessageBox::warningYesNoCancel (\fBQWidget\fP * parent, const \fBQString\fP & text, const \fBQString\fP & caption = \fCQString::null\fP, const \fBKGuiItem\fP & buttonYes = \fCKStdGuiItem::yes()\fP, const \fBKGuiItem\fP & buttonNo = \fCKStdGuiItem::no()\fP, const \fBQString\fP & dontAskAgainName = \fCQString::null\fP, int options = \fCNotify\fP)\fC [static]\fP"
.PP
Display a Yes/No/Cancel 'warning' dialog. 
.PP
\fBParameters:\fP
.RS 4
\fIparent\fP If \fCparent\fP is 0, then the message box becomes an application-global modal dialog box. If \fCparent\fP is a widget, the message box becomes modal relative to parent. 
.br
\fItext\fP Message string. 
.br
\fIcaption\fP Message box title. The application name is added to the title. The default title is i18n('Warning'). 
.br
\fIbuttonYes\fP The text for the first button. The default is i18n('&Yes'). 
.br
\fIbuttonNo\fP The text for the second button. The default is i18n('&No'). 
.br
\fIdontAskAgainName\fP 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 \fCdontAskAgainName\fP starts with a ':' then the setting is stored in the global config file. 
.br
\fIoptions\fP see OptionsType
.RE
.PP
\fBReturns:\fP
.RS 4
\fCYes\fP is returned if the Yes-button is pressed. \fCNo\fP is returned if the No-button is pressed. \fCCancel\fP is retunred if the Cancel- button is pressed.
.RE
.PP
To be used for questions 'Do you want to save your changes?' The text should explain the implication of choosing 'No'.
.PP
The default button is 'Yes'. Pressing 'Esc' selects 'Cancel'
.PP
NOTE: The cancel button will always have the i18n'ed text '&Cancel'. 
.PP
Definition at line 660 of file kmessagebox.cpp.
.PP
References warningYesNoCancelList().
.SS "int KMessageBox::warningYesNoCancelWId (WId parent_id, const \fBQString\fP & text, const \fBQString\fP & caption = \fCQString::null\fP, const \fBKGuiItem\fP & buttonYes = \fCKStdGuiItem::yes()\fP, const \fBKGuiItem\fP & buttonNo = \fCKStdGuiItem::no()\fP, const \fBQString\fP & dontAskAgainName = \fCQString::null\fP, int options = \fCNotify\fP)\fC [static]\fP"
.PP
This function accepts the window id of the parent window, instead of QWidget*. 
.PP
It should be used only when necessary. 
.PP
\fBSince:\fP
.RS 4
3.2 
.RE
.PP

.PP
Definition at line 672 of file kmessagebox.cpp.
.PP
References warningYesNoCancelListWId().
.PP
Referenced by messageBoxWId().
.SS "int KMessageBox::warningYesNoCancelList (\fBQWidget\fP * parent, const \fBQString\fP & text, const \fBQStringList\fP & strlist, const \fBQString\fP & caption = \fCQString::null\fP, const \fBKGuiItem\fP & buttonYes = \fCKStdGuiItem::yes()\fP, const \fBKGuiItem\fP & buttonNo = \fCKStdGuiItem::no()\fP, const \fBQString\fP & dontAskAgainName = \fCQString::null\fP, int options = \fCNotify\fP)\fC [static]\fP"
.PP
Display a Yes/No/Cancel 'warning' dialog with a listbox to show information to the user. 
.PP
\fBParameters:\fP
.RS 4
\fIparent\fP If \fCparent\fP is 0, then the message box becomes an application-global modal dialog box. If \fCparent\fP is a widget, the message box becomes modal relative to parent. 
.br
\fItext\fP Message string. 
.br
\fIstrlist\fP List of strings to be written in the listbox. If the list is empty, it doesn't show any listbox, working as warningYesNoCancel. 
.br
\fIcaption\fP Message box title. The application name is added to the title. The default title is i18n('Warning'). 
.br
\fIbuttonYes\fP The text for the first button. The default is i18n('&Yes'). 
.br
\fIbuttonNo\fP The text for the second button. The default is i18n('&No'). 
.br
\fIdontAskAgainName\fP 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 \fCdontAskAgainName\fP starts with a ':' then the setting is stored in the global config file. 
.br
\fIoptions\fP see OptionsType
.RE
.PP
\fBReturns:\fP
.RS 4
\fCYes\fP is returned if the Yes-button is pressed. \fCNo\fP is returned if the No-button is pressed. \fCCancel\fP is retunred if the Cancel- button is pressed.
.RE
.PP
To be used for questions 'Do you want to save your changes?' The text should explain the implication of choosing 'No'.
.PP
The default button is 'Yes'. Pressing 'Esc' selects 'Cancel'
.PP
NOTE: The cancel button will always have the i18n'ed text '&Cancel'.
.PP
\fBSince:\fP
.RS 4
3.2 
.RE
.PP

.PP
Definition at line 684 of file kmessagebox.cpp.
.PP
References warningYesNoCancelListWId().
.PP
Referenced by warningYesNoCancel().
.SS "int KMessageBox::warningYesNoCancelListWId (WId parent_id, const \fBQString\fP & text, const \fBQStringList\fP & strlist, const \fBQString\fP & caption = \fCQString::null\fP, const \fBKGuiItem\fP & buttonYes = \fCKStdGuiItem::yes()\fP, const \fBKGuiItem\fP & buttonNo = \fCKStdGuiItem::no()\fP, const \fBQString\fP & dontAskAgainName = \fCQString::null\fP, int options = \fCNotify\fP)\fC [static]\fP"
.PP
This function accepts the window id of the parent window, instead of QWidget*. 
.PP
It should be used only when necessary. 
.PP
\fBSince:\fP
.RS 4
3.2 
.RE
.PP

.PP
Definition at line 697 of file kmessagebox.cpp.
.PP
References createKMessageBox(), QWidget::find(), PlainCaption, saveDontShowAgainYesNo(), KDialog::setPlainCaption(), and shouldBeShownYesNo().
.PP
Referenced by warningYesNoCancelList(), and warningYesNoCancelWId().
.SS "void KMessageBox::error (\fBQWidget\fP * parent, const \fBQString\fP & text, const \fBQString\fP & caption = \fCQString::null\fP, int options = \fCNotify\fP)\fC [static]\fP"
.PP
Display an 'Error' dialog. 
.PP
\fBParameters:\fP
.RS 4
\fIparent\fP If \fCparent\fP is 0, then the message box becomes an application-global modal dialog box. If \fCparent\fP is a widget, the message box becomes modal relative to parent. 
.br
\fItext\fP Message string. 
.br
\fIcaption\fP Message box title. The application name is added to the title. The default title is i18n('Error'). 
.br
\fIoptions\fP see OptionsType
.RE
.PP
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.'
.PP
If your program detects the action specified by the user is somehow not allowed, this should never be reported with \fBerror()\fP. Use \fBsorry()\fP instead to explain to the user that this action is not allowed.
.PP
The default button is '&OK'. Pressing 'Esc' selects the OK-button.
.PP
NOTE: The OK button will always have the i18n'ed text '&OK'. 
.PP
Definition at line 736 of file kmessagebox.cpp.
.PP
References errorListWId().
.PP
Referenced by KBugReport::slotOk().
.SS "void KMessageBox::errorWId (WId parent_id, const \fBQString\fP & text, const \fBQString\fP & caption = \fCQString::null\fP, int options = \fCNotify\fP)\fC [static]\fP"
.PP
This function accepts the window id of the parent window, instead of QWidget*. 
.PP
It should be used only when necessary.
.PP
\fBSince:\fP
.RS 4
3.2 
.RE
.PP

.PP
Definition at line 743 of file kmessagebox.cpp.
.PP
References errorListWId().
.PP
Referenced by messageBoxWId().
.SS "void KMessageBox::errorList (\fBQWidget\fP * parent, const \fBQString\fP & text, const \fBQStringList\fP & strlist, const \fBQString\fP & caption = \fCQString::null\fP, int options = \fCNotify\fP)\fC [static]\fP"
.PP
Display an 'Error' dialog with a listbox. 
.PP
\fBParameters:\fP
.RS 4
\fIparent\fP If \fCparent\fP is 0, then the message box becomes an application-global modal dialog box. If \fCparent\fP is a widget, the message box becomes modal relative to parent. 
.br
\fItext\fP Message string. 
.br
\fIstrlist\fP List of strings to be written in the listbox. If the list is empty, it doesn't show any listbox, working as \fBerror()\fP. 
.br
\fIcaption\fP Message box title. The application name is added to the title. The default title is i18n('Error'). 
.br
\fIoptions\fP see OptionsType
.RE
.PP
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.'
.PP
If your program detects the action specified by the user is somehow not allowed, this should never be reported with \fBerror()\fP. Use \fBsorry()\fP instead to explain to the user that this action is not allowed.
.PP
The default button is '&OK'. Pressing 'Esc' selects the OK-button.
.PP
NOTE: The OK button will always have the i18n'ed text '&OK'.
.PP
\fBSince:\fP
.RS 4
3.4 
.RE
.PP

.PP
Definition at line 750 of file kmessagebox.cpp.
.PP
References errorListWId().
.SS "void KMessageBox::errorListWId (WId parent_id, const \fBQString\fP & text, const \fBQStringList\fP & strlist, const \fBQString\fP & caption = \fCQString::null\fP, int options = \fCNotify\fP)\fC [static]\fP"
.PP
This function accepts the window id of the parent window, instead of QWidget*. 
.PP
It should be used only when necessary. 
.PP
\fBSince:\fP
.RS 4
3.4 
.RE
.PP

.PP
Definition at line 757 of file kmessagebox.cpp.
.PP
References createKMessageBox(), QWidget::find(), PlainCaption, and KDialog::setPlainCaption().
.PP
Referenced by error(), errorList(), and errorWId().
.SS "void KMessageBox::detailedError (\fBQWidget\fP * parent, const \fBQString\fP & text, const \fBQString\fP & details, const \fBQString\fP & caption = \fCQString::null\fP, int options = \fCNotify\fP)\fC [static]\fP"
.PP
Displays an 'Error' dialog with a 'Details >>' button. 
.PP
\fBParameters:\fP
.RS 4
\fIparent\fP If \fCparent\fP is 0, then the message box becomes an application-global modal dialog box. If \fCparent\fP is a widget, the message box becomes modal relative to parent. 
.br
\fItext\fP Message string. 
.br
\fIdetails\fP Detailed message string. 
.br
\fIcaption\fP Message box title. The application name is added to the title. The default title is i18n('Error'). 
.br
\fIoptions\fP see OptionsType
.RE
.PP
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.'
.PP
The \fCdetails\fP message can conatin additional information about the problem and can be shown on request to advanced/interested users.
.PP
If your program detects the action specified by the user is somehow not allowed, this should never be reported with \fBerror()\fP. Use \fBsorry()\fP instead to explain to the user that this action is not allowed.
.PP
The default button is '&OK'. Pressing 'Esc' selects the OK-button.
.PP
NOTE: The OK button will always have the i18n'ed text '&OK'. 
.PP
Definition at line 778 of file kmessagebox.cpp.
.PP
References detailedErrorWId().
.SS "void KMessageBox::detailedErrorWId (WId parent_id, const \fBQString\fP & text, const \fBQString\fP & details, const \fBQString\fP & caption = \fCQString::null\fP, int options = \fCNotify\fP)\fC [static]\fP"
.PP
This function accepts the window id of the parent window, instead of QWidget*. 
.PP
It should be used only when necessary. 
.PP
\fBSince:\fP
.RS 4
3.2 
.RE
.PP

.PP
Definition at line 786 of file kmessagebox.cpp.
.PP
References createKMessageBox(), QWidget::find(), PlainCaption, and KDialog::setPlainCaption().
.PP
Referenced by detailedError(), and queuedDetailedErrorWId().
.SS "void KMessageBox::queuedDetailedError (\fBQWidget\fP * parent, const \fBQString\fP & text, const \fBQString\fP & details, const \fBQString\fP & caption = \fCQString::null\fP)\fC [static]\fP"
.PP
Like detailedError. 
.PP
This function will return immediately, the messagebox will be shown once the application enters an event loop and no other messagebox is being shown.
.PP
Note that if the parent gets deleted, the messagebox will not be shown. 
.PP
Definition at line 808 of file kmessagebox.cpp.
.PP
References queuedDetailedErrorWId().
.SS "void KMessageBox::queuedDetailedErrorWId (WId parent_id, const \fBQString\fP & text, const \fBQString\fP & details, const \fBQString\fP & caption = \fCQString::null\fP)\fC [static]\fP"
.PP
This function accepts the window id of the parent window, instead of QWidget*. 
.PP
It should be used only when necessary. 
.PP
\fBSince:\fP
.RS 4
3.2 
.RE
.PP

.PP
Definition at line 816 of file kmessagebox.cpp.
.PP
References detailedErrorWId().
.PP
Referenced by queuedDetailedError().
.SS "void KMessageBox::sorry (\fBQWidget\fP * parent, const \fBQString\fP & text, const \fBQString\fP & caption = \fCQString::null\fP, int options = \fCNotify\fP)\fC [static]\fP"
.PP
Display an 'Sorry' dialog. 
.PP
\fBParameters:\fP
.RS 4
\fIparent\fP If \fCparent\fP is 0, then the message box becomes an application-global modal dialog box. If \fCparent\fP is a widget, the message box becomes modal relative to parent. 
.br
\fItext\fP Message string. 
.br
\fIcaption\fP Message box title. The application name is added to the title. The default title is i18n('Sorry'). 
.br
\fIoptions\fP see OptionsType
.RE
.PP
Either your program messed up and asks for understanding or your user did something stupid.
.PP
To be used for small problems like 'Sorry, I can't find the file you specified.'
.PP
The default button is '&OK'. Pressing 'Esc' selects the OK-button.
.PP
NOTE: The ok button will always have the i18n'ed text '&OK'. 
.PP
Definition at line 827 of file kmessagebox.cpp.
.PP
References sorryWId().
.PP
Referenced by KPasswordDialog::slotOk().
.SS "void KMessageBox::sorryWId (WId parent_id, const \fBQString\fP & text, const \fBQString\fP & caption = \fCQString::null\fP, int options = \fCNotify\fP)\fC [static]\fP"
.PP
This function accepts the window id of the parent window, instead of QWidget*. 
.PP
It should be used only when necessary. 
.PP
\fBSince:\fP
.RS 4
3.2 
.RE
.PP

.PP
Definition at line 834 of file kmessagebox.cpp.
.PP
References createKMessageBox(), QWidget::find(), PlainCaption, and KDialog::setPlainCaption().
.PP
Referenced by messageBoxWId(), and sorry().
.SS "void KMessageBox::detailedSorry (\fBQWidget\fP * parent, const \fBQString\fP & text, const \fBQString\fP & details, const \fBQString\fP & caption = \fCQString::null\fP, int options = \fCNotify\fP)\fC [static]\fP"
.PP
Displays a 'Sorry' dialog with a 'Details >>' button. 
.PP
\fBParameters:\fP
.RS 4
\fIparent\fP If \fCparent\fP is 0, then the message box becomes an application-global modal dialog box. If \fCparent\fP is a widget, the message box becomes modal relative to parent. 
.br
\fItext\fP Message string. 
.br
\fIdetails\fP Detailed message string. 
.br
\fIcaption\fP Message box title. The application name is added to the title. The default title is i18n('Sorry'). 
.br
\fIoptions\fP see OptionsType
.RE
.PP
Either your program messed up and asks for understanding or your user did something stupid.
.PP
To be used for small problems like 'Sorry, I can't find the file you specified.'
.PP
And then \fCdetails\fP can contain something like 'foobar.txt was not found in any of the following directories: /usr/bin,/usr/local/bin,/usr/sbin'
.PP
The default button is '&OK'. Pressing 'Esc' selects the OK-button.
.PP
NOTE: The ok button will always have the i18n'ed text '&OK'. 
.PP
Definition at line 855 of file kmessagebox.cpp.
.PP
References detailedSorryWId().
.SS "void KMessageBox::detailedSorryWId (WId parent_id, const \fBQString\fP & text, const \fBQString\fP & details, const \fBQString\fP & caption = \fCQString::null\fP, int options = \fCNotify\fP)\fC [static]\fP"
.PP
This function accepts the window id of the parent window, instead of QWidget*. 
.PP
It should be used only when necessary. 
.PP
\fBSince:\fP
.RS 4
3.2 
.RE
.PP

.PP
Definition at line 863 of file kmessagebox.cpp.
.PP
References createKMessageBox(), QWidget::find(), PlainCaption, and KDialog::setPlainCaption().
.PP
Referenced by detailedSorry().
.SS "void KMessageBox::information (\fBQWidget\fP * parent, const \fBQString\fP & text, const \fBQString\fP & caption = \fCQString::null\fP, const \fBQString\fP & dontShowAgainName = \fCQString::null\fP, int options = \fCNotify\fP)\fC [static]\fP"
.PP
Display an 'Information' dialog. 
.PP
\fBParameters:\fP
.RS 4
\fIparent\fP If \fCparent\fP is 0, then the message box becomes an application-global modal dialog box. If \fCparent\fP is a widget, the message box becomes modal relative to parent. 
.br
\fItext\fP Message string. 
.br
\fIcaption\fP Message box title. The application name is added to the title. The default title is i18n('Information'). 
.br
\fIdontShowAgainName\fP 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. 
.br
\fIoptions\fP see OptionsType
.RE
.PP
Your program wants to tell the user something. To be used for things like: 'Your bookmarks have been rearranged.'
.PP
The default button is '&OK'. Pressing 'Esc' selects the OK-button.
.PP
NOTE: The OK button will always have the i18n'ed text '&OK'. 
.PP
Definition at line 885 of file kmessagebox.cpp.
.PP
References informationList().
.PP
Referenced by KBugReport::slotOk().
.SS "void KMessageBox::informationWId (WId parent_id, const \fBQString\fP & text, const \fBQString\fP & caption = \fCQString::null\fP, const \fBQString\fP & dontShowAgainName = \fCQString::null\fP, int options = \fCNotify\fP)\fC [static]\fP"
.PP
This function accepts the window id of the parent window, instead of QWidget*. 
.PP
It should be used only when necessary. 
.PP
\fBSince:\fP
.RS 4
3.2 
.RE
.PP

.PP
Definition at line 892 of file kmessagebox.cpp.
.PP
References informationListWId().
.PP
Referenced by messageBoxWId().
.SS "void KMessageBox::informationList (\fBQWidget\fP * parent, const \fBQString\fP & text, const \fBQStringList\fP & strlist, const \fBQString\fP & caption = \fCQString::null\fP, const \fBQString\fP & dontShowAgainName = \fCQString::null\fP, int options = \fCNotify\fP)\fC [static]\fP"
.PP
Display an 'Information' dialog with a listbox. 
.PP
\fBParameters:\fP
.RS 4
\fIparent\fP If \fCparent\fP is 0, then the message box becomes an application-global modal dialog box. If \fCparent\fP is a widget, the message box becomes modal relative to parent. 
.br
\fItext\fP Message string. 
.br
\fIstrlist\fP List of strings to be written in the listbox. If the list is empty, it doesn't show any listbox, working as information. 
.br
\fIcaption\fP Message box title. The application name is added to the title. The default title is i18n('Information'). 
.br
\fIdontShowAgainName\fP 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. 
.br
\fIoptions\fP see OptionsType
.RE
.PP
Your program wants to tell the user something. To be used for things like: 'The following bookmarks have been rearranged:'
.PP
The default button is '&OK'. Pressing 'Esc' selects the OK-button.
.PP
NOTE: The OK button will always have the i18n'ed text '&OK'. 
.PP
\fBSince:\fP
.RS 4
3.1 
.RE
.PP

.PP
Definition at line 899 of file kmessagebox.cpp.
.PP
References informationListWId().
.PP
Referenced by information().
.SS "void KMessageBox::informationListWId (WId parent_id, const \fBQString\fP & text, const \fBQStringList\fP & strlist, const \fBQString\fP & caption = \fCQString::null\fP, const \fBQString\fP & dontShowAgainName = \fCQString::null\fP, int options = \fCNotify\fP)\fC [static]\fP"
.PP
This function accepts the window id of the parent window, instead of QWidget*. 
.PP
It should be used only when necessary. 
.PP
\fBSince:\fP
.RS 4
3.2 
.RE
.PP

.PP
Definition at line 907 of file kmessagebox.cpp.
.PP
References createKMessageBox(), QWidget::find(), PlainCaption, saveDontShowAgainContinue(), KDialog::setPlainCaption(), and shouldBeShownContinue().
.PP
Referenced by informationList(), and informationWId().
.SS "void KMessageBox::enableAllMessages ()\fC [static]\fP"
.PP
Enable all messages which have been turned off with the \fCdontShowAgainName\fP feature. 
.PP
Definition at line 938 of file kmessagebox.cpp.
.PP
References KGlobal::config(), KConfigBase::deleteEntry(), KConfig::entryMap(), QString::fromLatin1(), KConfigBase::hasGroup(), and KConfigBase::sync().
.SS "void KMessageBox::enableMessage (const \fBQString\fP & dontShowAgainName)\fC [static]\fP"
.PP
Re-enable a specific \fCdontShowAgainName\fP messages that had previously been turned off. 
.PP
\fBSee also:\fP
.RS 4
\fBsaveDontShowAgainYesNo()\fP 
.PP
\fBsaveDontShowAgainContinue()\fP 
.RE
.PP
\fBSince:\fP
.RS 4
3.2 
.RE
.PP

.PP
Definition at line 958 of file kmessagebox.cpp.
.PP
References KGlobal::config(), KConfigBase::deleteEntry(), QString::fromLatin1(), KConfigBase::hasGroup(), and KConfigBase::sync().
.SS "void KMessageBox::about (\fBQWidget\fP * parent, const \fBQString\fP & text, const \fBQString\fP & caption = \fCQString::null\fP, int options = \fCNotify\fP)\fC [static]\fP"
.PP
Display an 'About' dialog. 
.PP
\fBParameters:\fP
.RS 4
\fIparent\fP If \fCparent\fP is 0, then the message box becomes an application-global modal dialog box. If \fCparent\fP is a widget, the message box becomes modal relative to parent. 
.br
\fItext\fP Message string. 
.br
\fIcaption\fP Message box title. The application name is added to the title. The default title is i18n('About \\<appname\\>'). 
.br
\fIoptions\fP see OptionsType
.RE
.PP
Your program wants to show some general information about the application like the authors's names and email addresses.
.PP
The default button is '&OK'.
.PP
NOTE: The ok button will always have the i18n'ed text '&OK'. 
.PP
Definition at line 972 of file kmessagebox.cpp.
.PP
References QString::arg(), createKMessageBox(), KApplication::icon(), QString::isEmpty(), QPixmap::isNull(), KApplication::kApplication(), and QMessageBox::standardIcon().
.SS "int KMessageBox::messageBox (\fBQWidget\fP * parent, DialogType type, const \fBQString\fP & text, const \fBQString\fP & caption, const \fBKGuiItem\fP & buttonYes, const \fBKGuiItem\fP & buttonNo, const \fBQString\fP & dontShowAskAgainName, int options = \fCNotify\fP)\fC [static]\fP"
.PP
Alternate method to show a messagebox:. 
.PP
\fBParameters:\fP
.RS 4
\fIparent\fP If \fCparent\fP is 0, then the message box becomes an application-global modal dialog box. If \fCparent\fP is a widget, the message box becomes modal relative to parent. 
.br
\fItype\fP type of message box: QuestionYesNo, WarningYesNo, WarningContinueCancel... 
.br
\fItext\fP Message string. 
.br
\fIcaption\fP Message box title. 
.br
\fIbuttonYes\fP The text for the first button. The default is i18n('&Yes'). 
.br
\fIbuttonNo\fP The text for the second button. The default is i18n('&No'). 
.br
\fIdontShowAskAgainName\fP 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. 
.br
\fIoptions\fP see OptionsType Note: for ContinueCancel, buttonYes is the continue button and buttonNo is unused. and for Information, none is used. 
.RE
.PP
\fBReturns:\fP
.RS 4
a button code, as defined in KMessageBox. 
.RE
.PP

.PP
Definition at line 996 of file kmessagebox.cpp.
.PP
References messageBoxWId().
.SS "int KMessageBox::messageBox (\fBQWidget\fP * parent, DialogType type, const \fBQString\fP & text, const \fBQString\fP & caption = \fCQString::null\fP, const \fBKGuiItem\fP & buttonYes = \fCKStdGuiItem::yes()\fP, const \fBKGuiItem\fP & buttonNo = \fCKStdGuiItem::no()\fP, int options = \fCNotify\fP)\fC [static]\fP"
.PP
Alternate method to show a messagebox:. 
.PP
\fBParameters:\fP
.RS 4
\fIparent\fP If \fCparent\fP is 0, then the message box becomes an application-global modal dialog box. If \fCparent\fP is a widget, the message box becomes modal relative to parent. 
.br
\fItype\fP type of message box: QuestionYesNo, WarningYesNo, WarningContinueCancel... 
.br
\fItext\fP Message string. 
.br
\fIcaption\fP Message box title. 
.br
\fIbuttonYes\fP The text for the first button. The default is i18n('&Yes'). 
.br
\fIbuttonNo\fP The text for the second button. The default is i18n('&No'). 
.br
\fIoptions\fP see OptionsType Note: for ContinueCancel, buttonYes is the continue button and buttonNo is unused. and for Information, none is used. 
.RE
.PP
\fBReturns:\fP
.RS 4
a button code, as defined in KMessageBox. 
.RE
.PP

.PP
Definition at line 1005 of file kmessagebox.cpp.
.PP
References messageBoxWId().
.SS "int KMessageBox::messageBoxWId (WId parent_id, DialogType type, const \fBQString\fP & text, const \fBQString\fP & caption = \fCQString::null\fP, const \fBKGuiItem\fP & buttonYes = \fCKStdGuiItem::yes()\fP, const \fBKGuiItem\fP & buttonNo = \fCKStdGuiItem::no()\fP, const \fBQString\fP & dontShowAskAgainName = \fCQString::null\fP, int options = \fCNotify\fP)\fC [static]\fP"
.PP
This function accepts the window id of the parent window, instead of QWidget*. 
.PP
It should be used only when necessary. 
.PP
\fBSince:\fP
.RS 4
3.2 
.RE
.PP

.PP
Definition at line 1013 of file kmessagebox.cpp.
.PP
References errorWId(), informationWId(), questionYesNoCancelWId(), questionYesNoWId(), sorryWId(), warningContinueCancelWId(), warningYesNoCancelWId(), and warningYesNoWId().
.PP
Referenced by messageBox(), and queuedMessageBoxWId().
.SS "void KMessageBox::queuedMessageBox (\fBQWidget\fP * parent, DialogType type, const \fBQString\fP & text, const \fBQString\fP & caption, int options)\fC [static]\fP"
.PP
Like messageBox. 
.PP
Only for message boxes of type Information, Sorry or Error.
.PP
This function will return immediately, the messagebox will be shown once the application enters an event loop and no other messagebox is being shown.
.PP
Note that if the parent gets deleted, the messagebox will not be shown. 
.PP
Definition at line 1050 of file kmessagebox.cpp.
.PP
References queuedMessageBoxWId().
.SS "void KMessageBox::queuedMessageBoxWId (WId parent_id, DialogType type, const \fBQString\fP & text, const \fBQString\fP & caption, int options)\fC [static]\fP"
.PP
This function accepts the window id of the parent window, instead of QWidget*. 
.PP
It should be used only when necessary. 
.PP
\fBSince:\fP
.RS 4
3.2 
.RE
.PP

.PP
Definition at line 1055 of file kmessagebox.cpp.
.PP
References messageBoxWId().
.PP
Referenced by queuedMessageBox().
.SS "void KMessageBox::queuedMessageBox (\fBQWidget\fP * parent, DialogType type, const \fBQString\fP & text, const \fBQString\fP & caption = \fCQString::null\fP)\fC [static]\fP"
.PP
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
.PP
This is an overloaded member function, provided for convenience. It behaves essentially like the above function. 
.PP
Definition at line 1063 of file kmessagebox.cpp.
.PP
References queuedMessageBoxWId().
.SS "void KMessageBox::queuedMessageBoxWId (WId parent_id, DialogType type, const \fBQString\fP & text, const \fBQString\fP & caption = \fCQString::null\fP)\fC [static]\fP"
.PP
This function accepts the window id of the parent window, instead of QWidget*. 
.PP
It should be used only when necessary. 
.PP
\fBSince:\fP
.RS 4
3.2 
.RE
.PP

.PP
Definition at line 1068 of file kmessagebox.cpp.
.PP
References messageBoxWId().
.SS "bool KMessageBox::shouldBeShownYesNo (const \fBQString\fP & dontShowAgainName, \fBButtonCode\fP & result)\fC [static]\fP"
.PP
\fBReturns:\fP
.RS 4
true if the corresponding yes/no message box should be shown. 
.RE
.PP
\fBParameters:\fP
.RS 4
\fIdontShowAgainName\fP the name that identify the message box. If empty, true is always returned. 
.br
\fIresult\fP 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. 
.RE
.PP
\fBSince:\fP
.RS 4
3.2 
.RE
.PP

.PP
Definition at line 343 of file kmessagebox.cpp.
.PP
References KGlobal::config(), QString::fromLatin1(), QString::lower(), and KConfigBase::readEntry().
.PP
Referenced by questionYesNoCancelWId(), questionYesNoListWId(), warningYesNoCancelListWId(), and warningYesNoListWId().
.SS "bool KMessageBox::shouldBeShownContinue (const \fBQString\fP & dontShowAgainName)\fC [static]\fP"
.PP
\fBReturns:\fP
.RS 4
true if the corresponding continue/cancel message box should be shown. 
.RE
.PP
\fBParameters:\fP
.RS 4
\fIdontShowAgainName\fP the name that identify the message box. If empty, true is always returned. 
.RE
.PP
\fBSince:\fP
.RS 4
3.2 
.RE
.PP

.PP
Definition at line 363 of file kmessagebox.cpp.
.PP
References KGlobal::config(), QString::fromLatin1(), and KConfigBase::readBoolEntry().
.PP
Referenced by informationListWId(), and warningContinueCancelListWId().
.SS "void KMessageBox::saveDontShowAgainYesNo (const \fBQString\fP & dontShowAgainName, \fBButtonCode\fP result)\fC [static]\fP"
.PP
Save the fact that the yes/no message box should not be shown again. 
.PP
\fBParameters:\fP
.RS 4
\fIdontShowAgainName\fP the name that identify the message box. If empty, this method does nothing. 
.br
\fIresult\fP the value (Yes or No) that should be used as the result for the message box. 
.RE
.PP
\fBSince:\fP
.RS 4
3.2 
.RE
.PP

.PP
Definition at line 373 of file kmessagebox.cpp.
.PP
References KGlobal::config(), QString::fromLatin1(), KConfigBase::sync(), and KConfigBase::writeEntry().
.PP
Referenced by questionYesNoCancelWId(), questionYesNoListWId(), warningYesNoCancelListWId(), and warningYesNoListWId().
.SS "void KMessageBox::saveDontShowAgainContinue (const \fBQString\fP & dontShowAgainName)\fC [static]\fP"
.PP
Save the fact that the continue/cancel message box should not be shown again. 
.PP
\fBParameters:\fP
.RS 4
\fIdontShowAgainName\fP the name that identify the message box. If empty, this method does nothing. 
.RE
.PP
\fBSince:\fP
.RS 4
3.2 
.RE
.PP

.PP
Definition at line 385 of file kmessagebox.cpp.
.PP
References KGlobal::config(), QString::fromLatin1(), KConfigBase::sync(), and KConfigBase::writeEntry().
.PP
Referenced by informationListWId(), and warningContinueCancelListWId().
.SS "void KMessageBox::setDontShowAskAgainConfig (\fBKConfig\fP * cfg)\fC [static]\fP"
.PP
Use \fCcfg\fP for all settings related to the dontShowAgainName feature. 
.PP
If \fCcfg\fP is 0 (default) \fBKGlobal::config()\fP will be used. 
.PP
\fBSince:\fP
.RS 4
3.2 
.RE
.PP

.PP
Definition at line 397 of file kmessagebox.cpp.
.SS "int KMessageBox::createKMessageBox (\fBKDialogBase\fP * dialog, QMessageBox::Icon icon, const \fBQString\fP & text, const \fBQStringList\fP & strlist, const \fBQString\fP & ask, bool * checkboxReturn, int options, const \fBQString\fP & details = \fCQString::null\fP)\fC [static]\fP"
.PP
Create content and layout of a standard dialog. 
.PP
\fBParameters:\fP
.RS 4
\fIdialog\fP The parent dialog base 
.br
\fIicon\fP Which predefined icon the message box shall show. 
.br
\fItext\fP Message string. 
.br
\fIstrlist\fP List of strings to be written in the listbox. If the list is empty, it doesn't show any listbox 
.br
\fIask\fP The text of the checkbox. If empty none will be shown. 
.br
\fIcheckboxReturn\fP The result of the checkbox. If it's initially true then the checkbox will be checked by default. 
.br
\fIoptions\fP see OptionsType 
.br
\fIdetails\fP Detailed message string. 
.RE
.PP
\fBSince:\fP
.RS 4
3.3 
.RE
.PP
\fBReturns:\fP
.RS 4
A \fBKDialogBase\fP button code, not a KMessageBox button code, based on the buttonmask given to the constructor of the \fCdialog\fP (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. 
.RE
.PP
\fBNote:\fP
.RS 4
The \fCdialog\fP that is passed in is deleted by this function. Do not delete it yourself. 
.RE
.PP

.PP
Definition at line 142 of file kmessagebox.cpp.
.PP
Referenced by about(), detailedErrorWId(), detailedSorryWId(), errorListWId(), informationListWId(), questionYesNoCancelWId(), questionYesNoListWId(), sorryWId(), warningContinueCancelListWId(), warningYesNoCancelListWId(), and warningYesNoListWId().
.SS "int KMessageBox::createKMessageBox (\fBKDialogBase\fP * dialog, \fBQPixmap\fP icon, const \fBQString\fP & text, const \fBQStringList\fP & strlist, const \fBQString\fP & ask, bool * checkboxReturn, int options, const \fBQString\fP & details = \fCQString::null\fP, QMessageBox::Icon notifyType = \fCQMessageBox::Information\fP)\fC [static]\fP"
.PP
Create content and layout of a standard dialog. 
.PP
\fBParameters:\fP
.RS 4
\fIdialog\fP The parent dialog base 
.br
\fIicon\fP A \fBQPixmap\fP containing the icon to be displayed in the dialog next to the text. 
.br
\fItext\fP Message string. 
.br
\fIstrlist\fP List of strings to be written in the listbox. If the list is empty, it doesn't show any listbox 
.br
\fIask\fP The text of the checkbox. If empty none will be shown. 
.br
\fIcheckboxReturn\fP The result of the checkbox. If it's initially true then the checkbox will be checked by default. 
.br
\fIoptions\fP see OptionsType 
.br
\fIdetails\fP Detailed message string. 
.br
\fInotifyType\fP The type of notification to send when this message is presentend. 
.RE
.PP
\fBSince:\fP
.RS 4
3.3 
.RE
.PP
\fBReturns:\fP
.RS 4
A \fBKDialogBase\fP button code, not a KMessageBox button code, based on the buttonmask given to the constructor of the \fCdialog\fP (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. 
.RE
.PP
\fBNote:\fP
.RS 4
The \fCdialog\fP that is passed in is deleted by this function. Do not delete it yourself. 
.RE
.PP

.PP
Definition at line 151 of file kmessagebox.cpp.
.PP
References KGlobalSettings::desktopGeometry(), QObject::disconnect(), QRect::height(), QListBox::insertStringList(), QPushButton::isDefault(), QPixmap::isNull(), NoExec, QLabel::setPixmap(), QTextEdit::setReadOnly(), QListBox::setSelectionMode(), QRect::setWidth(), KActiveLabel::sizeHint(), and QRect::width().

.SH "Author"
.PP 
Generated automatically by Doxygen for kdeui Library from the source code.
