.TH "KMessageBox" 3 "28 Jan 2004" "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
.RI "\fIButton types. \fP"
.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 }"
.br
.RI "\fI.IP "\(bu" 2
Notify Emit a \fBKNotifyClient\fP event (Not yet implemented) 
.IP "\(bu" 2
AllowLink The message may contain links. 
.PP
\fP"
.in -1c
.SS "Static Public Member Functions"

.in +1c
.ti -1c
.RI "int \fBquestionYesNo\fP (\fBQWidget\fP *parent, const  \fBQString\fP &text, const  \fBQString\fP &caption=QString::null, const  KGuiItem &buttonYes=KStdGuiItem::yes(), const  KGuiItem &buttonNo=KStdGuiItem::no(), const  \fBQString\fP &dontAskAgainName=QString::null, int options=Notify)"
.br
.RI "\fIDisplay a simple 'question' dialog. \fP"
.ti -1c
.RI "int \fBquestionYesNoCancel\fP (\fBQWidget\fP *parent, const  \fBQString\fP &text, const  \fBQString\fP &caption=QString::null, const  KGuiItem &buttonYes=KStdGuiItem::yes(), const  KGuiItem &buttonNo=KStdGuiItem::no(), const  \fBQString\fP &dontAskAgainName=QString::null, int options=Notify)"
.br
.RI "\fIDisplay a simple 'question' dialog. \fP"
.ti -1c
.RI "int \fBquestionYesNoList\fP (\fBQWidget\fP *parent, const  \fBQString\fP &text, const  \fBQStringList\fP &strlist, const  \fBQString\fP &caption=QString::null, const  KGuiItem &buttonYes=KStdGuiItem::yes(), const  KGuiItem &buttonNo=KStdGuiItem::no(), const  \fBQString\fP &dontAskAgainName=QString::null, int options=Notify)"
.br
.RI "\fIDisplay a 'question' dialog with a listbox to show information to the user. \fP"
.ti -1c
.RI "int \fBwarningYesNo\fP (\fBQWidget\fP *parent, const  \fBQString\fP &text, const  \fBQString\fP &caption=QString::null, const  KGuiItem &buttonYes=KStdGuiItem::yes(), const  KGuiItem &buttonNo=KStdGuiItem::no(), const  \fBQString\fP &dontAskAgainName=QString::null, int options=Notify)"
.br
.RI "\fIDisplay a 'warning' dialog. \fP"
.ti -1c
.RI "int \fBwarningContinueCancel\fP (\fBQWidget\fP *parent, const  \fBQString\fP &text, const  \fBQString\fP &caption=QString::null, const  KGuiItem &buttonContinue=KStdGuiItem::cont(), const  \fBQString\fP &dontAskAgainName=QString::null, int options=Notify)"
.br
.RI "\fIDisplay a 'warning' dialog. \fP"
.ti -1c
.RI "int \fBwarningContinueCancelList\fP (\fBQWidget\fP *parent, const  \fBQString\fP &text, const  \fBQStringList\fP &strlist, const  \fBQString\fP &caption=QString::null, const  KGuiItem &buttonContinue=KStdGuiItem::cont(), const  \fBQString\fP &dontAskAgainName=QString::null, int options=Notify)"
.br
.RI "\fIDisplay a 'warning' dialog with a listbox to show information to the user. \fP"
.ti -1c
.RI "int \fBwarningYesNoCancel\fP (\fBQWidget\fP *parent, const  \fBQString\fP &text, const  \fBQString\fP &caption=QString::null, const  KGuiItem &buttonYes=KStdGuiItem::yes(), const  KGuiItem &buttonNo=KStdGuiItem::no(), const  \fBQString\fP &dontAskAgainName=QString::null, int options=Notify)"
.br
.RI "\fIDisplay a Yes/No/Cancel 'warning' dialog. \fP"
.ti -1c
.RI "void \fBerror\fP (\fBQWidget\fP *parent, const  \fBQString\fP &text, const  \fBQString\fP &caption=QString::null, int options=Notify)"
.br
.RI "\fIDisplay an 'Error' dialog. \fP"
.ti -1c
.RI "void \fBdetailedError\fP (\fBQWidget\fP *parent, const  \fBQString\fP &text, const  \fBQString\fP &details, const  \fBQString\fP &caption=QString::null, int options=Notify)"
.br
.RI "\fIDisplays an 'Error' dialog with a 'Details >>' button. \fP"
.ti -1c
.RI "void \fBqueuedDetailedError\fP (\fBQWidget\fP *parent, const  \fBQString\fP &text, const  \fBQString\fP &details, const  \fBQString\fP &caption=QString::null)"
.br
.RI "\fILike \fBdetailedError\fP. \fP"
.ti -1c
.RI "void \fBsorry\fP (\fBQWidget\fP *parent, const  \fBQString\fP &text, const  \fBQString\fP &caption=QString::null, int options=Notify)"
.br
.RI "\fIDisplay an 'Sorry' dialog. \fP"
.ti -1c
.RI "void \fBdetailedSorry\fP (\fBQWidget\fP *parent, const  \fBQString\fP &text, const  \fBQString\fP &details, const  \fBQString\fP &caption=QString::null, int options=Notify)"
.br
.RI "\fIDisplays a 'Sorry' dialog with a 'Details >>' button. \fP"
.ti -1c
.RI "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
.RI "\fIDisplay an 'Information' dialog. \fP"
.ti -1c
.RI "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
.RI "\fIDisplay an 'Information' dialog with a listbox. \fP"
.ti -1c
.RI "void \fBenableAllMessages\fP ()"
.br
.RI "\fIEnable all messages which have been turned off with the \fCdontShowAgainName\fP feature of the information dialog. \fP"
.ti -1c
.RI "void \fBabout\fP (\fBQWidget\fP *parent, const  \fBQString\fP &text, const  \fBQString\fP &caption=QString::null, int options=Notify)"
.br
.RI "\fIDisplay an 'About' dialog. \fP"
.ti -1c
.RI "int \fBmessageBox\fP (\fBQWidget\fP *parent, DialogType type, const  \fBQString\fP &text, const  \fBQString\fP &caption=QString::null, const  KGuiItem &buttonYes=KStdGuiItem::yes(), const  KGuiItem &buttonNo=KStdGuiItem::no(), int options=Notify)"
.br
.RI "\fIAlternate method to show a messagebox:. \fP"
.ti -1c
.RI "void \fBqueuedMessageBox\fP (\fBQWidget\fP *parent, DialogType type, const  \fBQString\fP &text, const  \fBQString\fP &caption, int options)"
.br
.ti -1c
.RI "void \fBqueuedMessageBox\fP (\fBQWidget\fP *parent, DialogType type, const  \fBQString\fP &text, const  \fBQString\fP &caption=QString::null)"
.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
\fBVersion:\fP
.RS 4
\fBId\fP.RS 4
\fBkmessagebox.h\fP,v 1.41 2002/10/09 20:44:27 kloecker Exp 
.RE
.PP
.RE
.PP

.PP
Definition at line 42 of file kmessagebox.h.
.SH "Member Enumeration Documentation"
.PP 
.SS "enum \fBKMessageBox::ButtonCode\fP"
.PP
Button types. Definition at line 48 of file kmessagebox.h.
.SS "enum \fBKMessageBox::OptionsType\fP"
.PP
.IP "\(bu" 2
Notify Emit a \fBKNotifyClient\fP event (Not yet implemented) 
.IP "\(bu" 2
AllowLink The message may contain links. 
.PP
Definition at line 74 of file kmessagebox.h.
.SH "Member Function Documentation"
.PP 
.SS "int KMessageBox::questionYesNo (\fBQWidget\fP * parent, const \fBQString\fP & text, const \fBQString\fP & caption = QString::null, const KGuiItem & buttonYes = KStdGuiItem::yes(), const KGuiItem & buttonNo = KStdGuiItem::no(), const \fBQString\fP & dontAskAgainName = QString::null, int options = Notify)\fC [static]\fP"
.PP
Display a simple 'question' dialog. \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. 
.br
\fIoptions\fP see \fBOptionsType\fP
.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'. Definition at line 216 of file kmessagebox.cpp.
.PP
References questionYesNoList().
.PP
Referenced by messageBox(), and KBugReport::slotOk().
.SS "int KMessageBox::questionYesNoCancel (\fBQWidget\fP * parent, const \fBQString\fP & text, const \fBQString\fP & caption = QString::null, const KGuiItem & buttonYes = KStdGuiItem::yes(), const KGuiItem & buttonNo = KStdGuiItem::no(), const \fBQString\fP & dontAskAgainName = QString::null, int options = Notify)\fC [static]\fP"
.PP
Display a simple 'question' dialog. \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. 
.br
\fIoptions\fP see \fBOptionsType\fP
.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'. Definition at line 299 of file kmessagebox.cpp.
.PP
References KGlobal::config(), QString::fromLatin1(), QString::isEmpty(), QString::lower(), KConfigBase::readEntry(), KConfigBase::sync(), and KConfigBase::writeEntry().
.PP
Referenced by messageBox().
.SS "int KMessageBox::questionYesNoList (\fBQWidget\fP * parent, const \fBQString\fP & text, const \fBQStringList\fP & strlist, const \fBQString\fP & caption = QString::null, const KGuiItem & buttonYes = KStdGuiItem::yes(), const KGuiItem & buttonNo = KStdGuiItem::no(), const \fBQString\fP & dontAskAgainName = QString::null, int options = Notify)\fC [static]\fP"
.PP
Display a 'question' dialog with a listbox to show information to the user. \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. 
.br
\fIoptions\fP see \fBOptionsType\fP
.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'. Definition at line 229 of file kmessagebox.cpp.
.PP
References KGlobal::config(), QString::fromLatin1(), QString::isEmpty(), QString::lower(), KConfigBase::readEntry(), KConfigBase::sync(), and KConfigBase::writeEntry().
.PP
Referenced by questionYesNo().
.SS "int KMessageBox::warningYesNo (\fBQWidget\fP * parent, const \fBQString\fP & text, const \fBQString\fP & caption = QString::null, const KGuiItem & buttonYes = KStdGuiItem::yes(), const KGuiItem & buttonNo = KStdGuiItem::no(), const \fBQString\fP & dontAskAgainName = QString::null, int options = Notify)\fC [static]\fP"
.PP
Display a 'warning' dialog. \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. 
.br
\fIoptions\fP see \fBOptionsType\fP
.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'. Definition at line 374 of file kmessagebox.cpp.
.PP
References KGlobal::config(), QString::fromLatin1(), QString::isEmpty(), QString::lower(), KConfigBase::readEntry(), KConfigBase::sync(), and KConfigBase::writeEntry().
.PP
Referenced by messageBox(), and KBugReport::slotCancel().
.SS "int KMessageBox::warningContinueCancel (\fBQWidget\fP * parent, const \fBQString\fP & text, const \fBQString\fP & caption = QString::null, const KGuiItem & buttonContinue = KStdGuiItem::cont(), const \fBQString\fP & dontAskAgainName = QString::null, int options = Notify)\fC [static]\fP"
.PP
Display a 'warning' dialog. \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. 
.br
\fIoptions\fP see \fBOptionsType\fP
.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'. Definition at line 444 of file kmessagebox.cpp.
.PP
References warningContinueCancelList().
.PP
Referenced by messageBox().
.SS "int KMessageBox::warningContinueCancelList (\fBQWidget\fP * parent, const \fBQString\fP & text, const \fBQStringList\fP & strlist, const \fBQString\fP & caption = QString::null, const KGuiItem & buttonContinue = KStdGuiItem::cont(), const \fBQString\fP & dontAskAgainName = QString::null, int options = Notify)\fC [static]\fP"
.PP
Display a 'warning' dialog with a listbox to show information to the user. \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.
.br
\fIoptions\fP see \fBOptionsType\fP
.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'. Definition at line 456 of file kmessagebox.cpp.
.PP
References KGlobal::config(), QString::fromLatin1(), QString::isEmpty(), KConfigBase::readBoolEntry(), KConfigBase::sync(), and KConfigBase::writeEntry().
.PP
Referenced by warningContinueCancel().
.SS "int KMessageBox::warningYesNoCancel (\fBQWidget\fP * parent, const \fBQString\fP & text, const \fBQString\fP & caption = QString::null, const KGuiItem & buttonYes = KStdGuiItem::yes(), const KGuiItem & buttonNo = KStdGuiItem::no(), const \fBQString\fP & dontAskAgainName = QString::null, int options = Notify)\fC [static]\fP"
.PP
Display a Yes/No/Cancel 'warning' dialog. \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. 
.br
\fIoptions\fP see \fBOptionsType\fP
.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'. Definition at line 519 of file kmessagebox.cpp.
.PP
References KGlobal::config(), QString::fromLatin1(), QString::isEmpty(), QString::lower(), KConfigBase::readEntry(), KConfigBase::sync(), and KConfigBase::writeEntry().
.PP
Referenced by messageBox().
.SS "void KMessageBox::error (\fBQWidget\fP * parent, const \fBQString\fP & text, const \fBQString\fP & caption = QString::null, int options = Notify)\fC [static]\fP"
.PP
Display an 'Error' dialog. \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 \fBOptionsType\fP
.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'. Definition at line 592 of file kmessagebox.cpp.
.PP
References QString::isEmpty().
.PP
Referenced by messageBox(), and KBugReport::slotOk().
.SS "void KMessageBox::detailedError (\fBQWidget\fP * parent, const \fBQString\fP & text, const \fBQString\fP & details, const \fBQString\fP & caption = QString::null, int options = Notify)\fC [static]\fP"
.PP
Displays an 'Error' dialog with a 'Details >>' button. \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 \fBOptionsType\fP
.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'. Definition at line 606 of file kmessagebox.cpp.
.PP
References QString::isEmpty().
.PP
Referenced by queuedDetailedError().
.SS "void KMessageBox::queuedDetailedError (\fBQWidget\fP * parent, const \fBQString\fP & text, const \fBQString\fP & details, const \fBQString\fP & caption = QString::null)\fC [static]\fP"
.PP
Like \fBdetailedError\fP. 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. Definition at line 621 of file kmessagebox.cpp.
.PP
References detailedError().
.SS "void KMessageBox::sorry (\fBQWidget\fP * parent, const \fBQString\fP & text, const \fBQString\fP & caption = QString::null, int options = Notify)\fC [static]\fP"
.PP
Display an 'Sorry' dialog. \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 \fBOptionsType\fP
.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'. Definition at line 632 of file kmessagebox.cpp.
.PP
References QString::isEmpty().
.PP
Referenced by messageBox(), and KPasswordDialog::slotOk().
.SS "void KMessageBox::detailedSorry (\fBQWidget\fP * parent, const \fBQString\fP & text, const \fBQString\fP & details, const \fBQString\fP & caption = QString::null, int options = Notify)\fC [static]\fP"
.PP
Displays a 'Sorry' dialog with a 'Details >>' button. \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 \fBOptionsType\fP
.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'. Definition at line 646 of file kmessagebox.cpp.
.PP
References QString::isEmpty().
.SS "void KMessageBox::information (\fBQWidget\fP * parent, const \fBQString\fP & text, const \fBQString\fP & caption = QString::null, const \fBQString\fP & dontShowAgainName = QString::null, int options = Notify)\fC [static]\fP"
.PP
Display an 'Information' dialog. \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 \fBOptionsType\fP
.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'. Definition at line 661 of file kmessagebox.cpp.
.PP
References informationList().
.PP
Referenced by messageBox(), and KBugReport::slotOk().
.SS "void KMessageBox::informationList (\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)\fC [static]\fP"
.PP
Display an 'Information' dialog with a listbox. \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 \fBOptionsType\fP
.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
Definition at line 668 of file kmessagebox.cpp.
.PP
References KGlobal::config(), QString::fromLatin1(), QString::isEmpty(), KConfigBase::readBoolEntry(), KConfigBase::sync(), and KConfigBase::writeEntry().
.PP
Referenced by information().
.SS "void KMessageBox::enableAllMessages ()\fC [static]\fP"
.PP
Enable all messages which have been turned off with the \fCdontShowAgainName\fP feature of the information dialog. Definition at line 714 of file kmessagebox.cpp.
.PP
References KGlobal::config(), KConfig::entryMap(), QString::fromLatin1(), KConfigBase::hasGroup(), KConfigBase::sync(), and KConfigBase::writeEntry().
.SS "void KMessageBox::about (\fBQWidget\fP * parent, const \fBQString\fP & text, const \fBQString\fP & caption = QString::null, int options = Notify)\fC [static]\fP"
.PP
Display an 'About' dialog. \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 \fBOptionsType\fP
.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'. Definition at line 734 of file kmessagebox.cpp.
.PP
References QMessageBox::adjustSize(), QString::arg(), QString::isEmpty(), QMessageBox::setButtonText(), and QMessageBox::setIconPixmap().
.SS "int KMessageBox::messageBox (\fBQWidget\fP * parent, DialogType type, const \fBQString\fP & text, const \fBQString\fP & caption = QString::null, const KGuiItem & buttonYes = KStdGuiItem::yes(), const KGuiItem & buttonNo = KStdGuiItem::no(), int options = Notify)\fC [static]\fP"
.PP
Alternate method to show a messagebox:. \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 \fBOptionsType\fP 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
Definition at line 757 of file kmessagebox.cpp.
.PP
References error(), information(), questionYesNo(), questionYesNoCancel(), sorry(), warningContinueCancel(), warningYesNo(), and warningYesNoCancel().
.PP
Referenced by queuedMessageBox().
.SS "void KMessageBox::queuedMessageBox (\fBQWidget\fP * parent, DialogType type, const \fBQString\fP & text, const \fBQString\fP & caption = QString::null)\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. Definition at line 799 of file kmessagebox.cpp.
.PP
References messageBox().

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