\section{KProgress\-Dialog Class Reference}
\label{classKProgressDialog}\index{KProgressDialog@{KProgressDialog}}
KProgress\-Dialog provides a dialog with a text label, a progress bar and an optional cancel button with a {\bf KDE} look 'n feel. A dialog with a progress bar.  


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

Inheritance diagram for KProgress\-Dialog:\begin{figure}[H]
\begin{center}
\leavevmode
\includegraphics[width=63pt]{classKProgressDialog__inherit__graph}
\end{center}
\end{figure}
Collaboration diagram for KProgress\-Dialog:\begin{figure}[H]
\begin{center}
\leavevmode
\includegraphics[width=226pt]{classKProgressDialog__coll__graph}
\end{center}
\end{figure}
\subsection*{Public Member Functions}
\begin{CompactItemize}
\item 
{\bf KProgress\-Dialog} ({\bf QWidget} $\ast$parent=0, const char $\ast$name=0, const {\bf QString} \&caption=QString::null, const {\bf QString} \&text=QString::null, bool modal=false)
\item 
{\bf $\sim$KProgress\-Dialog} ()
\item 
{\bf KProgress} $\ast$ {\bf progress\-Bar} ()
\item 
const {\bf KProgress} $\ast$ {\bf progress\-Bar} () const 
\item 
void {\bf set\-Label} (const {\bf QString} \&text)
\item 
{\bf QString} {\bf label\-Text} () KDE\_\-DEPRECATED
\item 
{\bf QString} {\bf label\-Text} () const 
\item 
void {\bf set\-Allow\-Cancel} (bool allow\-Cancel)
\item 
bool {\bf allow\-Cancel} () KDE\_\-DEPRECATED
\item 
bool {\bf allow\-Cancel} () const 
\item 
void {\bf show\-Cancel\-Button} (bool {\bf show})
\item 
void {\bf set\-Auto\-Close} (bool close)
\item 
bool {\bf auto\-Close} ()
\item 
bool {\bf auto\-Close} () const 
\item 
void {\bf set\-Auto\-Reset} (bool auto\-Reset)
\item 
bool {\bf auto\-Reset} ()
\item 
bool {\bf auto\-Reset} () const 
\item 
bool {\bf was\-Cancelled} ()
\item 
bool {\bf was\-Cancelled} () const 
\item 
void {\bf set\-Button\-Text} (const {\bf QString} \&)
\item 
{\bf QString} {\bf button\-Text} () KDE\_\-DEPRECATED
\item 
{\bf QString} {\bf button\-Text} () const 
\item 
void {\bf set\-Minimum\-Duration} (int ms)
\item 
int {\bf minimum\-Duration} () KDE\_\-DEPRECATED
\item 
int {\bf minimum\-Duration} () const 
\end{CompactItemize}
\subsection*{Protected Slots}
\begin{CompactItemize}
\item 
void {\bf slot\-Auto\-Show} ()\label{classKProgressDialog_j0}

\item 
void {\bf slot\-Auto\-Actions} (int percentage)\label{classKProgressDialog_j1}

\item 
void {\bf slot\-Cancel} ()
\end{CompactItemize}
\subsection*{Protected Member Functions}
\begin{CompactItemize}
\item 
virtual void {\bf virtual\_\-hook} (int id, void $\ast$data)\label{classKProgressDialog_b0}

\end{CompactItemize}


\subsection{Detailed Description}
KProgress\-Dialog provides a dialog with a text label, a progress bar and an optional cancel button with a {\bf KDE} look 'n feel. A dialog with a progress bar. 

Since knowing how long it can take to complete an action and it is undesirable to show a dialog for a split second before hiding it, there are a few ways to control the timing behavior of KProgress\-Dialog. There is a time out that can be set before showing the dialog as well as an option to autohide or keep displaying the dialog once complete.

All the functionality of {\bf KProgress}{\rm (p.\,\pageref{classKProgress})} is available through direct access to the progress bar widget via {\bf progress\-Bar()}{\rm (p.\,\pageref{classKProgressDialog_a2})};

\begin{Desc}
\item[Author:]Aaron J. Seigo \end{Desc}




Definition at line 187 of file kprogress.h.

\subsection{Constructor \& Destructor Documentation}
\index{KProgressDialog@{KProgress\-Dialog}!KProgressDialog@{KProgressDialog}}
\index{KProgressDialog@{KProgressDialog}!KProgressDialog@{KProgress\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KProgress\-Dialog::KProgress\-Dialog ({\bf QWidget} $\ast$ {\em parent} = {\tt 0}, const char $\ast$ {\em name} = {\tt 0}, const {\bf QString} \& {\em caption} = {\tt QString::null}, const {\bf QString} \& {\em text} = {\tt QString::null}, bool {\em modal} = {\tt false})}\label{classKProgressDialog_a0}


Constructs a KProgress\-Dialog. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em parent}]Parent of the widget \item[{\em name}]Widget name \item[{\em caption}]Text to display in window title bar \item[{\em text}]Text to display in the dialog \item[{\em modal}]Set to true to make the dialog modal \end{description}
\end{Desc}


Definition at line 169 of file kprogress.cpp.

References KDialog\-Base::action\-Button(), KDialog\-Base::plain\-Page(), KDialog\-Base::show\-Button(), QTimer::start(), and QPush\-Button::text().\index{KProgressDialog@{KProgress\-Dialog}!~KProgressDialog@{$\sim$KProgressDialog}}
\index{~KProgressDialog@{$\sim$KProgressDialog}!KProgressDialog@{KProgress\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KProgress\-Dialog::$\sim${\bf KProgress\-Dialog} ()}\label{classKProgressDialog_a1}


Destructor. 



Definition at line 205 of file kprogress.cpp.

\subsection{Member Function Documentation}
\index{KProgressDialog@{KProgress\-Dialog}!progressBar@{progressBar}}
\index{progressBar@{progressBar}!KProgressDialog@{KProgress\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf KProgress} $\ast$ KProgress\-Dialog::progress\-Bar ()}\label{classKProgressDialog_a2}


Returns the {\bf KProgress}{\rm (p.\,\pageref{classKProgress})} used in this dialog. 

To set the number of steps or other progress bar related settings, access the {\bf KProgress}{\rm (p.\,\pageref{classKProgress})} object directly via this method. 

Definition at line 279 of file kprogress.cpp.\index{KProgressDialog@{KProgress\-Dialog}!progressBar@{progressBar}}
\index{progressBar@{progressBar}!KProgressDialog@{KProgress\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}const {\bf KProgress} $\ast$ KProgress\-Dialog::progress\-Bar () const}\label{classKProgressDialog_a3}


Returns the {\bf KProgress}{\rm (p.\,\pageref{classKProgress})} used in this dialog. 

To set the number of steps or other progress bar related settings, access the {\bf KProgress}{\rm (p.\,\pageref{classKProgress})} object directly via this method. 

Definition at line 284 of file kprogress.cpp.\index{KProgressDialog@{KProgress\-Dialog}!setLabel@{setLabel}}
\index{setLabel@{setLabel}!KProgressDialog@{KProgress\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KProgress\-Dialog::set\-Label (const {\bf QString} \& {\em text})}\label{classKProgressDialog_a4}


Sets the text in the dialog. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em text}]the text to display \end{description}
\end{Desc}


Definition at line 289 of file kprogress.cpp.

References QLabel::set\-Text().\index{KProgressDialog@{KProgress\-Dialog}!labelText@{labelText}}
\index{labelText@{labelText}!KProgressDialog@{KProgress\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString} KProgress\-Dialog::label\-Text ()}\label{classKProgressDialog_a5}


Returns the current dialog text. 

\begin{Desc}
\item[{\bf Deprecated}]\end{Desc}


Definition at line 295 of file kprogress.cpp.

References QLabel::text().\index{KProgressDialog@{KProgress\-Dialog}!labelText@{labelText}}
\index{labelText@{labelText}!KProgressDialog@{KProgress\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString} KProgress\-Dialog::label\-Text () const}\label{classKProgressDialog_a6}


Returns the current dialog text. 



Definition at line 300 of file kprogress.cpp.

References QLabel::text().\index{KProgressDialog@{KProgress\-Dialog}!setAllowCancel@{setAllowCancel}}
\index{setAllowCancel@{setAllowCancel}!KProgressDialog@{KProgress\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KProgress\-Dialog::set\-Allow\-Cancel (bool {\em allow\-Cancel})}\label{classKProgressDialog_a7}


Sets whether or not the user can cancel the process. 

If the dialog is cancellable, the Cancel button will be shown and the user can close the window using the window decorations. If the process is not (or should not be) interuptable, set the dialog to be modal and not cancellable.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em allow\-Cancel}]Set to true to make the dialog non-closable \end{description}
\end{Desc}


Definition at line 262 of file kprogress.cpp.

References show\-Cancel\-Button().\index{KProgressDialog@{KProgress\-Dialog}!allowCancel@{allowCancel}}
\index{allowCancel@{allowCancel}!KProgressDialog@{KProgress\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KProgress\-Dialog::allow\-Cancel ()}\label{classKProgressDialog_a8}


Returns true if the dialog can be canceled, false otherwise. 

\begin{Desc}
\item[{\bf Deprecated}]\end{Desc}


Definition at line 269 of file kprogress.cpp.\index{KProgressDialog@{KProgress\-Dialog}!allowCancel@{allowCancel}}
\index{allowCancel@{allowCancel}!KProgressDialog@{KProgress\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KProgress\-Dialog::allow\-Cancel () const}\label{classKProgressDialog_a9}


Returns true if the dialog can be canceled, false otherwise. 



Definition at line 274 of file kprogress.cpp.\index{KProgressDialog@{KProgress\-Dialog}!showCancelButton@{showCancelButton}}
\index{showCancelButton@{showCancelButton}!KProgressDialog@{KProgress\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KProgress\-Dialog::show\-Cancel\-Button (bool {\em show})}\label{classKProgressDialog_a10}


Sets whether the cancel button is visible. 

set\-Allow\-Cancel(false) implies show\-Cancel\-Button(false)

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em show}]Whether or not the cancel button should be shown \end{description}
\end{Desc}


Definition at line 305 of file kprogress.cpp.

References KDialog\-Base::show\-Button\-Cancel().

Referenced by set\-Allow\-Cancel().\index{KProgressDialog@{KProgress\-Dialog}!setAutoClose@{setAutoClose}}
\index{setAutoClose@{setAutoClose}!KProgressDialog@{KProgress\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KProgress\-Dialog::set\-Auto\-Close (bool {\em close})}\label{classKProgressDialog_a11}


Sets whether the dialog should close automagically when all the steps in the {\bf KProgress}{\rm (p.\,\pageref{classKProgress})} have been completed. 



Definition at line 321 of file kprogress.cpp.\index{KProgressDialog@{KProgress\-Dialog}!autoClose@{autoClose}}
\index{autoClose@{autoClose}!KProgressDialog@{KProgress\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KProgress\-Dialog::auto\-Close ()}\label{classKProgressDialog_a12}


Returns true if the dialog will close upon completion, or false otherwise. 



Definition at line 311 of file kprogress.cpp.\index{KProgressDialog@{KProgress\-Dialog}!autoClose@{autoClose}}
\index{autoClose@{autoClose}!KProgressDialog@{KProgress\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KProgress\-Dialog::auto\-Close () const}\label{classKProgressDialog_a13}


Returns true if the dialog will close upon completion, or false otherwise. 



Definition at line 316 of file kprogress.cpp.\index{KProgressDialog@{KProgress\-Dialog}!setAutoReset@{setAutoReset}}
\index{setAutoReset@{setAutoReset}!KProgressDialog@{KProgress\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KProgress\-Dialog::set\-Auto\-Reset (bool {\em auto\-Reset})}\label{classKProgressDialog_a14}


Sets whether the dialog should reset the {\bf KProgress}{\rm (p.\,\pageref{classKProgress})} dialog back to 0 steps compelete when all steps have been completed. 

This is useful for KProgress\-Dialogs that will be reused. 

Definition at line 337 of file kprogress.cpp.\index{KProgressDialog@{KProgress\-Dialog}!autoReset@{autoReset}}
\index{autoReset@{autoReset}!KProgressDialog@{KProgress\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KProgress\-Dialog::auto\-Reset ()}\label{classKProgressDialog_a15}


Returns true if the {\bf KProgress}{\rm (p.\,\pageref{classKProgress})} widget will be reset upon completion, or false otherwise. 



Definition at line 327 of file kprogress.cpp.\index{KProgressDialog@{KProgress\-Dialog}!autoReset@{autoReset}}
\index{autoReset@{autoReset}!KProgressDialog@{KProgress\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KProgress\-Dialog::auto\-Reset () const}\label{classKProgressDialog_a16}


Returns true if the {\bf KProgress}{\rm (p.\,\pageref{classKProgress})} widget will be reset upon completion, or false otherwise. 



Definition at line 332 of file kprogress.cpp.\index{KProgressDialog@{KProgress\-Dialog}!wasCancelled@{wasCancelled}}
\index{wasCancelled@{wasCancelled}!KProgressDialog@{KProgress\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KProgress\-Dialog::was\-Cancelled ()}\label{classKProgressDialog_a17}


Returns true if the dialog was closed or canceled before completion. 

If the dialog is not cancellable it will always return false. 

Definition at line 232 of file kprogress.cpp.\index{KProgressDialog@{KProgress\-Dialog}!wasCancelled@{wasCancelled}}
\index{wasCancelled@{wasCancelled}!KProgressDialog@{KProgress\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KProgress\-Dialog::was\-Cancelled () const}\label{classKProgressDialog_a18}


Returns true if the dialog was closed or canceled before completion. 

If the dialog is not cancellable it will always return false. 

Definition at line 237 of file kprogress.cpp.\index{KProgressDialog@{KProgress\-Dialog}!setButtonText@{setButtonText}}
\index{setButtonText@{setButtonText}!KProgressDialog@{KProgress\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KProgress\-Dialog::set\-Button\-Text (const {\bf QString} \&)}\label{classKProgressDialog_a19}


Sets the text to appear on the cancel button. 



Definition at line 342 of file kprogress.cpp.

References KDialog\-Base::set\-Button\-Cancel().\index{KProgressDialog@{KProgress\-Dialog}!buttonText@{buttonText}}
\index{buttonText@{buttonText}!KProgressDialog@{KProgress\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString} KProgress\-Dialog::button\-Text ()}\label{classKProgressDialog_a20}


Returns the text on the cancel button. 

\begin{Desc}
\item[{\bf Deprecated}]\end{Desc}


Definition at line 349 of file kprogress.cpp.\index{KProgressDialog@{KProgress\-Dialog}!buttonText@{buttonText}}
\index{buttonText@{buttonText}!KProgressDialog@{KProgress\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString} KProgress\-Dialog::button\-Text () const}\label{classKProgressDialog_a21}


Returns the text on the cancel button. 



Definition at line 354 of file kprogress.cpp.\index{KProgressDialog@{KProgress\-Dialog}!setMinimumDuration@{setMinimumDuration}}
\index{setMinimumDuration@{setMinimumDuration}!KProgressDialog@{KProgress\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KProgress\-Dialog::set\-Minimum\-Duration (int {\em ms})}\label{classKProgressDialog_a22}


Set the minimum number of milliseconds to wait before actually showing the dialog. 



Definition at line 242 of file kprogress.cpp.

References QTimer::start(), and QTimer::stop().\index{KProgressDialog@{KProgress\-Dialog}!minimumDuration@{minimumDuration}}
\index{minimumDuration@{minimumDuration}!KProgressDialog@{KProgress\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}int KProgress\-Dialog::minimum\-Duration ()}\label{classKProgressDialog_a23}


Returns the wait duration in milliseconds. 

\begin{Desc}
\item[{\bf Deprecated}]\end{Desc}


Definition at line 252 of file kprogress.cpp.\index{KProgressDialog@{KProgress\-Dialog}!minimumDuration@{minimumDuration}}
\index{minimumDuration@{minimumDuration}!KProgressDialog@{KProgress\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}int KProgress\-Dialog::minimum\-Duration () const}\label{classKProgressDialog_a24}


Returns the wait duration in milliseconds. 



Definition at line 257 of file kprogress.cpp.\index{KProgressDialog@{KProgress\-Dialog}!slotCancel@{slotCancel}}
\index{slotCancel@{slotCancel}!KProgressDialog@{KProgress\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KProgress\-Dialog::slot\-Cancel ()\hspace{0.3cm}{\tt  [protected, virtual, slot]}}\label{classKProgressDialog_j2}


Activated when the Cancel button has been clicked. 

The {\bf QDialog::reject()} is activated in regular mode and QDialog::done( Cancel ) when in message box mode. 

Reimplemented from {\bf KDialog\-Base} {\rm (p.\,\pageref{classKDialogBase_j11})}.

Definition at line 222 of file kprogress.cpp.

References KDialog\-Base::slot\-Cancel().

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