\section{KStartup\-Info\-Data Class Reference}
\label{classKStartupInfoData}\index{KStartupInfoData@{KStartupInfoData}}
Class representing data about an application startup notification.  


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

\subsection*{Public Types}
\begin{CompactItemize}
\item 
enum {\bf Tri\-State} \{ {\bf Yes}, 
{\bf No}, 
{\bf Unknown}
 \}
\end{CompactItemize}
\subsection*{Public Member Functions}
\begin{CompactItemize}
\item 
void {\bf set\-Bin} (const {\bf QString} \&bin)
\item 
const {\bf QString} \& {\bf bin} () const 
\item 
void {\bf set\-Name} (const {\bf QString} \&name)
\item 
const {\bf QString} \& {\bf find\-Name} () const 
\item 
const {\bf QString} \& {\bf name} () const 
\item 
void {\bf set\-Description} (const {\bf QString} \&descr)
\item 
const {\bf QString} \& {\bf find\-Description} () const 
\item 
const {\bf QString} \& {\bf description} () const 
\item 
void {\bf set\-Icon} (const {\bf QString} \&icon)
\item 
const {\bf QString} \& {\bf find\-Icon} () const 
\item 
const {\bf QString} \& {\bf icon} () const 
\item 
void {\bf set\-Desktop} (int desktop)
\item 
int {\bf desktop} () const 
\item 
void {\bf set\-WMClass} (const {\bf QCString} \&wmclass)
\item 
const {\bf QCString} {\bf find\-WMClass} () const 
\item 
const {\bf QCString} \& {\bf WMClass} () const 
\item 
void {\bf add\-Pid} (pid\_\-t pid)
\item 
const {\bf QValue\-List}$<$ pid\_\-t $>$ \& {\bf pids} () const 
\item 
bool {\bf is\_\-pid} (pid\_\-t pid) const 
\item 
void {\bf set\-Hostname} (const {\bf QCString} \&hostname={\bf QCString}())
\item 
const {\bf QCString} \& {\bf hostname} () const 
\item 
void {\bf set\-Silent} (Tri\-State state)
\item 
Tri\-State {\bf silent} () const 
\item 
void {\bf set\-Timestamp} (unsigned long time)
\item 
unsigned long {\bf timestamp} () const 
\item 
int {\bf screen} () const 
\item 
void {\bf set\-Screen} (int screen)
\item 
void {\bf update} (const {\bf KStartup\-Info\-Data} \&data)
\item 
{\bf KStartup\-Info\-Data} ()
\item 
{\bf KStartup\-Info\-Data} (const {\bf KStartup\-Info\-Data} \&data)
\item 
{\bf KStartup\-Info\-Data} \& {\bf operator=} (const {\bf KStartup\-Info\-Data} \&data)\label{classKStartupInfoData_a31}

\end{CompactItemize}
\subsection*{Friends}
\begin{CompactItemize}
\item 
class {\bf KStartup\-Info}\label{classKStartupInfoData_n0}

\item 
class {\bf KStartup\-Info::Data}\label{classKStartupInfoData_n1}

\end{CompactItemize}


\subsection{Detailed Description}
Class representing data about an application startup notification. 

Such data include the icon of the starting application, the desktop on which the application should start, the binary name of the application, etc.

\begin{Desc}
\item[See also:]{\bf KStartup\-Info}{\rm (p.\,\pageref{classKStartupInfo})} 

{\bf KStartup\-Info\-Id}{\rm (p.\,\pageref{classKStartupInfoId})}\end{Desc}
\begin{Desc}
\item[Author:]Lubos Lunak $<${\tt l.lunak@kde.org}$>$ \end{Desc}




Definition at line 463 of file kstartupinfo.h.

\subsection{Constructor \& Destructor Documentation}
\index{KStartupInfoData@{KStartup\-Info\-Data}!KStartupInfoData@{KStartupInfoData}}
\index{KStartupInfoData@{KStartupInfoData}!KStartupInfoData@{KStartup\-Info\-Data}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KStartup\-Info\-Data::KStartup\-Info\-Data ()}\label{classKStartupInfoData_a28}


Constructor. 

Initializes all the data to their default empty values.

Definition at line 1239 of file kstartupinfo.cpp.\index{KStartupInfoData@{KStartup\-Info\-Data}!KStartupInfoData@{KStartupInfoData}}
\index{KStartupInfoData@{KStartupInfoData}!KStartupInfoData@{KStartup\-Info\-Data}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KStartup\-Info\-Data::KStartup\-Info\-Data (const {\bf KStartup\-Info\-Data} \& {\em data})}\label{classKStartupInfoData_a29}


Copy constructor. 



Definition at line 1197 of file kstartupinfo.cpp.

\subsection{Member Function Documentation}
\index{KStartupInfoData@{KStartup\-Info\-Data}!setBin@{setBin}}
\index{setBin@{setBin}!KStartupInfoData@{KStartup\-Info\-Data}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KStartup\-Info\-Data::set\-Bin (const {\bf QString} \& {\em bin})}\label{classKStartupInfoData_a0}


Sets the binary name of the application ( e.g. 

'kcontrol' ). \begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em bin}]the new binary name of the application\end{description}
\end{Desc}


Definition at line 1249 of file kstartupinfo.cpp.\index{KStartupInfoData@{KStartup\-Info\-Data}!bin@{bin}}
\index{bin@{bin}!KStartupInfoData@{KStartup\-Info\-Data}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}const {\bf QString} \& KStartup\-Info\-Data::bin () const}\label{classKStartupInfoData_a1}


Returns the binary name of the starting application. 

\begin{Desc}
\item[Returns:]the new binary name of the application\end{Desc}


Definition at line 1254 of file kstartupinfo.cpp.

Referenced by find\-Icon(), find\-Name(), find\-WMClass(), and update().\index{KStartupInfoData@{KStartup\-Info\-Data}!setName@{setName}}
\index{setName@{setName}!KStartupInfoData@{KStartup\-Info\-Data}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KStartup\-Info\-Data::set\-Name (const {\bf QString} \& {\em name})}\label{classKStartupInfoData_a2}


Sets the name for the notification (e.g. 

'Control Center')

Definition at line 1259 of file kstartupinfo.cpp.\index{KStartupInfoData@{KStartup\-Info\-Data}!findName@{findName}}
\index{findName@{findName}!KStartupInfoData@{KStartup\-Info\-Data}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}const {\bf QString} \& KStartup\-Info\-Data::find\-Name () const}\label{classKStartupInfoData_a3}


Returns the name of the startup notification. 

If it's not available, it tries to use other information (binary name). \begin{Desc}
\item[Returns:]the name of the startup notification\end{Desc}


Definition at line 1269 of file kstartupinfo.cpp.

References bin(), QString::is\-Empty(), and name().\index{KStartupInfoData@{KStartup\-Info\-Data}!name@{name}}
\index{name@{name}!KStartupInfoData@{KStartup\-Info\-Data}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}const {\bf QString} \& KStartup\-Info\-Data::name () const}\label{classKStartupInfoData_a4}


Returns the name of the startup notification, or empty if not available. 

\begin{Desc}
\item[Returns:]the name of the startup notification, or an empty string if not set.\end{Desc}


Definition at line 1264 of file kstartupinfo.cpp.

Referenced by find\-Description(), find\-Name(), and update().\index{KStartupInfoData@{KStartup\-Info\-Data}!setDescription@{setDescription}}
\index{setDescription@{setDescription}!KStartupInfoData@{KStartup\-Info\-Data}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KStartup\-Info\-Data::set\-Description (const {\bf QString} \& {\em descr})}\label{classKStartupInfoData_a5}


Sets the description for the notification (e.g. 

'Launching Control Center'). I.e. {\bf name()}{\rm (p.\,\pageref{classKStartupInfoData_a4})} describes what is being started, while {\bf description()}{\rm (p.\,\pageref{classKStartupInfoData_a7})} is the actual action performed by the starting. \begin{Desc}
\item[Since:]3.2\end{Desc}


Definition at line 1276 of file kstartupinfo.cpp.\index{KStartupInfoData@{KStartup\-Info\-Data}!findDescription@{findDescription}}
\index{findDescription@{findDescription}!KStartupInfoData@{KStartup\-Info\-Data}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}const {\bf QString} \& KStartup\-Info\-Data::find\-Description () const}\label{classKStartupInfoData_a6}


Returns the description of the startup notification. 

If it's not available, it returns {\bf name()}{\rm (p.\,\pageref{classKStartupInfoData_a4})}. \begin{Desc}
\item[Returns:]the description of the startup notification \end{Desc}
\begin{Desc}
\item[Since:]3.2\end{Desc}


Definition at line 1286 of file kstartupinfo.cpp.

References description(), QString::is\-Empty(), and name().\index{KStartupInfoData@{KStartup\-Info\-Data}!description@{description}}
\index{description@{description}!KStartupInfoData@{KStartup\-Info\-Data}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}const {\bf QString} \& KStartup\-Info\-Data::description () const}\label{classKStartupInfoData_a7}


Returns the name of the startup notification, or empty if not available. 

\begin{Desc}
\item[Returns:]the name of the startup notificaiton, or an empty string if not set. \end{Desc}
\begin{Desc}
\item[Since:]3.2\end{Desc}


Definition at line 1281 of file kstartupinfo.cpp.

Referenced by find\-Description(), and update().\index{KStartupInfoData@{KStartup\-Info\-Data}!setIcon@{setIcon}}
\index{setIcon@{setIcon}!KStartupInfoData@{KStartup\-Info\-Data}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KStartup\-Info\-Data::set\-Icon (const {\bf QString} \& {\em icon})}\label{classKStartupInfoData_a8}


Sets the icon for the startup notification ( e.g. 

'kcontrol' ) \begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em icon}]the name of the icon\end{description}
\end{Desc}


Definition at line 1293 of file kstartupinfo.cpp.\index{KStartupInfoData@{KStartup\-Info\-Data}!findIcon@{findIcon}}
\index{findIcon@{findIcon}!KStartupInfoData@{KStartup\-Info\-Data}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}const {\bf QString} \& KStartup\-Info\-Data::find\-Icon () const}\label{classKStartupInfoData_a9}


Returns the icon of the startup notification, and if it's not available, tries to get it from the binary name. 

\begin{Desc}
\item[Returns:]the name of the startup notification's icon, or the name of the binary if not set\end{Desc}


Definition at line 1298 of file kstartupinfo.cpp.

References bin(), icon(), and QString::is\-Empty().\index{KStartupInfoData@{KStartup\-Info\-Data}!icon@{icon}}
\index{icon@{icon}!KStartupInfoData@{KStartup\-Info\-Data}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}const {\bf QString} \& KStartup\-Info\-Data::icon () const}\label{classKStartupInfoData_a10}


Returns the icon of the startup notification, or empty if not available. 

\begin{Desc}
\item[Returns:]the name of the icon, or an empty string if not set.\end{Desc}


Definition at line 1305 of file kstartupinfo.cpp.

Referenced by find\-Icon(), and update().\index{KStartupInfoData@{KStartup\-Info\-Data}!setDesktop@{setDesktop}}
\index{setDesktop@{setDesktop}!KStartupInfoData@{KStartup\-Info\-Data}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KStartup\-Info\-Data::set\-Desktop (int {\em desktop})}\label{classKStartupInfoData_a11}


Sets the desktop for the startup notification ( i.e. 

the desktop on which the starting application should appear ). \begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em desktop}]the desktop for the startup notification\end{description}
\end{Desc}


Definition at line 1310 of file kstartupinfo.cpp.\index{KStartupInfoData@{KStartup\-Info\-Data}!desktop@{desktop}}
\index{desktop@{desktop}!KStartupInfoData@{KStartup\-Info\-Data}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}int KStartup\-Info\-Data::desktop () const}\label{classKStartupInfoData_a12}


Returns the desktop for the startup notification. 

\begin{Desc}
\item[Returns:]the desktop for the startup notification\end{Desc}


Definition at line 1315 of file kstartupinfo.cpp.

Referenced by update().\index{KStartupInfoData@{KStartup\-Info\-Data}!setWMClass@{setWMClass}}
\index{setWMClass@{setWMClass}!KStartupInfoData@{KStartup\-Info\-Data}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KStartup\-Info\-Data::set\-WMClass (const {\bf QCString} \& {\em wmclass})}\label{classKStartupInfoData_a13}


Sets a WM\_\-CLASS value for the startup notification, it may be used for increasing the chance that the windows created by the starting application will be detected correctly. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em wmclass}]the WM\_\-CLASS value for the startup notification\end{description}
\end{Desc}


Definition at line 1320 of file kstartupinfo.cpp.\index{KStartupInfoData@{KStartup\-Info\-Data}!findWMClass@{findWMClass}}
\index{findWMClass@{findWMClass}!KStartupInfoData@{KStartup\-Info\-Data}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}const {\bf QCString} KStartup\-Info\-Data::find\-WMClass () const}\label{classKStartupInfoData_a14}


Returns the WM\_\-CLASS value for the startup notification, or binary name if not available. 

\begin{Desc}
\item[Returns:]the WM\_\-CLASS value for the startup notification, or the binary name if not set\end{Desc}


Definition at line 1325 of file kstartupinfo.cpp.

References bin(), QCString::is\-Empty(), QString::utf8(), and WMClass().\index{KStartupInfoData@{KStartup\-Info\-Data}!WMClass@{WMClass}}
\index{WMClass@{WMClass}!KStartupInfoData@{KStartup\-Info\-Data}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}const {\bf QCString} \& KStartup\-Info\-Data::WMClass () const}\label{classKStartupInfoData_a15}


Returns the WM\_\-CLASS value for the startup notification, or empty if not available. 

\begin{Desc}
\item[Returns:]the WM\_\-CLASS value for the startup notification, or empty if not set\end{Desc}


Definition at line 1332 of file kstartupinfo.cpp.

Referenced by find\-WMClass().\index{KStartupInfoData@{KStartup\-Info\-Data}!addPid@{addPid}}
\index{addPid@{addPid}!KStartupInfoData@{KStartup\-Info\-Data}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KStartup\-Info\-Data::add\-Pid (pid\_\-t {\em pid})}\label{classKStartupInfoData_a16}


Adds a PID to the list of processes that belong to the startup notification. 

It may be used to increase the chance that the windows created by the starting application will be detected correctly, and also for detecting if the application has quit without creating any window. \begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em pid}]the PID to add\end{description}
\end{Desc}


Definition at line 1356 of file kstartupinfo.cpp.

References QCString::append().

Referenced by KUnique\-Application::start(), and update().\index{KStartupInfoData@{KStartup\-Info\-Data}!pids@{pids}}
\index{pids@{pids}!KStartupInfoData@{KStartup\-Info\-Data}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}const {\bf QValue\-List}$<$ pid\_\-t $>$ \& KStartup\-Info\-Data::pids () const}\label{classKStartupInfoData_a17}


Returns all PIDs for the startup notification. 

\begin{Desc}
\item[Returns:]the list of all PIDs\end{Desc}


Definition at line 1367 of file kstartupinfo.cpp.\index{KStartupInfoData@{KStartup\-Info\-Data}!is_pid@{is\_\-pid}}
\index{is_pid@{is\_\-pid}!KStartupInfoData@{KStartup\-Info\-Data}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KStartup\-Info\-Data::is\_\-pid (pid\_\-t {\em pid}) const}\label{classKStartupInfoData_a18}


Checks whether the given {\tt pid} is in the list of PIDs for starup notification. 

\begin{Desc}
\item[Returns:]true if the given {\tt pid} is in the list of PIDs for the startup notification\end{Desc}


Definition at line 1372 of file kstartupinfo.cpp.

References QValue\-List::contains().\index{KStartupInfoData@{KStartup\-Info\-Data}!setHostname@{setHostname}}
\index{setHostname@{setHostname}!KStartupInfoData@{KStartup\-Info\-Data}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KStartup\-Info\-Data::set\-Hostname (const {\bf QCString} \& {\em hostname} = {\tt {\bf QCString}()})}\label{classKStartupInfoData_a19}


Sets the hostname on which the application is starting. 

It's necessary to set it if PIDs are set. \begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em hostname}]the application's hostname. If it's a null string, the current hostname is used\end{description}
\end{Desc}


Definition at line 1337 of file kstartupinfo.cpp.\index{KStartupInfoData@{KStartup\-Info\-Data}!hostname@{hostname}}
\index{hostname@{hostname}!KStartupInfoData@{KStartup\-Info\-Data}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}const {\bf QCString} \& KStartup\-Info\-Data::hostname () const}\label{classKStartupInfoData_a20}


Returns the hostname for the startup notification. 

\begin{Desc}
\item[Returns:]the hostname\end{Desc}


Definition at line 1351 of file kstartupinfo.cpp.\index{KStartupInfoData@{KStartup\-Info\-Data}!setSilent@{setSilent}}
\index{setSilent@{setSilent}!KStartupInfoData@{KStartup\-Info\-Data}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KStartup\-Info\-Data::set\-Silent (Tri\-State {\em state})}\label{classKStartupInfoData_a21}


Sets whether the visual feedback for this startup notification should be silenced (temporarily suspended). 

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


Definition at line 1377 of file kstartupinfo.cpp.

Referenced by KStartup\-Info::silence\-Startup().\index{KStartupInfoData@{KStartup\-Info\-Data}!silent@{silent}}
\index{silent@{silent}!KStartupInfoData@{KStartup\-Info\-Data}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KStartup\-Info\-Data::Tri\-State KStartup\-Info\-Data::silent () const}\label{classKStartupInfoData_a22}


Return the silence status for the startup notification. 

\begin{Desc}
\item[Returns:]KStartup\-Info\-Data::Yes if visual feedback is silenced \end{Desc}
\begin{Desc}
\item[Since:]3.1.1\end{Desc}


Definition at line 1382 of file kstartupinfo.cpp.\index{KStartupInfoData@{KStartup\-Info\-Data}!setTimestamp@{setTimestamp}}
\index{setTimestamp@{setTimestamp}!KStartupInfoData@{KStartup\-Info\-Data}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KStartup\-Info\-Data::set\-Timestamp (unsigned long {\em time})}\label{classKStartupInfoData_a23}


\begin{Desc}
\item[{\bf Deprecated}]Timestamp is already assigned in {\bf KStartup\-Info\-Id::init\-Id()}{\rm (p.\,\pageref{classKStartupInfoId_a3})}. Sets timestamp for the startup notification. The timestamp is expressed as XServer time, and is used to prevent activation of the matching window if user interaction took place after this timestamp. Value -1 means no timestamp set, value 0 means that the window should not be activated. \end{Desc}


Definition at line 1387 of file kstartupinfo.cpp.\index{KStartupInfoData@{KStartup\-Info\-Data}!timestamp@{timestamp}}
\index{timestamp@{timestamp}!KStartupInfoData@{KStartup\-Info\-Data}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}unsigned long KStartup\-Info\-Data::timestamp () const}\label{classKStartupInfoData_a24}


\begin{Desc}
\item[{\bf Deprecated}]Use {\bf KStartup\-Info\-Id::timestamp()}{\rm (p.\,\pageref{classKStartupInfoId_a5})}. Return the timestamp for the startup notification, or -1 if no timestamp is set. \end{Desc}


Definition at line 1392 of file kstartupinfo.cpp.

Referenced by update().\index{KStartupInfoData@{KStartup\-Info\-Data}!screen@{screen}}
\index{screen@{screen}!KStartupInfoData@{KStartup\-Info\-Data}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}int KStartup\-Info\-Data::screen () const}\label{classKStartupInfoData_a25}


The X11 screen on which the startup notification is happening, -1 if unknown. 



Definition at line 1402 of file kstartupinfo.cpp.\index{KStartupInfoData@{KStartup\-Info\-Data}!setScreen@{setScreen}}
\index{setScreen@{setScreen}!KStartupInfoData@{KStartup\-Info\-Data}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KStartup\-Info\-Data::set\-Screen (int {\em screen})}\label{classKStartupInfoData_a26}


Sets the X11 screen on which the startup notification should happen. 

This is usually not necessary to set, as it's set by default to qt\_\-xscreen(). 

Definition at line 1397 of file kstartupinfo.cpp.\index{KStartupInfoData@{KStartup\-Info\-Data}!update@{update}}
\index{update@{update}!KStartupInfoData@{KStartup\-Info\-Data}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KStartup\-Info\-Data::update (const {\bf KStartup\-Info\-Data} \& {\em data})}\label{classKStartupInfoData_a27}


Updates the notification data from the given data. 

Some data, such as the desktop or the name, won't be rewritten if already set. \begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em data}]the data to update\end{description}
\end{Desc}


Definition at line 1211 of file kstartupinfo.cpp.

References add\-Pid(), bin(), QString::d(), description(), desktop(), QValue\-List::end(), icon(), QString::is\-Empty(), name(), and timestamp().

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