\section{KDialog Class Reference}
\label{classKDialog}\index{KDialog@{KDialog}}
Dialog with extended nonmodal support and methods for {\bf KDE} standard compliance.  


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

Inheritance diagram for KDialog:\begin{figure}[H]
\begin{center}
\leavevmode
\includegraphics[width=98pt]{classKDialog__inherit__graph}
\end{center}
\end{figure}
Collaboration diagram for KDialog:\begin{figure}[H]
\begin{center}
\leavevmode
\includegraphics[width=43pt]{classKDialog__coll__graph}
\end{center}
\end{figure}
\subsection*{Public Slots}
\begin{CompactItemize}
\item 
virtual void {\bf polish} ()\label{classKDialog_i0}

\item 
virtual void {\bf set\-Caption} (const  {\bf QString} \&caption)
\begin{CompactList}\small\item\em Make a {\bf KDE} compliant caption. \item\end{CompactList}\item 
virtual void {\bf set\-Plain\-Caption} (const  {\bf QString} \&caption)
\begin{CompactList}\small\item\em Make a plain caption without any modifications. \item\end{CompactList}\end{CompactItemize}
\subsection*{Signals}
\begin{CompactItemize}
\item 
void {\bf layout\-Hint\-Changed} ()
\begin{CompactList}\small\item\em Emitted when the margin size and/or spacing size have changed. \item\end{CompactList}\end{CompactItemize}
\subsection*{Public Member Functions}
\begin{CompactItemize}
\item 
{\bf KDialog} ({\bf QWidget} $\ast$parent=0, const  char $\ast$name=0, bool modal=false, WFlags f=0)
\begin{CompactList}\small\item\em Constructor. \item\end{CompactList}\end{CompactItemize}
\subsection*{Static Public Member Functions}
\begin{CompactItemize}
\item 
int {\bf margin\-Hint} ()
\begin{CompactList}\small\item\em Return the number of pixels you shall use between a dialog edge and the outermost widget(s) according to the {\bf KDE} standard. \item\end{CompactList}\item 
int {\bf spacing\-Hint} ()
\begin{CompactList}\small\item\em Return the number of pixels you shall use between widgets inside a dialog according to the {\bf KDE} standard. \item\end{CompactList}\item 
void {\bf resize\-Layout} ({\bf QWidget} $\ast$widget, int margin, int spacing)
\begin{CompactList}\small\item\em Resize every layout manager used in {\tt widget} and its nested children. \item\end{CompactList}\item 
void {\bf resize\-Layout} ({\bf QLayout\-Item} $\ast$lay, int margin, int spacing)
\begin{CompactList}\small\item\em Reszie every layout associated with {\tt lay} and its children. \item\end{CompactList}\item 
void {\bf center\-On\-Screen} ({\bf QWidget} $\ast$widget, int screen=-1)
\begin{CompactList}\small\item\em Centers {\tt widget} on the desktop, taking multi-head setups into account. \item\end{CompactList}\end{CompactItemize}
\subsection*{Protected Member Functions}
\begin{CompactItemize}
\item 
virtual void {\bf key\-Press\-Event} ({\bf QKey\-Event} $\ast$)\label{classKDialog_b0}

\item 
virtual void {\bf virtual\_\-hook} (int id, void $\ast$data)\label{classKDialog_b1}

\end{CompactItemize}


\subsection{Detailed Description}
Dialog with extended nonmodal support and methods for {\bf KDE} standard compliance. 

Generally, you should not use this class directly, but {\bf KDialog\-Base}{\rm (p.\,\pageref{classKDialogBase})} which inherits KDialog.

If the dialog is non-modal and has a parent, the default keybindings ({\tt escape} = {\tt {\bf reject()}}, {\tt enter} = {\tt {\bf accept()}}, etc.) are disabled.

The {\bf margin\-Hint}{\rm (p.\,\pageref{classKDialog_e0})}() and {\bf spacing\-Hint}{\rm (p.\,\pageref{classKDialog_e1})}() sizes shall be used whenever you layout the interior of a dialog. One special note. If you make your own action buttons (OK, Cancel etc), the space beteween the buttons shall be {\bf spacing\-Hint}{\rm (p.\,\pageref{classKDialog_e1})}(), whereas the space above, below, to the right and to the left shall be {\bf margin\-Hint}{\rm (p.\,\pageref{classKDialog_e0})}(). If you add a separator line above the buttons, there shall be a {\bf margin\-Hint}{\rm (p.\,\pageref{classKDialog_e0})}() between the buttons and the separator and a {\bf margin\-Hint}{\rm (p.\,\pageref{classKDialog_e0})}() above the separator as well.

\begin{Desc}
\item[See also:]{\bf KDialog\-Base}{\rm (p.\,\pageref{classKDialogBase})} \end{Desc}
\begin{Desc}
\item[Author:]Thomas Tanghus $<${\tt tanghus@earthling.net}$>$, Espen Sand $<${\tt espensa@online.no}$>$ \end{Desc}
\begin{Desc}
\item[Version:]0.1.2 \end{Desc}




Definition at line 51 of file kdialog.h.

\subsection{Constructor \& Destructor Documentation}
\index{KDialog@{KDialog}!KDialog@{KDialog}}
\index{KDialog@{KDialog}!KDialog@{KDialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KDialog::KDialog ({\bf QWidget} $\ast$ {\em parent} = 0, const char $\ast$ {\em name} = 0, bool {\em modal} = false, WFlags {\em f} = 0)}\label{classKDialog_a0}


Constructor. 

Takes the same arguments as {\bf QDialog}. 

Definition at line 39 of file kdialog.cpp.

References KStd\-Accel::name().

\subsection{Member Function Documentation}
\index{KDialog@{KDialog}!marginHint@{marginHint}}
\index{marginHint@{marginHint}!KDialog@{KDialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}int KDialog::margin\-Hint ()\hspace{0.3cm}{\tt  [static]}}\label{classKDialog_e0}


Return the number of pixels you shall use between a dialog edge and the outermost widget(s) according to the {\bf KDE} standard. 



Definition at line 92 of file kdialog.cpp.

Referenced by KHelp\-Menu::about\-Application(), KDialog\-Base::enable\-Linked\-Help(), KDialog\-Base::get\-Border\-Widths(), KDialog\-Base::get\-Contents\-Rect(), KFont\-Chooser::KFont\-Chooser(), KJanus\-Widget::KJanus\-Widget(), KTip\-Dialog::KTip\-Dialog(), KPassive\-Popup::set\-View(), and KDialog\-Base::update\-Geometry().\index{KDialog@{KDialog}!spacingHint@{spacingHint}}
\index{spacingHint@{spacingHint}!KDialog@{KDialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}int KDialog::spacing\-Hint ()\hspace{0.3cm}{\tt  [static]}}\label{classKDialog_e1}


Return the number of pixels you shall use between widgets inside a dialog according to the {\bf KDE} standard. 



Definition at line 98 of file kdialog.cpp.

Referenced by KHelp\-Menu::about\-Application(), KJanus\-Widget::add\-Grid\-Page(), KJanus\-Widget::add\-HBox\-Page(), KJanus\-Widget::add\-VBox\-Page(), KBug\-Report::KBug\-Report(), KChar\-Select::KChar\-Select(), KFont\-Chooser::KFont\-Chooser(), KJanus\-Widget::KJanus\-Widget(), KLine\-Edit\-Dlg::KLine\-Edit\-Dlg(), KTip\-Dialog::KTip\-Dialog(), KDialog\-Base::make\-Grid\-Main\-Widget(), KDialog\-Base::make\-HBox\-Main\-Widget(), KDialog\-Base::make\-VBox\-Main\-Widget(), KJanus\-Widget::minimum\-Size\-Hint(), KDialog\-Base::set\-Button\-Apply\-Text(), KDialog\-Base::set\-Button\-Cancel\-Text(), KDialog\-Base::set\-Button\-OKText(), KDialog\-Base::set\-Button\-Text(), KPassive\-Popup::set\-View(), KPassive\-Popup::standard\-View(), and KDialog\-Base::update\-Geometry().\index{KDialog@{KDialog}!resizeLayout@{resizeLayout}}
\index{resizeLayout@{resizeLayout}!KDialog@{KDialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KDialog::resize\-Layout ({\bf QWidget} $\ast$ {\em widget}, int {\em margin}, int {\em spacing})\hspace{0.3cm}{\tt  [static]}}\label{classKDialog_e2}


Resize every layout manager used in {\tt widget} and its nested children. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em margin}]The new layout margin. \item[{\em margin}]The new layout spacing. \end{description}
\end{Desc}


Definition at line 132 of file kdialog.cpp.

References QObject::is\-Widget\-Type(), and QWidget::layout().

Referenced by resize\-Layout().\index{KDialog@{KDialog}!resizeLayout@{resizeLayout}}
\index{resizeLayout@{resizeLayout}!KDialog@{KDialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KDialog::resize\-Layout ({\bf QLayout\-Item} $\ast$ {\em lay}, int {\em margin}, int {\em spacing})\hspace{0.3cm}{\tt  [static]}}\label{classKDialog_e3}


Reszie every layout associated with {\tt lay} and its children. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em margin}]The new layout margin \item[{\em margin}]The new layout spacing \end{description}
\end{Desc}


Definition at line 154 of file kdialog.cpp.

References QLayout\-Iterator::current(), QLayout\-Item::iterator(), QLayout\-Item::layout(), and resize\-Layout().\index{KDialog@{KDialog}!centerOnScreen@{centerOnScreen}}
\index{centerOnScreen@{centerOnScreen}!KDialog@{KDialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KDialog::center\-On\-Screen ({\bf QWidget} $\ast$ {\em widget}, int {\em screen} = -1)\hspace{0.3cm}{\tt  [static]}}\label{classKDialog_e4}


Centers {\tt widget} on the desktop, taking multi-head setups into account. 

If {\tt screen} is -1, {\tt widget} will be centered on its current screen (if it was shown already) or on the primary screen. \begin{Desc}
\item[Since:]3.1 \end{Desc}


Definition at line 170 of file kdialog.cpp.

References QRect::center(), QApplication::desktop(), QWidget::height(), QWidget::move(), QDesktop\-Widget::num\-Screens(), QDesktop\-Widget::primary\-Screen(), QDesktop\-Widget::screen\-Geometry(), QDesktop\-Widget::screen\-Number(), and QWidget::width().\index{KDialog@{KDialog}!setCaption@{setCaption}}
\index{setCaption@{setCaption}!KDialog@{KDialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KDialog::set\-Caption (const {\bf QString} \& {\em caption})\hspace{0.3cm}{\tt  [virtual, slot]}}\label{classKDialog_i1}


Make a {\bf KDE} compliant caption. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em caption}]Your caption. Do {\tt not} include the application name in this string. It will be added automatically according to the {\bf KDE} standard. \end{description}
\end{Desc}


Definition at line 114 of file kdialog.cpp.

References set\-Plain\-Caption().

Referenced by KLine\-Edit\-Dlg::get\-Text(), KDialog\-Base::KDialog\-Base(), and KTip\-Dialog::KTip\-Dialog().\index{KDialog@{KDialog}!setPlainCaption@{setPlainCaption}}
\index{setPlainCaption@{setPlainCaption}!KDialog@{KDialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KDialog::set\-Plain\-Caption (const {\bf QString} \& {\em caption})\hspace{0.3cm}{\tt  [virtual, slot]}}\label{classKDialog_i2}


Make a plain caption without any modifications. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em caption}]Your caption. This is the string that will be displayed in the window title. \end{description}
\end{Desc}


Definition at line 121 of file kdialog.cpp.

References QString::utf8().

Referenced by KHelp\-Menu::about\-Application(), KAbout\-Dialog::image\-URL(), KAbout\-Dialog::KAbout\-Dialog(), and set\-Caption().\index{KDialog@{KDialog}!layoutHintChanged@{layoutHintChanged}}
\index{layoutHintChanged@{layoutHintChanged}!KDialog@{KDialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KDialog::layout\-Hint\-Changed ()\hspace{0.3cm}{\tt  [signal]}}\label{classKDialog_l0}


Emitted when the margin size and/or spacing size have changed. 

Use {\bf margin\-Hint}{\rm (p.\,\pageref{classKDialog_e0})}() and {\bf spacing\-Hint}{\rm (p.\,\pageref{classKDialog_e1})}() in your slot to get the new values. 

Referenced by KDialog\-Base::KDialog\-Base().

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