\section{KNotify\-Dialog Class Reference}
\label{classKNotifyDialog}\index{KNotifyDialog@{KNotifyDialog}}
KNotify\-Dialog presents an interface for configuring an application's KNotify events.  


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

Inheritance diagram for KNotify\-Dialog:\begin{figure}[H]
\begin{center}
\leavevmode
\includegraphics[width=60pt]{classKNotifyDialog__inherit__graph}
\end{center}
\end{figure}
Collaboration diagram for KNotify\-Dialog:\begin{figure}[H]
\begin{center}
\leavevmode
\includegraphics[width=60pt]{classKNotifyDialog__coll__graph}
\end{center}
\end{figure}
\subsection*{Public Member Functions}
\begin{CompactItemize}
\item 
{\bf KNotify\-Dialog} ({\bf QWidget} $\ast$parent=0, const  char $\ast$name=0, bool modal=true, const  {\bf KAbout\-Data} $\ast$about\-Data={\bf KGlobal::instance}() $\rightarrow$ about\-Data())
\begin{CompactList}\small\item\em If you want a non-modal dialog, you need to instantiate KNotify\-Dialog yourself instead of using the {\bf configure}{\rm (p.\,\pageref{classKNotifyDialog_e0})}() method. \item\end{CompactList}\item 
virtual {\bf $\sim$KNotify\-Dialog} ()
\begin{CompactList}\small\item\em Destroys the KNotify\-Dialog. \item\end{CompactList}\item 
virtual void {\bf add\-Application\-Events} (const  char $\ast$app\-Name)
\begin{CompactList}\small\item\em With this method, you can add the KNotify events of one eventsrc files to the view. \item\end{CompactList}\item 
virtual void {\bf add\-Application\-Events} (const  {\bf QString} \&path)
\begin{CompactList}\small\item\em With this method, you can add the KNotify events of one eventsrc files to the view. \item\end{CompactList}\item 
virtual void {\bf clear\-Application\-Events} ()
\begin{CompactList}\small\item\em Removes all the events added with {\bf add\-Application\-Events}{\rm (p.\,\pageref{classKNotifyDialog_a2})}(). \item\end{CompactList}\end{CompactItemize}
\subsection*{Static Public Member Functions}
\begin{CompactItemize}
\item 
int {\bf configure} ({\bf QWidget} $\ast$parent=0, const  char $\ast$name=0, const  {\bf KAbout\-Data} $\ast$about\-Data={\bf KGlobal::instance}() $\rightarrow$ about\-Data())
\begin{CompactList}\small\item\em Convenience method to create {\bf exec}() a modal KNotify\-Dialog. \item\end{CompactList}\end{CompactItemize}


\subsection{Detailed Description}
KNotify\-Dialog presents an interface for configuring an application's KNotify events. 

Rather than requiring the user to wade through the entire list of applications' events in KControl, your application can make the list of its own notifications available here.

Typical usage is calling the static {\bf configure}{\rm (p.\,\pageref{classKNotifyDialog_e0})}() method: \small\begin{alltt}
 (void) KNotifyDialog::configure( someParentWidget );
 \end{alltt}\normalsize 


\begin{Desc}
\item[Since:]3.1 \end{Desc}
\begin{Desc}
\item[Author:]Carsten Pfeiffer $<${\tt pfeiffer@kde.org}$>$ \end{Desc}




Definition at line 53 of file knotifydialog.h.

\subsection{Constructor \& Destructor Documentation}
\index{KNotifyDialog@{KNotify\-Dialog}!KNotifyDialog@{KNotifyDialog}}
\index{KNotifyDialog@{KNotifyDialog}!KNotifyDialog@{KNotify\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KNotify\-Dialog::KNotify\-Dialog ({\bf QWidget} $\ast$ {\em parent} = 0, const char $\ast$ {\em name} = 0, bool {\em modal} = true, const {\bf KAbout\-Data} $\ast$ {\em about\-Data} = {\bf KGlobal::instance}()-, about\-Data())}\label{classKNotifyDialog_a0}


If you want a non-modal dialog, you need to instantiate KNotify\-Dialog yourself instead of using the {\bf configure}{\rm (p.\,\pageref{classKNotifyDialog_e0})}() method. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em parent}]The parent widget for the dialog \item[{\em name}]The widget name \item[{\em modal}]If true, this will be a modal dialog, otherwise non-modal. \item[{\em about\-Data}]A pointer to a {\bf KAbout\-Data} object. {\bf KAbout\-Data::app\-Name}() will be used to find the KNotify events (in the eventsrc file). Set this to 0L if you want to add all events yourself with {\bf add\-Application\-Events}{\rm (p.\,\pageref{classKNotifyDialog_a2})}(). \end{description}
\end{Desc}
\index{KNotifyDialog@{KNotify\-Dialog}!~KNotifyDialog@{$\sim$KNotifyDialog}}
\index{~KNotifyDialog@{$\sim$KNotifyDialog}!KNotifyDialog@{KNotify\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KNotify\-Dialog::$\sim${\bf KNotify\-Dialog} ()\hspace{0.3cm}{\tt  [virtual]}}\label{classKNotifyDialog_a1}


Destroys the KNotify\-Dialog. 



Definition at line 123 of file knotifydialog.cpp.

\subsection{Member Function Documentation}
\index{KNotifyDialog@{KNotify\-Dialog}!configure@{configure}}
\index{configure@{configure}!KNotifyDialog@{KNotify\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}int KNotify\-Dialog::configure ({\bf QWidget} $\ast$ {\em parent} = 0, const char $\ast$ {\em name} = 0, const {\bf KAbout\-Data} $\ast$ {\em about\-Data} = {\bf KGlobal::instance}()-, about\-Data())\hspace{0.3cm}{\tt  [static]}}\label{classKNotifyDialog_e0}


Convenience method to create {\bf exec}() a modal KNotify\-Dialog. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em parent}]The parent widget for the dialog \item[{\em name}]The widget name \item[{\em about\-Data}]A pointer to a {\bf KAbout\-Data} object. {\bf KAbout\-Data::app\-Name}() will be used to find the KNotify events (in the eventsrc file). \end{description}
\end{Desc}
\begin{Desc}
\item[See also:]{\bf exec} for the return values. \end{Desc}
\begin{Desc}
\item[Returns:]The value of {\bf QDialog::exec()} \end{Desc}
\index{KNotifyDialog@{KNotify\-Dialog}!addApplicationEvents@{addApplicationEvents}}
\index{addApplicationEvents@{addApplicationEvents}!KNotifyDialog@{KNotify\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KNotify\-Dialog::add\-Application\-Events (const char $\ast$ {\em app\-Name})\hspace{0.3cm}{\tt  [virtual]}}\label{classKNotifyDialog_a2}


With this method, you can add the KNotify events of one eventsrc files to the view. 

KNotify\-Dialog can handle events for multiple applications (i.e. eventsrc files). Successive calls with a different {\tt app\-Name} will add them. \begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em app\-Name}]The application's name, i.e. the name passed to the {\bf KApplication} constructor or {\bf KAbout\-Data}. \end{description}
\end{Desc}
\begin{Desc}
\item[See also:]{\bf clear\-Application\-Events()}{\rm (p.\,\pageref{classKNotifyDialog_a4})} \end{Desc}


Definition at line 127 of file knotifydialog.cpp.

References QString::from\-Latin1(), and QString::from\-Utf8().\index{KNotifyDialog@{KNotify\-Dialog}!addApplicationEvents@{addApplicationEvents}}
\index{addApplicationEvents@{addApplicationEvents}!KNotifyDialog@{KNotify\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KNotify\-Dialog::add\-Application\-Events (const {\bf QString} \& {\em path})\hspace{0.3cm}{\tt  [virtual]}}\label{classKNotifyDialog_a3}


With this method, you can add the KNotify events of one eventsrc files to the view. 

KNotify\-Dialog can handle events for multiple applications (i.e. eventsrc files). Successive calls with a different {\tt path} will add them. \begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em path}]The absolute or relative path to the eventsrc file to be configured. A relative path would be e.g. \char`\"{}kwin/eventsrc\char`\"{}. \end{description}
\end{Desc}
\begin{Desc}
\item[See also:]{\bf clear\-Application\-Events()}{\rm (p.\,\pageref{classKNotifyDialog_a4})} \end{Desc}


Definition at line 133 of file knotifydialog.cpp.\index{KNotifyDialog@{KNotify\-Dialog}!clearApplicationEvents@{clearApplicationEvents}}
\index{clearApplicationEvents@{clearApplicationEvents}!KNotifyDialog@{KNotify\-Dialog}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KNotify\-Dialog::clear\-Application\-Events ()\hspace{0.3cm}{\tt  [virtual]}}\label{classKNotifyDialog_a4}


Removes all the events added with {\bf add\-Application\-Events}{\rm (p.\,\pageref{classKNotifyDialog_a2})}(). 

\begin{Desc}
\item[See also:]{\bf add\-Application\-Events()}{\rm (p.\,\pageref{classKNotifyDialog_a2})} \end{Desc}


Definition at line 143 of file knotifydialog.cpp.

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