\section{KMessage\-Box Class Reference}
\label{classKMessageBox}\index{KMessageBox@{KMessageBox}}
Easy message dialog box.  


{\tt \#include $<$kmessagebox.h$>$}

Collaboration diagram for KMessage\-Box:\begin{figure}[H]
\begin{center}
\leavevmode
\includegraphics[width=213pt]{classKMessageBox__coll__graph}
\end{center}
\end{figure}
\subsection*{Public Types}
\begin{CompactItemize}
\item 
enum {\bf Button\-Code} \{ \par
{\bf Ok} =  1, 
{\bf Cancel} =  2, 
{\bf Yes} =  3, 
{\bf No} =  4, 
\par
{\bf Continue} =  5
 \}
\item 
enum {\bf Dialog\-Type} \{ \par
{\bf Question\-Yes\-No} =  1, 
{\bf Warning\-Yes\-No} =  2, 
{\bf Warning\-Continue\-Cancel} =  3, 
{\bf Warning\-Yes\-No\-Cancel} =  4, 
\par
{\bf Information} =  5, 
{\bf Sorry} =  7, 
{\bf Error} =  8, 
{\bf Question\-Yes\-No\-Cancel} =  9
 \}
\item 
enum {\bf Options\-Type} \{ \par
{\bf Notify} =  1, 
{\bf Allow\-Link} =  2, 
{\bf Dangerous} =  4, 
{\bf Plain\-Caption} =  8, 
\par
{\bf No\-Exec} =  16
 \}
\end{CompactItemize}
\subsection*{Static Public Member Functions}
\begin{CompactItemize}
\item 
static int {\bf question\-Yes\-No} ({\bf QWidget} $\ast$parent, const {\bf QString} \&text, const {\bf QString} \&caption=QString::null, const {\bf KGui\-Item} \&button\-Yes=KStd\-Gui\-Item::yes(), const {\bf KGui\-Item} \&button\-No=KStd\-Gui\-Item::no(), const {\bf QString} \&dont\-Ask\-Again\-Name=QString::null, int options=Notify)
\item 
static int {\bf question\-Yes\-No\-WId} (WId parent\_\-id, const {\bf QString} \&text, const {\bf QString} \&caption=QString::null, const {\bf KGui\-Item} \&button\-Yes=KStd\-Gui\-Item::yes(), const {\bf KGui\-Item} \&button\-No=KStd\-Gui\-Item::no(), const {\bf QString} \&dont\-Ask\-Again\-Name=QString::null, int options=Notify)
\item 
static int {\bf question\-Yes\-No\-Cancel} ({\bf QWidget} $\ast$parent, const {\bf QString} \&text, const {\bf QString} \&caption=QString::null, const {\bf KGui\-Item} \&button\-Yes=KStd\-Gui\-Item::yes(), const {\bf KGui\-Item} \&button\-No=KStd\-Gui\-Item::no(), const {\bf QString} \&dont\-Ask\-Again\-Name=QString::null, int options=Notify)
\item 
static int {\bf question\-Yes\-No\-Cancel\-WId} (WId parent\_\-id, const {\bf QString} \&text, const {\bf QString} \&caption=QString::null, const {\bf KGui\-Item} \&button\-Yes=KStd\-Gui\-Item::yes(), const {\bf KGui\-Item} \&button\-No=KStd\-Gui\-Item::no(), const {\bf QString} \&dont\-Ask\-Again\-Name=QString::null, int options=Notify)
\item 
static int {\bf question\-Yes\-No\-List} ({\bf QWidget} $\ast$parent, const {\bf QString} \&text, const {\bf QString\-List} \&strlist, const {\bf QString} \&caption=QString::null, const {\bf KGui\-Item} \&button\-Yes=KStd\-Gui\-Item::yes(), const {\bf KGui\-Item} \&button\-No=KStd\-Gui\-Item::no(), const {\bf QString} \&dont\-Ask\-Again\-Name=QString::null, int options=Notify)
\item 
static int {\bf question\-Yes\-No\-List\-WId} (WId parent\_\-id, const {\bf QString} \&text, const {\bf QString\-List} \&strlist, const {\bf QString} \&caption=QString::null, const {\bf KGui\-Item} \&button\-Yes=KStd\-Gui\-Item::yes(), const {\bf KGui\-Item} \&button\-No=KStd\-Gui\-Item::no(), const {\bf QString} \&dont\-Ask\-Again\-Name=QString::null, int options=Notify)
\item 
static int {\bf warning\-Yes\-No} ({\bf QWidget} $\ast$parent, const {\bf QString} \&text, const {\bf QString} \&caption=QString::null, const {\bf KGui\-Item} \&button\-Yes=KStd\-Gui\-Item::yes(), const {\bf KGui\-Item} \&button\-No=KStd\-Gui\-Item::no(), const {\bf QString} \&dont\-Ask\-Again\-Name=QString::null, int options=Notify$|$Dangerous)
\item 
static int {\bf warning\-Yes\-No\-WId} (WId parent\_\-id, const {\bf QString} \&text, const {\bf QString} \&caption=QString::null, const {\bf KGui\-Item} \&button\-Yes=KStd\-Gui\-Item::yes(), const {\bf KGui\-Item} \&button\-No=KStd\-Gui\-Item::no(), const {\bf QString} \&dont\-Ask\-Again\-Name=QString::null, int options=Notify$|$Dangerous)
\item 
static int {\bf warning\-Yes\-No\-List} ({\bf QWidget} $\ast$parent, const {\bf QString} \&text, const {\bf QString\-List} \&strlist, const {\bf QString} \&caption=QString::null, const {\bf KGui\-Item} \&button\-Yes=KStd\-Gui\-Item::yes(), const {\bf KGui\-Item} \&button\-No=KStd\-Gui\-Item::no(), const {\bf QString} \&dont\-Ask\-Again\-Name=QString::null, int options=Notify$|$Dangerous)
\item 
static int {\bf warning\-Yes\-No\-List\-WId} (WId parent\_\-id, const {\bf QString} \&text, const {\bf QString\-List} \&strlist, const {\bf QString} \&caption=QString::null, const {\bf KGui\-Item} \&button\-Yes=KStd\-Gui\-Item::yes(), const {\bf KGui\-Item} \&button\-No=KStd\-Gui\-Item::no(), const {\bf QString} \&dont\-Ask\-Again\-Name=QString::null, int options=Notify$|$Dangerous)
\item 
static int {\bf warning\-Continue\-Cancel} ({\bf QWidget} $\ast$parent, const {\bf QString} \&text, const {\bf QString} \&caption=QString::null, const {\bf KGui\-Item} \&button\-Continue=KStd\-Gui\-Item::cont(), const {\bf QString} \&dont\-Ask\-Again\-Name=QString::null, int options=Notify)
\item 
static int {\bf warning\-Continue\-Cancel\-WId} (WId parent\_\-id, const {\bf QString} \&text, const {\bf QString} \&caption=QString::null, const {\bf KGui\-Item} \&button\-Continue=KStd\-Gui\-Item::cont(), const {\bf QString} \&dont\-Ask\-Again\-Name=QString::null, int options=Notify)
\item 
static int {\bf warning\-Continue\-Cancel\-List} ({\bf QWidget} $\ast$parent, const {\bf QString} \&text, const {\bf QString\-List} \&strlist, const {\bf QString} \&caption=QString::null, const {\bf KGui\-Item} \&button\-Continue=KStd\-Gui\-Item::cont(), const {\bf QString} \&dont\-Ask\-Again\-Name=QString::null, int options=Notify)
\item 
static int {\bf warning\-Continue\-Cancel\-List\-WId} (WId parent\_\-id, const {\bf QString} \&text, const {\bf QString\-List} \&strlist, const {\bf QString} \&caption=QString::null, const {\bf KGui\-Item} \&button\-Continue=KStd\-Gui\-Item::cont(), const {\bf QString} \&dont\-Ask\-Again\-Name=QString::null, int options=Notify)
\item 
static int {\bf warning\-Yes\-No\-Cancel} ({\bf QWidget} $\ast$parent, const {\bf QString} \&text, const {\bf QString} \&caption=QString::null, const {\bf KGui\-Item} \&button\-Yes=KStd\-Gui\-Item::yes(), const {\bf KGui\-Item} \&button\-No=KStd\-Gui\-Item::no(), const {\bf QString} \&dont\-Ask\-Again\-Name=QString::null, int options=Notify)
\item 
static int {\bf warning\-Yes\-No\-Cancel\-WId} (WId parent\_\-id, const {\bf QString} \&text, const {\bf QString} \&caption=QString::null, const {\bf KGui\-Item} \&button\-Yes=KStd\-Gui\-Item::yes(), const {\bf KGui\-Item} \&button\-No=KStd\-Gui\-Item::no(), const {\bf QString} \&dont\-Ask\-Again\-Name=QString::null, int options=Notify)
\item 
static int {\bf warning\-Yes\-No\-Cancel\-List} ({\bf QWidget} $\ast$parent, const {\bf QString} \&text, const {\bf QString\-List} \&strlist, const {\bf QString} \&caption=QString::null, const {\bf KGui\-Item} \&button\-Yes=KStd\-Gui\-Item::yes(), const {\bf KGui\-Item} \&button\-No=KStd\-Gui\-Item::no(), const {\bf QString} \&dont\-Ask\-Again\-Name=QString::null, int options=Notify)
\item 
static int {\bf warning\-Yes\-No\-Cancel\-List\-WId} (WId parent\_\-id, const {\bf QString} \&text, const {\bf QString\-List} \&strlist, const {\bf QString} \&caption=QString::null, const {\bf KGui\-Item} \&button\-Yes=KStd\-Gui\-Item::yes(), const {\bf KGui\-Item} \&button\-No=KStd\-Gui\-Item::no(), const {\bf QString} \&dont\-Ask\-Again\-Name=QString::null, int options=Notify)
\item 
static void {\bf error} ({\bf QWidget} $\ast$parent, const {\bf QString} \&text, const {\bf QString} \&caption=QString::null, int options=Notify)
\item 
static void {\bf error\-WId} (WId parent\_\-id, const {\bf QString} \&text, const {\bf QString} \&caption=QString::null, int options=Notify)
\item 
static void {\bf error\-List} ({\bf QWidget} $\ast$parent, const {\bf QString} \&text, const {\bf QString\-List} \&strlist, const {\bf QString} \&caption=QString::null, int options=Notify)
\item 
static void {\bf error\-List\-WId} (WId parent\_\-id, const {\bf QString} \&text, const {\bf QString\-List} \&strlist, const {\bf QString} \&caption=QString::null, int options=Notify)
\item 
static void {\bf detailed\-Error} ({\bf QWidget} $\ast$parent, const {\bf QString} \&text, const {\bf QString} \&details, const {\bf QString} \&caption=QString::null, int options=Notify)
\item 
static void {\bf detailed\-Error\-WId} (WId parent\_\-id, const {\bf QString} \&text, const {\bf QString} \&details, const {\bf QString} \&caption=QString::null, int options=Notify)
\item 
static void {\bf queued\-Detailed\-Error} ({\bf QWidget} $\ast$parent, const {\bf QString} \&text, const {\bf QString} \&details, const {\bf QString} \&caption=QString::null)
\item 
static void {\bf queued\-Detailed\-Error\-WId} (WId parent\_\-id, const {\bf QString} \&text, const {\bf QString} \&details, const {\bf QString} \&caption=QString::null)
\item 
static void {\bf sorry} ({\bf QWidget} $\ast$parent, const {\bf QString} \&text, const {\bf QString} \&caption=QString::null, int options=Notify)
\item 
static void {\bf sorry\-WId} (WId parent\_\-id, const {\bf QString} \&text, const {\bf QString} \&caption=QString::null, int options=Notify)
\item 
static void {\bf detailed\-Sorry} ({\bf QWidget} $\ast$parent, const {\bf QString} \&text, const {\bf QString} \&details, const {\bf QString} \&caption=QString::null, int options=Notify)
\item 
static void {\bf detailed\-Sorry\-WId} (WId parent\_\-id, const {\bf QString} \&text, const {\bf QString} \&details, const {\bf QString} \&caption=QString::null, int options=Notify)
\item 
static void {\bf information} ({\bf QWidget} $\ast$parent, const {\bf QString} \&text, const {\bf QString} \&caption=QString::null, const {\bf QString} \&dont\-Show\-Again\-Name=QString::null, int options=Notify)
\item 
static void {\bf information\-WId} (WId parent\_\-id, const {\bf QString} \&text, const {\bf QString} \&caption=QString::null, const {\bf QString} \&dont\-Show\-Again\-Name=QString::null, int options=Notify)
\item 
static void {\bf information\-List} ({\bf QWidget} $\ast$parent, const {\bf QString} \&text, const {\bf QString\-List} \&strlist, const {\bf QString} \&caption=QString::null, const {\bf QString} \&dont\-Show\-Again\-Name=QString::null, int options=Notify)
\item 
static void {\bf information\-List\-WId} (WId parent\_\-id, const {\bf QString} \&text, const {\bf QString\-List} \&strlist, const {\bf QString} \&caption=QString::null, const {\bf QString} \&dont\-Show\-Again\-Name=QString::null, int options=Notify)
\item 
static void {\bf enable\-All\-Messages} ()
\item 
static void {\bf enable\-Message} (const {\bf QString} \&dont\-Show\-Again\-Name)
\item 
static void {\bf about} ({\bf QWidget} $\ast$parent, const {\bf QString} \&text, const {\bf QString} \&caption=QString::null, int options=Notify)
\item 
static int {\bf message\-Box} ({\bf QWidget} $\ast$parent, Dialog\-Type type, const {\bf QString} \&text, const {\bf QString} \&caption, const {\bf KGui\-Item} \&button\-Yes, const {\bf KGui\-Item} \&button\-No, const {\bf QString} \&dont\-Show\-Ask\-Again\-Name, int options=Notify)
\item 
static int {\bf message\-Box} ({\bf QWidget} $\ast$parent, Dialog\-Type type, const {\bf QString} \&text, const {\bf QString} \&caption=QString::null, const {\bf KGui\-Item} \&button\-Yes=KStd\-Gui\-Item::yes(), const {\bf KGui\-Item} \&button\-No=KStd\-Gui\-Item::no(), int options=Notify)
\item 
static int {\bf message\-Box\-WId} (WId parent\_\-id, Dialog\-Type type, const {\bf QString} \&text, const {\bf QString} \&caption=QString::null, const {\bf KGui\-Item} \&button\-Yes=KStd\-Gui\-Item::yes(), const {\bf KGui\-Item} \&button\-No=KStd\-Gui\-Item::no(), const {\bf QString} \&dont\-Show\-Ask\-Again\-Name=QString::null, int options=Notify)
\item 
static void {\bf queued\-Message\-Box} ({\bf QWidget} $\ast$parent, Dialog\-Type type, const {\bf QString} \&text, const {\bf QString} \&caption, int options)
\item 
static void {\bf queued\-Message\-Box\-WId} (WId parent\_\-id, Dialog\-Type type, const {\bf QString} \&text, const {\bf QString} \&caption, int options)
\item 
static void {\bf queued\-Message\-Box} ({\bf QWidget} $\ast$parent, Dialog\-Type type, const {\bf QString} \&text, const {\bf QString} \&caption=QString::null)
\item 
static void {\bf queued\-Message\-Box\-WId} (WId parent\_\-id, Dialog\-Type type, const {\bf QString} \&text, const {\bf QString} \&caption=QString::null)
\item 
static bool {\bf should\-Be\-Shown\-Yes\-No} (const {\bf QString} \&dont\-Show\-Again\-Name, {\bf Button\-Code} \&result)
\item 
static bool {\bf should\-Be\-Shown\-Continue} (const {\bf QString} \&dont\-Show\-Again\-Name)
\item 
static void {\bf save\-Dont\-Show\-Again\-Yes\-No} (const {\bf QString} \&dont\-Show\-Again\-Name, {\bf Button\-Code} result)
\item 
static void {\bf save\-Dont\-Show\-Again\-Continue} (const {\bf QString} \&dont\-Show\-Again\-Name)
\item 
static void {\bf set\-Dont\-Show\-Ask\-Again\-Config} ({\bf KConfig} $\ast$cfg)
\item 
static int {\bf create\-KMessage\-Box} ({\bf KDialog\-Base} $\ast$dialog, QMessage\-Box::Icon icon, const {\bf QString} \&text, const {\bf QString\-List} \&strlist, const {\bf QString} \&ask, bool $\ast$checkbox\-Return, int options, const {\bf QString} \&details=QString::null)
\item 
static int {\bf create\-KMessage\-Box} ({\bf KDialog\-Base} $\ast$dialog, {\bf QPixmap} icon, const {\bf QString} \&text, const {\bf QString\-List} \&strlist, const {\bf QString} \&ask, bool $\ast$checkbox\-Return, int options, const {\bf QString} \&details=QString::null, QMessage\-Box::Icon notify\-Type=QMessage\-Box::Information)
\end{CompactItemize}


\subsection{Detailed Description}
Easy message dialog box. 

Provides convenience functions for some i18n'ed standard dialogs.

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

\begin{Desc}
\item[Author:]Waldo Bastian ({\tt bastian@kde.org}) \end{Desc}




Definition at line 44 of file kmessagebox.h.

\subsection{Member Enumeration Documentation}
\index{KMessageBox@{KMessage\-Box}!ButtonCode@{ButtonCode}}
\index{ButtonCode@{ButtonCode}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}enum {\bf KMessage\-Box::Button\-Code}}\label{classKMessageBox_w18}


Button types. 



Definition at line 50 of file kmessagebox.h.\index{KMessageBox@{KMessage\-Box}!OptionsType@{OptionsType}}
\index{OptionsType@{OptionsType}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}enum {\bf KMessage\-Box::Options\-Type}}\label{classKMessageBox_w20}


\begin{itemize}
\item Notify Emit a {\bf KNotify\-Client} event \item Allow\-Link The message may contain links. \end{itemize}


\begin{itemize}
\item Dangerous The action to be confirmed by the dialog is a potentially destructive one \item Plain\-Caption Do not use {\bf KApplication::make\-Std\-Caption()} \item No\-Exec Do not call exec() in {\bf create\-KMessage\-Box()}{\rm (p.\,\pageref{classKMessageBox_e49})} \end{itemize}
\begin{Desc}
\item[Enumeration values: ]\par
\begin{description}
\index{PlainCaption@{PlainCaption}!KMessageBox@{KMessageBox}}\index{KMessageBox@{KMessageBox}!PlainCaption@{PlainCaption}}\item[{\em 
Plain\-Caption\label{classKMessageBox_w20w16}
}]\begin{Desc}
\item[Since:]3.4 \end{Desc}
\index{NoExec@{NoExec}!KMessageBox@{KMessageBox}}\index{KMessageBox@{KMessageBox}!NoExec@{NoExec}}\item[{\em 
No\-Exec\label{classKMessageBox_w20w17}
}]\begin{Desc}
\item[Since:]3.4 \end{Desc}
\end{description}
\end{Desc}



Definition at line 79 of file kmessagebox.h.

\subsection{Member Function Documentation}
\index{KMessageBox@{KMessage\-Box}!questionYesNo@{questionYesNo}}
\index{questionYesNo@{questionYesNo}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}int KMessage\-Box::question\-Yes\-No ({\bf QWidget} $\ast$ {\em parent}, const {\bf QString} \& {\em text}, const {\bf QString} \& {\em caption} = {\tt QString::null}, const {\bf KGui\-Item} \& {\em button\-Yes} = {\tt KStdGuiItem::yes()}, const {\bf KGui\-Item} \& {\em button\-No} = {\tt KStdGuiItem::no()}, const {\bf QString} \& {\em dont\-Ask\-Again\-Name} = {\tt QString::null}, int {\em options} = {\tt Notify})\hspace{0.3cm}{\tt  [static]}}\label{classKMessageBox_e0}


Display a simple \char`\"{}question\char`\"{} dialog. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em parent}]If {\tt parent} is 0, then the message box becomes an application-global modal dialog box. If {\tt parent} is a widget, the message box becomes modal relative to parent. \item[{\em text}]Message string. \item[{\em caption}]Message box title. The application name is added to the title. The default title is i18n(\char`\"{}Question\char`\"{}). \item[{\em button\-Yes}]The text for the first button. The default is i18n(\char`\"{}\&Yes\char`\"{}). \item[{\em button\-No}]The text for the second button. The default is i18n(\char`\"{}\&No\char`\"{}). \item[{\em dont\-Ask\-Again\-Name}]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 \char`\"{}Notification Messages\char`\"{} group. If {\tt dont\-Ask\-Again\-Name} starts with a ':' then the setting is stored in the global config file. \item[{\em options}]see Options\-Type\end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]'Yes' is returned if the Yes-button is pressed. 'No' is returned if the No-button is pressed.\end{Desc}
To be used for questions like \char`\"{}Do you have a printer?\char`\"{}

The default button is \char`\"{}Yes\char`\"{}. Pressing \char`\"{}Esc\char`\"{} selects \char`\"{}No\char`\"{}. 

Definition at line 319 of file kmessagebox.cpp.

References question\-Yes\-No\-List().\index{KMessageBox@{KMessage\-Box}!questionYesNoWId@{questionYesNoWId}}
\index{questionYesNoWId@{questionYesNoWId}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}int KMessage\-Box::question\-Yes\-No\-WId (WId {\em parent\_\-id}, const {\bf QString} \& {\em text}, const {\bf QString} \& {\em caption} = {\tt QString::null}, const {\bf KGui\-Item} \& {\em button\-Yes} = {\tt KStdGuiItem::yes()}, const {\bf KGui\-Item} \& {\em button\-No} = {\tt KStdGuiItem::no()}, const {\bf QString} \& {\em dont\-Ask\-Again\-Name} = {\tt QString::null}, int {\em options} = {\tt Notify})\hspace{0.3cm}{\tt  [static]}}\label{classKMessageBox_e1}


This function accepts the window id of the parent window, instead of QWidget$\ast$. 

It should be used only when necessary. \begin{Desc}
\item[Since:]3.2 \end{Desc}


Definition at line 331 of file kmessagebox.cpp.

References question\-Yes\-No\-List\-WId().

Referenced by message\-Box\-WId().\index{KMessageBox@{KMessage\-Box}!questionYesNoCancel@{questionYesNoCancel}}
\index{questionYesNoCancel@{questionYesNoCancel}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}int KMessage\-Box::question\-Yes\-No\-Cancel ({\bf QWidget} $\ast$ {\em parent}, const {\bf QString} \& {\em text}, const {\bf QString} \& {\em caption} = {\tt QString::null}, const {\bf KGui\-Item} \& {\em button\-Yes} = {\tt KStdGuiItem::yes()}, const {\bf KGui\-Item} \& {\em button\-No} = {\tt KStdGuiItem::no()}, const {\bf QString} \& {\em dont\-Ask\-Again\-Name} = {\tt QString::null}, int {\em options} = {\tt Notify})\hspace{0.3cm}{\tt  [static]}}\label{classKMessageBox_e2}


Display a simple \char`\"{}question\char`\"{} dialog. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em parent}]If {\tt parent} is 0, then the message box becomes an application-global modal dialog box. If {\tt parent} is a widget, the message box becomes modal relative to parent. \item[{\em text}]Message string. \item[{\em caption}]Message box title. The application name is added to the title. The default title is i18n(\char`\"{}Question\char`\"{}). \item[{\em button\-Yes}]The text for the first button. The default is i18n(\char`\"{}\&Yes\char`\"{}). \item[{\em button\-No}]The text for the second button. The default is i18n(\char`\"{}\&No\char`\"{}). \item[{\em dont\-Ask\-Again\-Name}]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 \char`\"{}Notification Messages\char`\"{} group. If {\tt dont\-Ask\-Again\-Name} starts with a ':' then the setting is stored in the global config file. \item[{\em options}]see Options\-Type\end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]'Yes' is returned if the Yes-button is pressed. 'No' is returned if the No-button is pressed.\end{Desc}
To be used for questions like \char`\"{}Do you want to discard the message or save it for later?\char`\"{},

The default button is \char`\"{}Yes\char`\"{}. Pressing \char`\"{}Esc\char`\"{} selects \char`\"{}Cancel\char`\"{}.

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

Definition at line 454 of file kmessagebox.cpp.

References question\-Yes\-No\-Cancel\-WId().\index{KMessageBox@{KMessage\-Box}!questionYesNoCancelWId@{questionYesNoCancelWId}}
\index{questionYesNoCancelWId@{questionYesNoCancelWId}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}int KMessage\-Box::question\-Yes\-No\-Cancel\-WId (WId {\em parent\_\-id}, const {\bf QString} \& {\em text}, const {\bf QString} \& {\em caption} = {\tt QString::null}, const {\bf KGui\-Item} \& {\em button\-Yes} = {\tt KStdGuiItem::yes()}, const {\bf KGui\-Item} \& {\em button\-No} = {\tt KStdGuiItem::no()}, const {\bf QString} \& {\em dont\-Ask\-Again\-Name} = {\tt QString::null}, int {\em options} = {\tt Notify})\hspace{0.3cm}{\tt  [static]}}\label{classKMessageBox_e3}


This function accepts the window id of the parent window, instead of QWidget$\ast$. 

It should be used only when necessary. \begin{Desc}
\item[Since:]3.2 \end{Desc}


Definition at line 467 of file kmessagebox.cpp.

References create\-KMessage\-Box(), QWidget::find(), Plain\-Caption, save\-Dont\-Show\-Again\-Yes\-No(), KDialog::set\-Plain\-Caption(), and should\-Be\-Shown\-Yes\-No().

Referenced by message\-Box\-WId(), and question\-Yes\-No\-Cancel().\index{KMessageBox@{KMessage\-Box}!questionYesNoList@{questionYesNoList}}
\index{questionYesNoList@{questionYesNoList}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}int KMessage\-Box::question\-Yes\-No\-List ({\bf QWidget} $\ast$ {\em parent}, const {\bf QString} \& {\em text}, const {\bf QString\-List} \& {\em strlist}, const {\bf QString} \& {\em caption} = {\tt QString::null}, const {\bf KGui\-Item} \& {\em button\-Yes} = {\tt KStdGuiItem::yes()}, const {\bf KGui\-Item} \& {\em button\-No} = {\tt KStdGuiItem::no()}, const {\bf QString} \& {\em dont\-Ask\-Again\-Name} = {\tt QString::null}, int {\em options} = {\tt Notify})\hspace{0.3cm}{\tt  [static]}}\label{classKMessageBox_e4}


Display a \char`\"{}question\char`\"{} dialog with a listbox to show information to the user. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em parent}]If {\tt parent} is 0, then the message box becomes an application-global modal dialog box. If {\tt parent} is a widget, the message box becomes modal relative to parent. \item[{\em text}]Message string. \item[{\em strlist}]List of strings to be written in the listbox. If the list is empty, it doesn't show any listbox, working as question\-Yes\-No. \item[{\em caption}]Message box title. The application name is added to the title. The default title is i18n(\char`\"{}Question\char`\"{}). \item[{\em button\-Yes}]The text for the first button. The default is i18n(\char`\"{}\&Yes\char`\"{}). \item[{\em button\-No}]The text for the second button. The default is i18n(\char`\"{}\&No\char`\"{}). \item[{\em dont\-Ask\-Again\-Name}]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 \char`\"{}Notification Messages\char`\"{} group. If {\tt dont\-Ask\-Again\-Name} starts with a ':' then the setting is stored in the global config file. \item[{\em options}]see Options\-Type\end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]'Yes' is returned if the Yes-button is pressed. 'No' is returned if the No-button is pressed.\end{Desc}
To be used for questions like \char`\"{}Do you really want to delete these files?\char`\"{} And show the user exactly which files are going to be deleted in case he presses \char`\"{}Yes\char`\"{}

The default button is \char`\"{}Yes\char`\"{}. Pressing \char`\"{}Esc\char`\"{} selects \char`\"{}No\char`\"{}. 

Definition at line 403 of file kmessagebox.cpp.

References question\-Yes\-No\-List\-WId().

Referenced by question\-Yes\-No().\index{KMessageBox@{KMessage\-Box}!questionYesNoListWId@{questionYesNoListWId}}
\index{questionYesNoListWId@{questionYesNoListWId}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}int KMessage\-Box::question\-Yes\-No\-List\-WId (WId {\em parent\_\-id}, const {\bf QString} \& {\em text}, const {\bf QString\-List} \& {\em strlist}, const {\bf QString} \& {\em caption} = {\tt QString::null}, const {\bf KGui\-Item} \& {\em button\-Yes} = {\tt KStdGuiItem::yes()}, const {\bf KGui\-Item} \& {\em button\-No} = {\tt KStdGuiItem::no()}, const {\bf QString} \& {\em dont\-Ask\-Again\-Name} = {\tt QString::null}, int {\em options} = {\tt Notify})\hspace{0.3cm}{\tt  [static]}}\label{classKMessageBox_e5}


This function accepts the window id of the parent window, instead of QWidget$\ast$. 

It should be used only when necessary. \begin{Desc}
\item[Since:]3.2 \end{Desc}


Definition at line 416 of file kmessagebox.cpp.

References create\-KMessage\-Box(), QWidget::find(), Plain\-Caption, save\-Dont\-Show\-Again\-Yes\-No(), KDialog::set\-Plain\-Caption(), and should\-Be\-Shown\-Yes\-No().

Referenced by question\-Yes\-No\-List(), and question\-Yes\-No\-WId().\index{KMessageBox@{KMessage\-Box}!warningYesNo@{warningYesNo}}
\index{warningYesNo@{warningYesNo}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}int KMessage\-Box::warning\-Yes\-No ({\bf QWidget} $\ast$ {\em parent}, const {\bf QString} \& {\em text}, const {\bf QString} \& {\em caption} = {\tt QString::null}, const {\bf KGui\-Item} \& {\em button\-Yes} = {\tt KStdGuiItem::yes()}, const {\bf KGui\-Item} \& {\em button\-No} = {\tt KStdGuiItem::no()}, const {\bf QString} \& {\em dont\-Ask\-Again\-Name} = {\tt QString::null}, int {\em options} = {\tt Notify$|$Dangerous})\hspace{0.3cm}{\tt  [static]}}\label{classKMessageBox_e6}


Display a \char`\"{}warning\char`\"{} dialog. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em parent}]If {\tt parent} is 0, then the message box becomes an application-global modal dialog box. If {\tt parent} is a widget, the message box becomes modal relative to parent. \item[{\em text}]Message string. \item[{\em caption}]Message box title. The application name is added to the title. The default title is i18n(\char`\"{}Warning\char`\"{}). \item[{\em button\-Yes}]The text for the first button. The default is i18n(\char`\"{}\&Yes\char`\"{}). \item[{\em button\-No}]The text for the second button. The default is i18n(\char`\"{}\&No\char`\"{}). \item[{\em dont\-Ask\-Again\-Name}]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 \char`\"{}Notification Messages\char`\"{} group. If {\tt dont\-Ask\-Again\-Name} starts with a ':' then the setting is stored in the global config file. \item[{\em options}]see Options\-Type\end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]{\tt Yes} is returned if the Yes-button is pressed. {\tt No} is returned if the No-button is pressed.\end{Desc}
To be used for questions \char`\"{}Shall I update your configuration?\char`\"{} The text should explain the implication of both options.

The default button is \char`\"{}No\char`\"{}. Pressing \char`\"{}Esc\char`\"{} selects \char`\"{}No\char`\"{}. 

Definition at line 507 of file kmessagebox.cpp.

References warning\-Yes\-No\-List().

Referenced by KBug\-Report::slot\-Cancel(), and KPassword\-Dialog::slot\-Ok().\index{KMessageBox@{KMessage\-Box}!warningYesNoWId@{warningYesNoWId}}
\index{warningYesNoWId@{warningYesNoWId}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}int KMessage\-Box::warning\-Yes\-No\-WId (WId {\em parent\_\-id}, const {\bf QString} \& {\em text}, const {\bf QString} \& {\em caption} = {\tt QString::null}, const {\bf KGui\-Item} \& {\em button\-Yes} = {\tt KStdGuiItem::yes()}, const {\bf KGui\-Item} \& {\em button\-No} = {\tt KStdGuiItem::no()}, const {\bf QString} \& {\em dont\-Ask\-Again\-Name} = {\tt QString::null}, int {\em options} = {\tt Notify$|$Dangerous})\hspace{0.3cm}{\tt  [static]}}\label{classKMessageBox_e7}


This function accepts the window id of the parent window, instead of QWidget$\ast$. 

It should be used only when necessary. \begin{Desc}
\item[Since:]3.2 \end{Desc}


Definition at line 519 of file kmessagebox.cpp.

References warning\-Yes\-No\-List\-WId().

Referenced by message\-Box\-WId().\index{KMessageBox@{KMessage\-Box}!warningYesNoList@{warningYesNoList}}
\index{warningYesNoList@{warningYesNoList}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}int KMessage\-Box::warning\-Yes\-No\-List ({\bf QWidget} $\ast$ {\em parent}, const {\bf QString} \& {\em text}, const {\bf QString\-List} \& {\em strlist}, const {\bf QString} \& {\em caption} = {\tt QString::null}, const {\bf KGui\-Item} \& {\em button\-Yes} = {\tt KStdGuiItem::yes()}, const {\bf KGui\-Item} \& {\em button\-No} = {\tt KStdGuiItem::no()}, const {\bf QString} \& {\em dont\-Ask\-Again\-Name} = {\tt QString::null}, int {\em options} = {\tt Notify$|$Dangerous})\hspace{0.3cm}{\tt  [static]}}\label{classKMessageBox_e8}


Display a \char`\"{}warning\char`\"{} dialog with a listbox to show information to the user. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em parent}]If {\tt parent} is 0, then the message box becomes an application-global modal dialog box. If {\tt parent} is a widget, the message box becomes modal relative to parent. \item[{\em text}]Message string. \item[{\em strlist}]List of strings to be written in the listbox. If the list is empty, it doesn't show any listbox, working as question\-Yes\-No. \item[{\em caption}]Message box title. The application name is added to the title. The default title is i18n(\char`\"{}Question\char`\"{}). \item[{\em button\-Yes}]The text for the first button. The default is i18n(\char`\"{}\&Yes\char`\"{}). \item[{\em button\-No}]The text for the second button. The default is i18n(\char`\"{}\&No\char`\"{}). \item[{\em dont\-Ask\-Again\-Name}]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 \char`\"{}Notification Messages\char`\"{} group. If {\tt dont\-Ask\-Again\-Name} starts with a ':' then the setting is stored in the global config file. \item[{\em options}]see Options\-Type\end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]'Yes' is returned if the Yes-button is pressed. 'No' is returned if the No-button is pressed.\end{Desc}
To be used for questions like \char`\"{}Do you really want to delete these files?\char`\"{} And show the user exactly which files are going to be deleted in case he presses \char`\"{}Yes\char`\"{}

The default button is \char`\"{}No\char`\"{}. Pressing \char`\"{}Esc\char`\"{} selects \char`\"{}No\char`\"{}. 

Definition at line 531 of file kmessagebox.cpp.

References warning\-Yes\-No\-List\-WId().

Referenced by warning\-Yes\-No().\index{KMessageBox@{KMessage\-Box}!warningYesNoListWId@{warningYesNoListWId}}
\index{warningYesNoListWId@{warningYesNoListWId}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}int KMessage\-Box::warning\-Yes\-No\-List\-WId (WId {\em parent\_\-id}, const {\bf QString} \& {\em text}, const {\bf QString\-List} \& {\em strlist}, const {\bf QString} \& {\em caption} = {\tt QString::null}, const {\bf KGui\-Item} \& {\em button\-Yes} = {\tt KStdGuiItem::yes()}, const {\bf KGui\-Item} \& {\em button\-No} = {\tt KStdGuiItem::no()}, const {\bf QString} \& {\em dont\-Ask\-Again\-Name} = {\tt QString::null}, int {\em options} = {\tt Notify$|$Dangerous})\hspace{0.3cm}{\tt  [static]}}\label{classKMessageBox_e9}


This function accepts the window id of the parent window, instead of QWidget$\ast$. 

It should be used only when necessary. \begin{Desc}
\item[Since:]3.2 \end{Desc}


Definition at line 544 of file kmessagebox.cpp.

References create\-KMessage\-Box(), QWidget::find(), Plain\-Caption, save\-Dont\-Show\-Again\-Yes\-No(), KDialog::set\-Plain\-Caption(), and should\-Be\-Shown\-Yes\-No().

Referenced by warning\-Yes\-No\-List(), and warning\-Yes\-No\-WId().\index{KMessageBox@{KMessage\-Box}!warningContinueCancel@{warningContinueCancel}}
\index{warningContinueCancel@{warningContinueCancel}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}int KMessage\-Box::warning\-Continue\-Cancel ({\bf QWidget} $\ast$ {\em parent}, const {\bf QString} \& {\em text}, const {\bf QString} \& {\em caption} = {\tt QString::null}, const {\bf KGui\-Item} \& {\em button\-Continue} = {\tt KStdGuiItem::cont()}, const {\bf QString} \& {\em dont\-Ask\-Again\-Name} = {\tt QString::null}, int {\em options} = {\tt Notify})\hspace{0.3cm}{\tt  [static]}}\label{classKMessageBox_e10}


Display a \char`\"{}warning\char`\"{} dialog. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em parent}]If {\tt parent} is 0, then the message box becomes an application-global modal dialog box. If {\tt parent} is a widget, the message box becomes modal relative to parent. \item[{\em text}]Message string. \item[{\em caption}]Message box title. The application name is added to the title. The default title is i18n(\char`\"{}Warning\char`\"{}). \item[{\em button\-Continue}]The text for the first button. \item[{\em dont\-Ask\-Again\-Name}]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 \char`\"{}Notification Messages\char`\"{} group. If {\tt dont\-Ask\-Again\-Name} starts with a ':' then the setting is stored in the global config file. \item[{\em options}]see Options\-Type\end{description}
\end{Desc}
The second button always has the text \char`\"{}Cancel\char`\"{}.

\begin{Desc}
\item[Returns:]{\tt Continue} is returned if the Continue-button is pressed. {\tt Cancel} is returned if the Cancel-button is pressed.\end{Desc}
To be used for questions like \char`\"{}You are about to Print. Are you sure?\char`\"{} the continue\-Button should then be labeled \char`\"{}Print\char`\"{}.

The default button is button\-Continue. Pressing \char`\"{}Esc\char`\"{} selects \char`\"{}Cancel\char`\"{}. 

Definition at line 587 of file kmessagebox.cpp.

References warning\-Continue\-Cancel\-List().\index{KMessageBox@{KMessage\-Box}!warningContinueCancelWId@{warningContinueCancelWId}}
\index{warningContinueCancelWId@{warningContinueCancelWId}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}int KMessage\-Box::warning\-Continue\-Cancel\-WId (WId {\em parent\_\-id}, const {\bf QString} \& {\em text}, const {\bf QString} \& {\em caption} = {\tt QString::null}, const {\bf KGui\-Item} \& {\em button\-Continue} = {\tt KStdGuiItem::cont()}, const {\bf QString} \& {\em dont\-Ask\-Again\-Name} = {\tt QString::null}, int {\em options} = {\tt Notify})\hspace{0.3cm}{\tt  [static]}}\label{classKMessageBox_e11}


This function accepts the window id of the parent window, instead of QWidget$\ast$. 

It should be used only when necessary. \begin{Desc}
\item[Since:]3.2 \end{Desc}


Definition at line 599 of file kmessagebox.cpp.

References warning\-Continue\-Cancel\-List\-WId().

Referenced by message\-Box\-WId().\index{KMessageBox@{KMessage\-Box}!warningContinueCancelList@{warningContinueCancelList}}
\index{warningContinueCancelList@{warningContinueCancelList}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}int KMessage\-Box::warning\-Continue\-Cancel\-List ({\bf QWidget} $\ast$ {\em parent}, const {\bf QString} \& {\em text}, const {\bf QString\-List} \& {\em strlist}, const {\bf QString} \& {\em caption} = {\tt QString::null}, const {\bf KGui\-Item} \& {\em button\-Continue} = {\tt KStdGuiItem::cont()}, const {\bf QString} \& {\em dont\-Ask\-Again\-Name} = {\tt QString::null}, int {\em options} = {\tt Notify})\hspace{0.3cm}{\tt  [static]}}\label{classKMessageBox_e12}


Display a \char`\"{}warning\char`\"{} dialog with a listbox to show information to the user. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em parent}]If {\tt parent} is 0, then the message box becomes an application-global modal dialog box. If {\tt parent} is a widget, the message box becomes modal relative to parent. \item[{\em text}]Message string. \item[{\em strlist}]List of strings to be written in the listbox. If the list is empty, it doesn't show any listbox, working as warning\-Continue\-Cancel. \item[{\em caption}]Message box title. The application name is added to the title. The default title is i18n(\char`\"{}Warning\char`\"{}). \item[{\em button\-Continue}]The text for the first button. \item[{\em dont\-Ask\-Again\-Name}]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 \char`\"{}Notification Messages\char`\"{} group. If {\tt dont\-Ask\-Again\-Name} starts with a ':' then the setting is stored in the global config file.\item[{\em options}]see Options\-Type\end{description}
\end{Desc}
The second button always has the text \char`\"{}Cancel\char`\"{}.

\begin{Desc}
\item[Returns:]{\tt Continue} is returned if the Continue-button is pressed. {\tt Cancel} is returned if the Cancel-button is pressed.\end{Desc}
To be used for questions like \char`\"{}You are about to Print. Are you sure?\char`\"{} the continue\-Button should then be labeled \char`\"{}Print\char`\"{}.

The default button is button\-Continue. Pressing \char`\"{}Esc\char`\"{} selects \char`\"{}Cancel\char`\"{}. 

Definition at line 611 of file kmessagebox.cpp.

References warning\-Continue\-Cancel\-List\-WId().

Referenced by warning\-Continue\-Cancel().\index{KMessageBox@{KMessage\-Box}!warningContinueCancelListWId@{warningContinueCancelListWId}}
\index{warningContinueCancelListWId@{warningContinueCancelListWId}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}int KMessage\-Box::warning\-Continue\-Cancel\-List\-WId (WId {\em parent\_\-id}, const {\bf QString} \& {\em text}, const {\bf QString\-List} \& {\em strlist}, const {\bf QString} \& {\em caption} = {\tt QString::null}, const {\bf KGui\-Item} \& {\em button\-Continue} = {\tt KStdGuiItem::cont()}, const {\bf QString} \& {\em dont\-Ask\-Again\-Name} = {\tt QString::null}, int {\em options} = {\tt Notify})\hspace{0.3cm}{\tt  [static]}}\label{classKMessageBox_e13}


This function accepts the window id of the parent window, instead of QWidget$\ast$. 

It should be used only when necessary. \begin{Desc}
\item[Since:]3.2 \end{Desc}


Definition at line 623 of file kmessagebox.cpp.

References create\-KMessage\-Box(), QWidget::find(), Plain\-Caption, save\-Dont\-Show\-Again\-Continue(), KDialog::set\-Plain\-Caption(), and should\-Be\-Shown\-Continue().

Referenced by warning\-Continue\-Cancel\-List(), and warning\-Continue\-Cancel\-WId().\index{KMessageBox@{KMessage\-Box}!warningYesNoCancel@{warningYesNoCancel}}
\index{warningYesNoCancel@{warningYesNoCancel}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}int KMessage\-Box::warning\-Yes\-No\-Cancel ({\bf QWidget} $\ast$ {\em parent}, const {\bf QString} \& {\em text}, const {\bf QString} \& {\em caption} = {\tt QString::null}, const {\bf KGui\-Item} \& {\em button\-Yes} = {\tt KStdGuiItem::yes()}, const {\bf KGui\-Item} \& {\em button\-No} = {\tt KStdGuiItem::no()}, const {\bf QString} \& {\em dont\-Ask\-Again\-Name} = {\tt QString::null}, int {\em options} = {\tt Notify})\hspace{0.3cm}{\tt  [static]}}\label{classKMessageBox_e14}


Display a Yes/No/Cancel \char`\"{}warning\char`\"{} dialog. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em parent}]If {\tt parent} is 0, then the message box becomes an application-global modal dialog box. If {\tt parent} is a widget, the message box becomes modal relative to parent. \item[{\em text}]Message string. \item[{\em caption}]Message box title. The application name is added to the title. The default title is i18n(\char`\"{}Warning\char`\"{}). \item[{\em button\-Yes}]The text for the first button. The default is i18n(\char`\"{}\&Yes\char`\"{}). \item[{\em button\-No}]The text for the second button. The default is i18n(\char`\"{}\&No\char`\"{}). \item[{\em dont\-Ask\-Again\-Name}]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 \char`\"{}Notification Messages\char`\"{} group. If {\tt dont\-Ask\-Again\-Name} starts with a ':' then the setting is stored in the global config file. \item[{\em options}]see Options\-Type\end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]{\tt Yes} is returned if the Yes-button is pressed. {\tt No} is returned if the No-button is pressed. {\tt Cancel} is retunred if the Cancel- button is pressed.\end{Desc}
To be used for questions \char`\"{}Do you want to save your changes?\char`\"{} The text should explain the implication of choosing 'No'.

The default button is \char`\"{}Yes\char`\"{}. Pressing \char`\"{}Esc\char`\"{} selects \char`\"{}Cancel\char`\"{}

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

Definition at line 660 of file kmessagebox.cpp.

References warning\-Yes\-No\-Cancel\-List().\index{KMessageBox@{KMessage\-Box}!warningYesNoCancelWId@{warningYesNoCancelWId}}
\index{warningYesNoCancelWId@{warningYesNoCancelWId}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}int KMessage\-Box::warning\-Yes\-No\-Cancel\-WId (WId {\em parent\_\-id}, const {\bf QString} \& {\em text}, const {\bf QString} \& {\em caption} = {\tt QString::null}, const {\bf KGui\-Item} \& {\em button\-Yes} = {\tt KStdGuiItem::yes()}, const {\bf KGui\-Item} \& {\em button\-No} = {\tt KStdGuiItem::no()}, const {\bf QString} \& {\em dont\-Ask\-Again\-Name} = {\tt QString::null}, int {\em options} = {\tt Notify})\hspace{0.3cm}{\tt  [static]}}\label{classKMessageBox_e15}


This function accepts the window id of the parent window, instead of QWidget$\ast$. 

It should be used only when necessary. \begin{Desc}
\item[Since:]3.2 \end{Desc}


Definition at line 672 of file kmessagebox.cpp.

References warning\-Yes\-No\-Cancel\-List\-WId().

Referenced by message\-Box\-WId().\index{KMessageBox@{KMessage\-Box}!warningYesNoCancelList@{warningYesNoCancelList}}
\index{warningYesNoCancelList@{warningYesNoCancelList}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}int KMessage\-Box::warning\-Yes\-No\-Cancel\-List ({\bf QWidget} $\ast$ {\em parent}, const {\bf QString} \& {\em text}, const {\bf QString\-List} \& {\em strlist}, const {\bf QString} \& {\em caption} = {\tt QString::null}, const {\bf KGui\-Item} \& {\em button\-Yes} = {\tt KStdGuiItem::yes()}, const {\bf KGui\-Item} \& {\em button\-No} = {\tt KStdGuiItem::no()}, const {\bf QString} \& {\em dont\-Ask\-Again\-Name} = {\tt QString::null}, int {\em options} = {\tt Notify})\hspace{0.3cm}{\tt  [static]}}\label{classKMessageBox_e16}


Display a Yes/No/Cancel \char`\"{}warning\char`\"{} dialog with a listbox to show information to the user. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em parent}]If {\tt parent} is 0, then the message box becomes an application-global modal dialog box. If {\tt parent} is a widget, the message box becomes modal relative to parent. \item[{\em text}]Message string. \item[{\em strlist}]List of strings to be written in the listbox. If the list is empty, it doesn't show any listbox, working as warning\-Yes\-No\-Cancel. \item[{\em caption}]Message box title. The application name is added to the title. The default title is i18n(\char`\"{}Warning\char`\"{}). \item[{\em button\-Yes}]The text for the first button. The default is i18n(\char`\"{}\&Yes\char`\"{}). \item[{\em button\-No}]The text for the second button. The default is i18n(\char`\"{}\&No\char`\"{}). \item[{\em dont\-Ask\-Again\-Name}]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 \char`\"{}Notification Messages\char`\"{} group. If {\tt dont\-Ask\-Again\-Name} starts with a ':' then the setting is stored in the global config file. \item[{\em options}]see Options\-Type\end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]{\tt Yes} is returned if the Yes-button is pressed. {\tt No} is returned if the No-button is pressed. {\tt Cancel} is retunred if the Cancel- button is pressed.\end{Desc}
To be used for questions \char`\"{}Do you want to save your changes?\char`\"{} The text should explain the implication of choosing 'No'.

The default button is \char`\"{}Yes\char`\"{}. Pressing \char`\"{}Esc\char`\"{} selects \char`\"{}Cancel\char`\"{}

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

\begin{Desc}
\item[Since:]3.2 \end{Desc}


Definition at line 684 of file kmessagebox.cpp.

References warning\-Yes\-No\-Cancel\-List\-WId().

Referenced by warning\-Yes\-No\-Cancel().\index{KMessageBox@{KMessage\-Box}!warningYesNoCancelListWId@{warningYesNoCancelListWId}}
\index{warningYesNoCancelListWId@{warningYesNoCancelListWId}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}int KMessage\-Box::warning\-Yes\-No\-Cancel\-List\-WId (WId {\em parent\_\-id}, const {\bf QString} \& {\em text}, const {\bf QString\-List} \& {\em strlist}, const {\bf QString} \& {\em caption} = {\tt QString::null}, const {\bf KGui\-Item} \& {\em button\-Yes} = {\tt KStdGuiItem::yes()}, const {\bf KGui\-Item} \& {\em button\-No} = {\tt KStdGuiItem::no()}, const {\bf QString} \& {\em dont\-Ask\-Again\-Name} = {\tt QString::null}, int {\em options} = {\tt Notify})\hspace{0.3cm}{\tt  [static]}}\label{classKMessageBox_e17}


This function accepts the window id of the parent window, instead of QWidget$\ast$. 

It should be used only when necessary. \begin{Desc}
\item[Since:]3.2 \end{Desc}


Definition at line 697 of file kmessagebox.cpp.

References create\-KMessage\-Box(), QWidget::find(), Plain\-Caption, save\-Dont\-Show\-Again\-Yes\-No(), KDialog::set\-Plain\-Caption(), and should\-Be\-Shown\-Yes\-No().

Referenced by warning\-Yes\-No\-Cancel\-List(), and warning\-Yes\-No\-Cancel\-WId().\index{KMessageBox@{KMessage\-Box}!error@{error}}
\index{error@{error}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KMessage\-Box::error ({\bf QWidget} $\ast$ {\em parent}, const {\bf QString} \& {\em text}, const {\bf QString} \& {\em caption} = {\tt QString::null}, int {\em options} = {\tt Notify})\hspace{0.3cm}{\tt  [static]}}\label{classKMessageBox_e18}


Display an \char`\"{}Error\char`\"{} dialog. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em parent}]If {\tt parent} is 0, then the message box becomes an application-global modal dialog box. If {\tt parent} is a widget, the message box becomes modal relative to parent. \item[{\em text}]Message string. \item[{\em caption}]Message box title. The application name is added to the title. The default title is i18n(\char`\"{}Error\char`\"{}). \item[{\em options}]see Options\-Type\end{description}
\end{Desc}
Your program messed up and now it's time to inform the user. To be used for important things like \char`\"{}Sorry, I deleted your hard disk.\char`\"{}

If your program detects the action specified by the user is somehow not allowed, this should never be reported with {\bf error()}{\rm (p.\,\pageref{classKMessageBox_e18})}. Use {\bf sorry()}{\rm (p.\,\pageref{classKMessageBox_e26})} instead to explain to the user that this action is not allowed.

The default button is \char`\"{}\&OK\char`\"{}. Pressing \char`\"{}Esc\char`\"{} selects the OK-button.

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

Definition at line 736 of file kmessagebox.cpp.

References error\-List\-WId().

Referenced by KBug\-Report::slot\-Ok().\index{KMessageBox@{KMessage\-Box}!errorWId@{errorWId}}
\index{errorWId@{errorWId}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KMessage\-Box::error\-WId (WId {\em parent\_\-id}, const {\bf QString} \& {\em text}, const {\bf QString} \& {\em caption} = {\tt QString::null}, int {\em options} = {\tt Notify})\hspace{0.3cm}{\tt  [static]}}\label{classKMessageBox_e19}


This function accepts the window id of the parent window, instead of QWidget$\ast$. 

It should be used only when necessary.

\begin{Desc}
\item[Since:]3.2 \end{Desc}


Definition at line 743 of file kmessagebox.cpp.

References error\-List\-WId().

Referenced by message\-Box\-WId().\index{KMessageBox@{KMessage\-Box}!errorList@{errorList}}
\index{errorList@{errorList}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KMessage\-Box::error\-List ({\bf QWidget} $\ast$ {\em parent}, const {\bf QString} \& {\em text}, const {\bf QString\-List} \& {\em strlist}, const {\bf QString} \& {\em caption} = {\tt QString::null}, int {\em options} = {\tt Notify})\hspace{0.3cm}{\tt  [static]}}\label{classKMessageBox_e20}


Display an \char`\"{}Error\char`\"{} dialog with a listbox. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em parent}]If {\tt parent} is 0, then the message box becomes an application-global modal dialog box. If {\tt parent} is a widget, the message box becomes modal relative to parent. \item[{\em text}]Message string. \item[{\em strlist}]List of strings to be written in the listbox. If the list is empty, it doesn't show any listbox, working as {\bf error()}{\rm (p.\,\pageref{classKMessageBox_e18})}. \item[{\em caption}]Message box title. The application name is added to the title. The default title is i18n(\char`\"{}Error\char`\"{}). \item[{\em options}]see Options\-Type\end{description}
\end{Desc}
Your program messed up and now it's time to inform the user. To be used for important things like \char`\"{}Sorry, I deleted your hard disk.\char`\"{}

If your program detects the action specified by the user is somehow not allowed, this should never be reported with {\bf error()}{\rm (p.\,\pageref{classKMessageBox_e18})}. Use {\bf sorry()}{\rm (p.\,\pageref{classKMessageBox_e26})} instead to explain to the user that this action is not allowed.

The default button is \char`\"{}\&OK\char`\"{}. Pressing \char`\"{}Esc\char`\"{} selects the OK-button.

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

\begin{Desc}
\item[Since:]3.4 \end{Desc}


Definition at line 750 of file kmessagebox.cpp.

References error\-List\-WId().\index{KMessageBox@{KMessage\-Box}!errorListWId@{errorListWId}}
\index{errorListWId@{errorListWId}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KMessage\-Box::error\-List\-WId (WId {\em parent\_\-id}, const {\bf QString} \& {\em text}, const {\bf QString\-List} \& {\em strlist}, const {\bf QString} \& {\em caption} = {\tt QString::null}, int {\em options} = {\tt Notify})\hspace{0.3cm}{\tt  [static]}}\label{classKMessageBox_e21}


This function accepts the window id of the parent window, instead of QWidget$\ast$. 

It should be used only when necessary. \begin{Desc}
\item[Since:]3.4 \end{Desc}


Definition at line 757 of file kmessagebox.cpp.

References create\-KMessage\-Box(), QWidget::find(), Plain\-Caption, and KDialog::set\-Plain\-Caption().

Referenced by error(), error\-List(), and error\-WId().\index{KMessageBox@{KMessage\-Box}!detailedError@{detailedError}}
\index{detailedError@{detailedError}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KMessage\-Box::detailed\-Error ({\bf QWidget} $\ast$ {\em parent}, const {\bf QString} \& {\em text}, const {\bf QString} \& {\em details}, const {\bf QString} \& {\em caption} = {\tt QString::null}, int {\em options} = {\tt Notify})\hspace{0.3cm}{\tt  [static]}}\label{classKMessageBox_e22}


Displays an \char`\"{}Error\char`\"{} dialog with a \char`\"{}Details $>$$>$\char`\"{} button. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em parent}]If {\tt parent} is 0, then the message box becomes an application-global modal dialog box. If {\tt parent} is a widget, the message box becomes modal relative to parent. \item[{\em text}]Message string. \item[{\em details}]Detailed message string. \item[{\em caption}]Message box title. The application name is added to the title. The default title is i18n(\char`\"{}Error\char`\"{}). \item[{\em options}]see Options\-Type\end{description}
\end{Desc}
Your program messed up and now it's time to inform the user. To be used for important things like \char`\"{}Sorry, I deleted your hard disk.\char`\"{}

The {\tt details} message can conatin additional information about the problem and can be shown on request to advanced/interested users.

If your program detects the action specified by the user is somehow not allowed, this should never be reported with {\bf error()}{\rm (p.\,\pageref{classKMessageBox_e18})}. Use {\bf sorry()}{\rm (p.\,\pageref{classKMessageBox_e26})} instead to explain to the user that this action is not allowed.

The default button is \char`\"{}\&OK\char`\"{}. Pressing \char`\"{}Esc\char`\"{} selects the OK-button.

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

Definition at line 778 of file kmessagebox.cpp.

References detailed\-Error\-WId().\index{KMessageBox@{KMessage\-Box}!detailedErrorWId@{detailedErrorWId}}
\index{detailedErrorWId@{detailedErrorWId}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KMessage\-Box::detailed\-Error\-WId (WId {\em parent\_\-id}, const {\bf QString} \& {\em text}, const {\bf QString} \& {\em details}, const {\bf QString} \& {\em caption} = {\tt QString::null}, int {\em options} = {\tt Notify})\hspace{0.3cm}{\tt  [static]}}\label{classKMessageBox_e23}


This function accepts the window id of the parent window, instead of QWidget$\ast$. 

It should be used only when necessary. \begin{Desc}
\item[Since:]3.2 \end{Desc}


Definition at line 786 of file kmessagebox.cpp.

References create\-KMessage\-Box(), QWidget::find(), Plain\-Caption, and KDialog::set\-Plain\-Caption().

Referenced by detailed\-Error(), and queued\-Detailed\-Error\-WId().\index{KMessageBox@{KMessage\-Box}!queuedDetailedError@{queuedDetailedError}}
\index{queuedDetailedError@{queuedDetailedError}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KMessage\-Box::queued\-Detailed\-Error ({\bf QWidget} $\ast$ {\em parent}, const {\bf QString} \& {\em text}, const {\bf QString} \& {\em details}, const {\bf QString} \& {\em caption} = {\tt QString::null})\hspace{0.3cm}{\tt  [static]}}\label{classKMessageBox_e24}


Like detailed\-Error. 

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

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

Definition at line 808 of file kmessagebox.cpp.

References queued\-Detailed\-Error\-WId().\index{KMessageBox@{KMessage\-Box}!queuedDetailedErrorWId@{queuedDetailedErrorWId}}
\index{queuedDetailedErrorWId@{queuedDetailedErrorWId}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KMessage\-Box::queued\-Detailed\-Error\-WId (WId {\em parent\_\-id}, const {\bf QString} \& {\em text}, const {\bf QString} \& {\em details}, const {\bf QString} \& {\em caption} = {\tt QString::null})\hspace{0.3cm}{\tt  [static]}}\label{classKMessageBox_e25}


This function accepts the window id of the parent window, instead of QWidget$\ast$. 

It should be used only when necessary. \begin{Desc}
\item[Since:]3.2 \end{Desc}


Definition at line 816 of file kmessagebox.cpp.

References detailed\-Error\-WId().

Referenced by queued\-Detailed\-Error().\index{KMessageBox@{KMessage\-Box}!sorry@{sorry}}
\index{sorry@{sorry}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KMessage\-Box::sorry ({\bf QWidget} $\ast$ {\em parent}, const {\bf QString} \& {\em text}, const {\bf QString} \& {\em caption} = {\tt QString::null}, int {\em options} = {\tt Notify})\hspace{0.3cm}{\tt  [static]}}\label{classKMessageBox_e26}


Display an \char`\"{}Sorry\char`\"{} dialog. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em parent}]If {\tt parent} is 0, then the message box becomes an application-global modal dialog box. If {\tt parent} is a widget, the message box becomes modal relative to parent. \item[{\em text}]Message string. \item[{\em caption}]Message box title. The application name is added to the title. The default title is i18n(\char`\"{}Sorry\char`\"{}). \item[{\em options}]see Options\-Type\end{description}
\end{Desc}
Either your program messed up and asks for understanding or your user did something stupid.

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

The default button is \char`\"{}\&OK\char`\"{}. Pressing \char`\"{}Esc\char`\"{} selects the OK-button.

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

Definition at line 827 of file kmessagebox.cpp.

References sorry\-WId().

Referenced by KPassword\-Dialog::slot\-Ok().\index{KMessageBox@{KMessage\-Box}!sorryWId@{sorryWId}}
\index{sorryWId@{sorryWId}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KMessage\-Box::sorry\-WId (WId {\em parent\_\-id}, const {\bf QString} \& {\em text}, const {\bf QString} \& {\em caption} = {\tt QString::null}, int {\em options} = {\tt Notify})\hspace{0.3cm}{\tt  [static]}}\label{classKMessageBox_e27}


This function accepts the window id of the parent window, instead of QWidget$\ast$. 

It should be used only when necessary. \begin{Desc}
\item[Since:]3.2 \end{Desc}


Definition at line 834 of file kmessagebox.cpp.

References create\-KMessage\-Box(), QWidget::find(), Plain\-Caption, and KDialog::set\-Plain\-Caption().

Referenced by message\-Box\-WId(), and sorry().\index{KMessageBox@{KMessage\-Box}!detailedSorry@{detailedSorry}}
\index{detailedSorry@{detailedSorry}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KMessage\-Box::detailed\-Sorry ({\bf QWidget} $\ast$ {\em parent}, const {\bf QString} \& {\em text}, const {\bf QString} \& {\em details}, const {\bf QString} \& {\em caption} = {\tt QString::null}, int {\em options} = {\tt Notify})\hspace{0.3cm}{\tt  [static]}}\label{classKMessageBox_e28}


Displays a \char`\"{}Sorry\char`\"{} dialog with a \char`\"{}Details $>$$>$\char`\"{} button. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em parent}]If {\tt parent} is 0, then the message box becomes an application-global modal dialog box. If {\tt parent} is a widget, the message box becomes modal relative to parent. \item[{\em text}]Message string. \item[{\em details}]Detailed message string. \item[{\em caption}]Message box title. The application name is added to the title. The default title is i18n(\char`\"{}Sorry\char`\"{}). \item[{\em options}]see Options\-Type\end{description}
\end{Desc}
Either your program messed up and asks for understanding or your user did something stupid.

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

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

The default button is \char`\"{}\&OK\char`\"{}. Pressing \char`\"{}Esc\char`\"{} selects the OK-button.

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

Definition at line 855 of file kmessagebox.cpp.

References detailed\-Sorry\-WId().\index{KMessageBox@{KMessage\-Box}!detailedSorryWId@{detailedSorryWId}}
\index{detailedSorryWId@{detailedSorryWId}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KMessage\-Box::detailed\-Sorry\-WId (WId {\em parent\_\-id}, const {\bf QString} \& {\em text}, const {\bf QString} \& {\em details}, const {\bf QString} \& {\em caption} = {\tt QString::null}, int {\em options} = {\tt Notify})\hspace{0.3cm}{\tt  [static]}}\label{classKMessageBox_e29}


This function accepts the window id of the parent window, instead of QWidget$\ast$. 

It should be used only when necessary. \begin{Desc}
\item[Since:]3.2 \end{Desc}


Definition at line 863 of file kmessagebox.cpp.

References create\-KMessage\-Box(), QWidget::find(), Plain\-Caption, and KDialog::set\-Plain\-Caption().

Referenced by detailed\-Sorry().\index{KMessageBox@{KMessage\-Box}!information@{information}}
\index{information@{information}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KMessage\-Box::information ({\bf QWidget} $\ast$ {\em parent}, const {\bf QString} \& {\em text}, const {\bf QString} \& {\em caption} = {\tt QString::null}, const {\bf QString} \& {\em dont\-Show\-Again\-Name} = {\tt QString::null}, int {\em options} = {\tt Notify})\hspace{0.3cm}{\tt  [static]}}\label{classKMessageBox_e30}


Display an \char`\"{}Information\char`\"{} dialog. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em parent}]If {\tt parent} is 0, then the message box becomes an application-global modal dialog box. If {\tt parent} is a widget, the message box becomes modal relative to parent. \item[{\em text}]Message string. \item[{\em caption}]Message box title. The application name is added to the title. The default title is i18n(\char`\"{}Information\char`\"{}). \item[{\em dont\-Show\-Again\-Name}]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 \char`\"{}Notification Messages\char`\"{} group. \item[{\em options}]see Options\-Type\end{description}
\end{Desc}
Your program wants to tell the user something. To be used for things like: \char`\"{}Your bookmarks have been rearranged.\char`\"{}

The default button is \char`\"{}\&OK\char`\"{}. Pressing \char`\"{}Esc\char`\"{} selects the OK-button.

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

Definition at line 885 of file kmessagebox.cpp.

References information\-List().

Referenced by KBug\-Report::slot\-Ok().\index{KMessageBox@{KMessage\-Box}!informationWId@{informationWId}}
\index{informationWId@{informationWId}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KMessage\-Box::information\-WId (WId {\em parent\_\-id}, const {\bf QString} \& {\em text}, const {\bf QString} \& {\em caption} = {\tt QString::null}, const {\bf QString} \& {\em dont\-Show\-Again\-Name} = {\tt QString::null}, int {\em options} = {\tt Notify})\hspace{0.3cm}{\tt  [static]}}\label{classKMessageBox_e31}


This function accepts the window id of the parent window, instead of QWidget$\ast$. 

It should be used only when necessary. \begin{Desc}
\item[Since:]3.2 \end{Desc}


Definition at line 892 of file kmessagebox.cpp.

References information\-List\-WId().

Referenced by message\-Box\-WId().\index{KMessageBox@{KMessage\-Box}!informationList@{informationList}}
\index{informationList@{informationList}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KMessage\-Box::information\-List ({\bf QWidget} $\ast$ {\em parent}, const {\bf QString} \& {\em text}, const {\bf QString\-List} \& {\em strlist}, const {\bf QString} \& {\em caption} = {\tt QString::null}, const {\bf QString} \& {\em dont\-Show\-Again\-Name} = {\tt QString::null}, int {\em options} = {\tt Notify})\hspace{0.3cm}{\tt  [static]}}\label{classKMessageBox_e32}


Display an \char`\"{}Information\char`\"{} dialog with a listbox. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em parent}]If {\tt parent} is 0, then the message box becomes an application-global modal dialog box. If {\tt parent} is a widget, the message box becomes modal relative to parent. \item[{\em text}]Message string. \item[{\em strlist}]List of strings to be written in the listbox. If the list is empty, it doesn't show any listbox, working as information. \item[{\em caption}]Message box title. The application name is added to the title. The default title is i18n(\char`\"{}Information\char`\"{}). \item[{\em dont\-Show\-Again\-Name}]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 \char`\"{}Notification Messages\char`\"{} group. \item[{\em options}]see Options\-Type\end{description}
\end{Desc}
Your program wants to tell the user something. To be used for things like: \char`\"{}The following bookmarks have been rearranged:\char`\"{}

The default button is \char`\"{}\&OK\char`\"{}. Pressing \char`\"{}Esc\char`\"{} selects the OK-button.

NOTE: The OK button will always have the i18n'ed text '\&OK'. \begin{Desc}
\item[Since:]3.1 \end{Desc}


Definition at line 899 of file kmessagebox.cpp.

References information\-List\-WId().

Referenced by information().\index{KMessageBox@{KMessage\-Box}!informationListWId@{informationListWId}}
\index{informationListWId@{informationListWId}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KMessage\-Box::information\-List\-WId (WId {\em parent\_\-id}, const {\bf QString} \& {\em text}, const {\bf QString\-List} \& {\em strlist}, const {\bf QString} \& {\em caption} = {\tt QString::null}, const {\bf QString} \& {\em dont\-Show\-Again\-Name} = {\tt QString::null}, int {\em options} = {\tt Notify})\hspace{0.3cm}{\tt  [static]}}\label{classKMessageBox_e33}


This function accepts the window id of the parent window, instead of QWidget$\ast$. 

It should be used only when necessary. \begin{Desc}
\item[Since:]3.2 \end{Desc}


Definition at line 907 of file kmessagebox.cpp.

References create\-KMessage\-Box(), QWidget::find(), Plain\-Caption, save\-Dont\-Show\-Again\-Continue(), KDialog::set\-Plain\-Caption(), and should\-Be\-Shown\-Continue().

Referenced by information\-List(), and information\-WId().\index{KMessageBox@{KMessage\-Box}!enableAllMessages@{enableAllMessages}}
\index{enableAllMessages@{enableAllMessages}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KMessage\-Box::enable\-All\-Messages ()\hspace{0.3cm}{\tt  [static]}}\label{classKMessageBox_e34}


Enable all messages which have been turned off with the {\tt dont\-Show\-Again\-Name} feature. 



Definition at line 938 of file kmessagebox.cpp.

References KGlobal::config(), KConfig\-Base::delete\-Entry(), KConfig::entry\-Map(), QString::from\-Latin1(), KConfig\-Base::has\-Group(), and KConfig\-Base::sync().\index{KMessageBox@{KMessage\-Box}!enableMessage@{enableMessage}}
\index{enableMessage@{enableMessage}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KMessage\-Box::enable\-Message (const {\bf QString} \& {\em dont\-Show\-Again\-Name})\hspace{0.3cm}{\tt  [static]}}\label{classKMessageBox_e35}


Re-enable a specific {\tt dont\-Show\-Again\-Name} messages that had previously been turned off. 

\begin{Desc}
\item[See also:]{\bf save\-Dont\-Show\-Again\-Yes\-No()}{\rm (p.\,\pageref{classKMessageBox_e46})} 

{\bf save\-Dont\-Show\-Again\-Continue()}{\rm (p.\,\pageref{classKMessageBox_e47})} \end{Desc}
\begin{Desc}
\item[Since:]3.2 \end{Desc}


Definition at line 958 of file kmessagebox.cpp.

References KGlobal::config(), KConfig\-Base::delete\-Entry(), QString::from\-Latin1(), KConfig\-Base::has\-Group(), and KConfig\-Base::sync().\index{KMessageBox@{KMessage\-Box}!about@{about}}
\index{about@{about}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KMessage\-Box::about ({\bf QWidget} $\ast$ {\em parent}, const {\bf QString} \& {\em text}, const {\bf QString} \& {\em caption} = {\tt QString::null}, int {\em options} = {\tt Notify})\hspace{0.3cm}{\tt  [static]}}\label{classKMessageBox_e36}


Display an \char`\"{}About\char`\"{} dialog. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em parent}]If {\tt parent} is 0, then the message box becomes an application-global modal dialog box. If {\tt parent} is a widget, the message box becomes modal relative to parent. \item[{\em text}]Message string. \item[{\em caption}]Message box title. The application name is added to the title. The default title is i18n(\char`\"{}About $<$appname$>$\char`\"{}). \item[{\em options}]see Options\-Type\end{description}
\end{Desc}
Your program wants to show some general information about the application like the authors's names and email addresses.

The default button is \char`\"{}\&OK\char`\"{}.

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

Definition at line 972 of file kmessagebox.cpp.

References QString::arg(), create\-KMessage\-Box(), KApplication::icon(), QString::is\-Empty(), QPixmap::is\-Null(), KApplication::k\-Application(), and QMessage\-Box::standard\-Icon().\index{KMessageBox@{KMessage\-Box}!messageBox@{messageBox}}
\index{messageBox@{messageBox}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}int KMessage\-Box::message\-Box ({\bf QWidget} $\ast$ {\em parent}, Dialog\-Type {\em type}, const {\bf QString} \& {\em text}, const {\bf QString} \& {\em caption}, const {\bf KGui\-Item} \& {\em button\-Yes}, const {\bf KGui\-Item} \& {\em button\-No}, const {\bf QString} \& {\em dont\-Show\-Ask\-Again\-Name}, int {\em options} = {\tt Notify})\hspace{0.3cm}{\tt  [static]}}\label{classKMessageBox_e37}


Alternate method to show a messagebox:. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em parent}]If {\tt parent} is 0, then the message box becomes an application-global modal dialog box. If {\tt parent} is a widget, the message box becomes modal relative to parent. \item[{\em type}]type of message box: Question\-Yes\-No, Warning\-Yes\-No, Warning\-Continue\-Cancel... \item[{\em text}]Message string. \item[{\em caption}]Message box title. \item[{\em button\-Yes}]The text for the first button. The default is i18n(\char`\"{}\&Yes\char`\"{}). \item[{\em button\-No}]The text for the second button. The default is i18n(\char`\"{}\&No\char`\"{}). \item[{\em dont\-Show\-Ask\-Again\-Name}]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. \item[{\em options}]see Options\-Type Note: for Continue\-Cancel, button\-Yes is the continue button and button\-No is unused. and for Information, none is used. \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]a button code, as defined in KMessage\-Box. \end{Desc}


Definition at line 996 of file kmessagebox.cpp.

References message\-Box\-WId().\index{KMessageBox@{KMessage\-Box}!messageBox@{messageBox}}
\index{messageBox@{messageBox}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}int KMessage\-Box::message\-Box ({\bf QWidget} $\ast$ {\em parent}, Dialog\-Type {\em type}, const {\bf QString} \& {\em text}, const {\bf QString} \& {\em caption} = {\tt QString::null}, const {\bf KGui\-Item} \& {\em button\-Yes} = {\tt KStdGuiItem::yes()}, const {\bf KGui\-Item} \& {\em button\-No} = {\tt KStdGuiItem::no()}, int {\em options} = {\tt Notify})\hspace{0.3cm}{\tt  [static]}}\label{classKMessageBox_e38}


Alternate method to show a messagebox:. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em parent}]If {\tt parent} is 0, then the message box becomes an application-global modal dialog box. If {\tt parent} is a widget, the message box becomes modal relative to parent. \item[{\em type}]type of message box: Question\-Yes\-No, Warning\-Yes\-No, Warning\-Continue\-Cancel... \item[{\em text}]Message string. \item[{\em caption}]Message box title. \item[{\em button\-Yes}]The text for the first button. The default is i18n(\char`\"{}\&Yes\char`\"{}). \item[{\em button\-No}]The text for the second button. The default is i18n(\char`\"{}\&No\char`\"{}). \item[{\em options}]see Options\-Type Note: for Continue\-Cancel, button\-Yes is the continue button and button\-No is unused. and for Information, none is used. \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]a button code, as defined in KMessage\-Box. \end{Desc}


Definition at line 1005 of file kmessagebox.cpp.

References message\-Box\-WId().\index{KMessageBox@{KMessage\-Box}!messageBoxWId@{messageBoxWId}}
\index{messageBoxWId@{messageBoxWId}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}int KMessage\-Box::message\-Box\-WId (WId {\em parent\_\-id}, Dialog\-Type {\em type}, const {\bf QString} \& {\em text}, const {\bf QString} \& {\em caption} = {\tt QString::null}, const {\bf KGui\-Item} \& {\em button\-Yes} = {\tt KStdGuiItem::yes()}, const {\bf KGui\-Item} \& {\em button\-No} = {\tt KStdGuiItem::no()}, const {\bf QString} \& {\em dont\-Show\-Ask\-Again\-Name} = {\tt QString::null}, int {\em options} = {\tt Notify})\hspace{0.3cm}{\tt  [static]}}\label{classKMessageBox_e39}


This function accepts the window id of the parent window, instead of QWidget$\ast$. 

It should be used only when necessary. \begin{Desc}
\item[Since:]3.2 \end{Desc}


Definition at line 1013 of file kmessagebox.cpp.

References error\-WId(), information\-WId(), question\-Yes\-No\-Cancel\-WId(), question\-Yes\-No\-WId(), sorry\-WId(), warning\-Continue\-Cancel\-WId(), warning\-Yes\-No\-Cancel\-WId(), and warning\-Yes\-No\-WId().

Referenced by message\-Box(), and queued\-Message\-Box\-WId().\index{KMessageBox@{KMessage\-Box}!queuedMessageBox@{queuedMessageBox}}
\index{queuedMessageBox@{queuedMessageBox}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KMessage\-Box::queued\-Message\-Box ({\bf QWidget} $\ast$ {\em parent}, Dialog\-Type {\em type}, const {\bf QString} \& {\em text}, const {\bf QString} \& {\em caption}, int {\em options})\hspace{0.3cm}{\tt  [static]}}\label{classKMessageBox_e40}


Like message\-Box. 

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

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

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

Definition at line 1050 of file kmessagebox.cpp.

References queued\-Message\-Box\-WId().\index{KMessageBox@{KMessage\-Box}!queuedMessageBoxWId@{queuedMessageBoxWId}}
\index{queuedMessageBoxWId@{queuedMessageBoxWId}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KMessage\-Box::queued\-Message\-Box\-WId (WId {\em parent\_\-id}, Dialog\-Type {\em type}, const {\bf QString} \& {\em text}, const {\bf QString} \& {\em caption}, int {\em options})\hspace{0.3cm}{\tt  [static]}}\label{classKMessageBox_e41}


This function accepts the window id of the parent window, instead of QWidget$\ast$. 

It should be used only when necessary. \begin{Desc}
\item[Since:]3.2 \end{Desc}


Definition at line 1055 of file kmessagebox.cpp.

References message\-Box\-WId().

Referenced by queued\-Message\-Box().\index{KMessageBox@{KMessage\-Box}!queuedMessageBox@{queuedMessageBox}}
\index{queuedMessageBox@{queuedMessageBox}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KMessage\-Box::queued\-Message\-Box ({\bf QWidget} $\ast$ {\em parent}, Dialog\-Type {\em type}, const {\bf QString} \& {\em text}, const {\bf QString} \& {\em caption} = {\tt QString::null})\hspace{0.3cm}{\tt  [static]}}\label{classKMessageBox_e42}


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

This is an overloaded member function, provided for convenience. It behaves essentially like the above function. 

Definition at line 1063 of file kmessagebox.cpp.

References queued\-Message\-Box\-WId().\index{KMessageBox@{KMessage\-Box}!queuedMessageBoxWId@{queuedMessageBoxWId}}
\index{queuedMessageBoxWId@{queuedMessageBoxWId}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KMessage\-Box::queued\-Message\-Box\-WId (WId {\em parent\_\-id}, Dialog\-Type {\em type}, const {\bf QString} \& {\em text}, const {\bf QString} \& {\em caption} = {\tt QString::null})\hspace{0.3cm}{\tt  [static]}}\label{classKMessageBox_e43}


This function accepts the window id of the parent window, instead of QWidget$\ast$. 

It should be used only when necessary. \begin{Desc}
\item[Since:]3.2 \end{Desc}


Definition at line 1068 of file kmessagebox.cpp.

References message\-Box\-WId().\index{KMessageBox@{KMessage\-Box}!shouldBeShownYesNo@{shouldBeShownYesNo}}
\index{shouldBeShownYesNo@{shouldBeShownYesNo}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KMessage\-Box::should\-Be\-Shown\-Yes\-No (const {\bf QString} \& {\em dont\-Show\-Again\-Name}, {\bf Button\-Code} \& {\em result})\hspace{0.3cm}{\tt  [static]}}\label{classKMessageBox_e44}


\begin{Desc}
\item[Returns:]true if the corresponding yes/no message box should be shown. \end{Desc}
\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em dont\-Show\-Again\-Name}]the name that identify the message box. If empty, true is always returned. \item[{\em result}]is set to the result (Yes or No) that was chosen the last time the message box was shown. Only meaningful, if the message box should not be shown. \end{description}
\end{Desc}
\begin{Desc}
\item[Since:]3.2 \end{Desc}


Definition at line 343 of file kmessagebox.cpp.

References KGlobal::config(), QString::from\-Latin1(), QString::lower(), and KConfig\-Base::read\-Entry().

Referenced by question\-Yes\-No\-Cancel\-WId(), question\-Yes\-No\-List\-WId(), warning\-Yes\-No\-Cancel\-List\-WId(), and warning\-Yes\-No\-List\-WId().\index{KMessageBox@{KMessage\-Box}!shouldBeShownContinue@{shouldBeShownContinue}}
\index{shouldBeShownContinue@{shouldBeShownContinue}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KMessage\-Box::should\-Be\-Shown\-Continue (const {\bf QString} \& {\em dont\-Show\-Again\-Name})\hspace{0.3cm}{\tt  [static]}}\label{classKMessageBox_e45}


\begin{Desc}
\item[Returns:]true if the corresponding continue/cancel message box should be shown. \end{Desc}
\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em dont\-Show\-Again\-Name}]the name that identify the message box. If empty, true is always returned. \end{description}
\end{Desc}
\begin{Desc}
\item[Since:]3.2 \end{Desc}


Definition at line 363 of file kmessagebox.cpp.

References KGlobal::config(), QString::from\-Latin1(), and KConfig\-Base::read\-Bool\-Entry().

Referenced by information\-List\-WId(), and warning\-Continue\-Cancel\-List\-WId().\index{KMessageBox@{KMessage\-Box}!saveDontShowAgainYesNo@{saveDontShowAgainYesNo}}
\index{saveDontShowAgainYesNo@{saveDontShowAgainYesNo}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KMessage\-Box::save\-Dont\-Show\-Again\-Yes\-No (const {\bf QString} \& {\em dont\-Show\-Again\-Name}, {\bf Button\-Code} {\em result})\hspace{0.3cm}{\tt  [static]}}\label{classKMessageBox_e46}


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

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em dont\-Show\-Again\-Name}]the name that identify the message box. If empty, this method does nothing. \item[{\em result}]the value (Yes or No) that should be used as the result for the message box. \end{description}
\end{Desc}
\begin{Desc}
\item[Since:]3.2 \end{Desc}


Definition at line 373 of file kmessagebox.cpp.

References KGlobal::config(), QString::from\-Latin1(), KConfig\-Base::sync(), and KConfig\-Base::write\-Entry().

Referenced by question\-Yes\-No\-Cancel\-WId(), question\-Yes\-No\-List\-WId(), warning\-Yes\-No\-Cancel\-List\-WId(), and warning\-Yes\-No\-List\-WId().\index{KMessageBox@{KMessage\-Box}!saveDontShowAgainContinue@{saveDontShowAgainContinue}}
\index{saveDontShowAgainContinue@{saveDontShowAgainContinue}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KMessage\-Box::save\-Dont\-Show\-Again\-Continue (const {\bf QString} \& {\em dont\-Show\-Again\-Name})\hspace{0.3cm}{\tt  [static]}}\label{classKMessageBox_e47}


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

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em dont\-Show\-Again\-Name}]the name that identify the message box. If empty, this method does nothing. \end{description}
\end{Desc}
\begin{Desc}
\item[Since:]3.2 \end{Desc}


Definition at line 385 of file kmessagebox.cpp.

References KGlobal::config(), QString::from\-Latin1(), KConfig\-Base::sync(), and KConfig\-Base::write\-Entry().

Referenced by information\-List\-WId(), and warning\-Continue\-Cancel\-List\-WId().\index{KMessageBox@{KMessage\-Box}!setDontShowAskAgainConfig@{setDontShowAskAgainConfig}}
\index{setDontShowAskAgainConfig@{setDontShowAskAgainConfig}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KMessage\-Box::set\-Dont\-Show\-Ask\-Again\-Config ({\bf KConfig} $\ast$ {\em cfg})\hspace{0.3cm}{\tt  [static]}}\label{classKMessageBox_e48}


Use {\tt cfg} for all settings related to the dont\-Show\-Again\-Name feature. 

If {\tt cfg} is 0 (default) {\bf KGlobal::config()} will be used. \begin{Desc}
\item[Since:]3.2 \end{Desc}


Definition at line 397 of file kmessagebox.cpp.\index{KMessageBox@{KMessage\-Box}!createKMessageBox@{createKMessageBox}}
\index{createKMessageBox@{createKMessageBox}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}int KMessage\-Box::create\-KMessage\-Box ({\bf KDialog\-Base} $\ast$ {\em dialog}, QMessage\-Box::Icon {\em icon}, const {\bf QString} \& {\em text}, const {\bf QString\-List} \& {\em strlist}, const {\bf QString} \& {\em ask}, bool $\ast$ {\em checkbox\-Return}, int {\em options}, const {\bf QString} \& {\em details} = {\tt QString::null})\hspace{0.3cm}{\tt  [static]}}\label{classKMessageBox_e49}


Create content and layout of a standard dialog. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em dialog}]The parent dialog base \item[{\em icon}]Which predefined icon the message box shall show. \item[{\em text}]Message string. \item[{\em strlist}]List of strings to be written in the listbox. If the list is empty, it doesn't show any listbox \item[{\em ask}]The text of the checkbox. If empty none will be shown. \item[{\em checkbox\-Return}]The result of the checkbox. If it's initially true then the checkbox will be checked by default. \item[{\em options}]see Options\-Type \item[{\em details}]Detailed message string. \end{description}
\end{Desc}
\begin{Desc}
\item[Since:]3.3 \end{Desc}
\begin{Desc}
\item[Returns:]A {\bf KDialog\-Base}{\rm (p.\,\pageref{classKDialogBase})} button code, not a KMessage\-Box button code, based on the buttonmask given to the constructor of the {\tt dialog} (ie. will return KDialog\-Base::Yes [256] instead of KMessage\-Box::Yes [3]). Will return KMessage\-Box::Cancel if the message box is queued for display instead of exec()ed immediately or if the option No\-Exec is set. \end{Desc}
\begin{Desc}
\item[Note:]The {\tt dialog} that is passed in is deleted by this function. Do not delete it yourself. \end{Desc}


Definition at line 142 of file kmessagebox.cpp.

Referenced by about(), detailed\-Error\-WId(), detailed\-Sorry\-WId(), error\-List\-WId(), information\-List\-WId(), question\-Yes\-No\-Cancel\-WId(), question\-Yes\-No\-List\-WId(), sorry\-WId(), warning\-Continue\-Cancel\-List\-WId(), warning\-Yes\-No\-Cancel\-List\-WId(), and warning\-Yes\-No\-List\-WId().\index{KMessageBox@{KMessage\-Box}!createKMessageBox@{createKMessageBox}}
\index{createKMessageBox@{createKMessageBox}!KMessageBox@{KMessage\-Box}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}int KMessage\-Box::create\-KMessage\-Box ({\bf KDialog\-Base} $\ast$ {\em dialog}, {\bf QPixmap} {\em icon}, const {\bf QString} \& {\em text}, const {\bf QString\-List} \& {\em strlist}, const {\bf QString} \& {\em ask}, bool $\ast$ {\em checkbox\-Return}, int {\em options}, const {\bf QString} \& {\em details} = {\tt QString::null}, QMessage\-Box::Icon {\em notify\-Type} = {\tt QMessageBox::Information})\hspace{0.3cm}{\tt  [static]}}\label{classKMessageBox_e50}


Create content and layout of a standard dialog. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em dialog}]The parent dialog base \item[{\em icon}]A {\bf QPixmap} containing the icon to be displayed in the dialog next to the text. \item[{\em text}]Message string. \item[{\em strlist}]List of strings to be written in the listbox. If the list is empty, it doesn't show any listbox \item[{\em ask}]The text of the checkbox. If empty none will be shown. \item[{\em checkbox\-Return}]The result of the checkbox. If it's initially true then the checkbox will be checked by default. \item[{\em options}]see Options\-Type \item[{\em details}]Detailed message string. \item[{\em notify\-Type}]The type of notification to send when this message is presentend. \end{description}
\end{Desc}
\begin{Desc}
\item[Since:]3.3 \end{Desc}
\begin{Desc}
\item[Returns:]A {\bf KDialog\-Base}{\rm (p.\,\pageref{classKDialogBase})} button code, not a KMessage\-Box button code, based on the buttonmask given to the constructor of the {\tt dialog} (ie. will return KDialog\-Base::Yes [256] instead of KMessage\-Box::Yes [3]). Will return KMessage\-Box::Cancel if the message box is queued for display instead of exec()ed immediately or if the option No\-Exec is set. \end{Desc}
\begin{Desc}
\item[Note:]The {\tt dialog} that is passed in is deleted by this function. Do not delete it yourself. \end{Desc}


Definition at line 151 of file kmessagebox.cpp.

References KGlobal\-Settings::desktop\-Geometry(), QObject::disconnect(), QRect::height(), QList\-Box::insert\-String\-List(), QPush\-Button::is\-Default(), QPixmap::is\-Null(), No\-Exec, QLabel::set\-Pixmap(), QText\-Edit::set\-Read\-Only(), QList\-Box::set\-Selection\-Mode(), QRect::set\-Width(), KActive\-Label::size\-Hint(), and QRect::width().

The documentation for this class was generated from the following files:\begin{CompactItemize}
\item 
kmessagebox.h\item 
kmessagebox.cpp\end{CompactItemize}
