\section{KAction\-Collection Class Reference}
\label{classKActionCollection}\index{KActionCollection@{KActionCollection}}
A managed set of {\bf KAction}{\rm (p.\,\pageref{classKAction})} objects.  


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

Inheritance diagram for KAction\-Collection:\begin{figure}[H]
\begin{center}
\leavevmode
\includegraphics[width=65pt]{classKActionCollection__inherit__graph}
\end{center}
\end{figure}
Collaboration diagram for KAction\-Collection:\begin{figure}[H]
\begin{center}
\leavevmode
\includegraphics[width=65pt]{classKActionCollection__coll__graph}
\end{center}
\end{figure}
\subsection*{Public Slots}
\begin{CompactItemize}
\item 
void {\bf clear} ()
\end{CompactItemize}
\subsection*{Signals}
\begin{CompactItemize}
\item 
void {\bf inserted} ({\bf KAction} $\ast$)\label{classKActionCollection_l0}

\item 
void {\bf removed} ({\bf KAction} $\ast$)\label{classKActionCollection_l1}

\item 
void {\bf action\-Highlighted} ({\bf KAction} $\ast$action)
\item 
void {\bf action\-Highlighted} ({\bf KAction} $\ast$action, bool highlight)
\item 
void {\bf action\-Status\-Text} (const {\bf QString} \&text)
\item 
void {\bf clear\-Status\-Text} ()
\end{CompactItemize}
\subsection*{Public Member Functions}
\begin{CompactItemize}
\item 
{\bf KAction\-Collection} ({\bf QWidget} $\ast${\bf parent}, const char $\ast${\bf name}=0, {\bf KInstance} $\ast$instance=0)\label{classKActionCollection_a0}

\item 
{\bf KAction\-Collection} ({\bf QWidget} $\ast$watch, {\bf QObject} $\ast${\bf parent}, const char $\ast${\bf name}=0, {\bf KInstance} $\ast$instance=0)
\item 
{\bf KAction\-Collection} (const {\bf KAction\-Collection} \&copy)\label{classKActionCollection_a2}

\item 
virtual void {\bf set\-Widget} ({\bf QWidget} $\ast$widget)
\item 
void {\bf set\-Auto\-Connect\-Shortcuts} (bool)
\item 
bool {\bf is\-Auto\-Connect\-Shortcuts} ()
\item 
bool {\bf add\-Doc\-Collection} ({\bf KAction\-Collection} $\ast$p\-Doc)
\item 
virtual {\bf KAccel} $\ast$ {\bf accel} () KDE\_\-DEPRECATED
\item 
virtual const {\bf KAccel} $\ast$ {\bf accel} () const KDE\_\-DEPRECATED
\item 
{\bf KAccel} $\ast$ {\bf kaccel} ()
\item 
const {\bf KAccel} $\ast$ {\bf kaccel} () const 
\item 
{\bf KAccel} $\ast$ {\bf builder\-KAccel} () const \label{classKActionCollection_a12}

\item 
virtual uint {\bf count} () const 
\item 
bool {\bf is\-Empty} () const \label{classKActionCollection_a14}

\item 
virtual {\bf KAction} $\ast$ {\bf action} (int index) const 
\item 
virtual {\bf KAction} $\ast$ {\bf action} (const char $\ast${\bf name}, const char $\ast$classname=0) const 
\item 
virtual {\bf QString\-List} {\bf groups} () const 
\item 
virtual KAction\-Ptr\-List {\bf actions} (const {\bf QString} \&group) const 
\item 
virtual KAction\-Ptr\-List {\bf actions} () const 
\item 
bool {\bf read\-Shortcut\-Settings} (const {\bf QString} \&s\-Config\-Group=QString::null, {\bf KConfig\-Base} $\ast$p\-Config=0)
\item 
bool {\bf write\-Shortcut\-Settings} (const {\bf QString} \&s\-Config\-Group=QString::null, {\bf KConfig\-Base} $\ast$p\-Config=0) const 
\item 
void {\bf set\-Instance} ({\bf KInstance} $\ast$instance)\label{classKActionCollection_a22}

\item 
{\bf KInstance} $\ast$ {\bf instance} () const 
\item 
void {\bf set\-XMLFile} (const {\bf QString} \&)
\item 
const {\bf QString} \& {\bf xml\-File} () const 
\item 
void {\bf set\-Highlighting\-Enabled} (bool enable)
\item 
bool {\bf highlighting\-Enabled} () const 
\item 
void {\bf connect\-Highlight} ({\bf QWidget} $\ast$container, {\bf KAction} $\ast$action)
\item 
void {\bf disconnect\-Highlight} ({\bf QWidget} $\ast$container, {\bf KAction} $\ast$action)
\item 
const {\bf KXMLGUIClient} $\ast$ {\bf parent\-GUIClient} () const 
\item 
{\bf KAction\-Collection} ({\bf QObject} $\ast${\bf parent}, const char $\ast${\bf name}=0, {\bf KInstance} $\ast$instance=0)\label{classKActionCollection_a31}

\item 
void {\bf insert} ({\bf KAction} $\ast$action)
\item 
void {\bf remove} ({\bf KAction} $\ast$action)
\item 
{\bf KAction} $\ast$ {\bf take} ({\bf KAction} $\ast$action)
\item 
{\bf KAction\-Collection} {\bf operator+} (const {\bf KAction\-Collection} \&) const \label{classKActionCollection_a35}

\item 
{\bf KAction\-Collection} \& {\bf operator=} (const {\bf KAction\-Collection} \&)\label{classKActionCollection_a36}

\item 
{\bf KAction\-Collection} \& {\bf operator+=} (const {\bf KAction\-Collection} \&)\label{classKActionCollection_a37}

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

\end{CompactItemize}
\subsection*{Friends}
\begin{CompactItemize}
\item 
class {\bf KAction}\label{classKActionCollection_n0}

\item 
class {\bf KXMLGUIClient}\label{classKActionCollection_n1}

\end{CompactItemize}


\subsection{Detailed Description}
A managed set of {\bf KAction}{\rm (p.\,\pageref{classKAction})} objects. 

If you set the tooltips on KActions and want the tooltip to show in statusbar (recommended) then you will need to connect a couple of the actionclass signals to the toolbar. The easiest way of doing this is in your {\bf KMain\-Window}{\rm (p.\,\pageref{classKMainWindow})} subclass, where you create a statusbar, do:



\footnotesize\begin{verbatim} actionCollection()->setHighlightingEnabled(true);  
 connect(actionCollection(), SIGNAL( actionStatusText( const QString & ) ),
           statusBar(), SLOT( message( const QString & ) ) );
 connect(actionCollection(), SIGNAL( clearStatusText() ),
           statusBar(), SLOT( clear() ) );
\end{verbatim}
\normalsize
 



Definition at line 78 of file kactioncollection.h.

\subsection{Constructor \& Destructor Documentation}
\index{KActionCollection@{KAction\-Collection}!KActionCollection@{KActionCollection}}
\index{KActionCollection@{KActionCollection}!KActionCollection@{KAction\-Collection}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KAction\-Collection::KAction\-Collection ({\bf QWidget} $\ast$ {\em watch}, {\bf QObject} $\ast$ {\em parent}, const char $\ast$ {\em name} = {\tt 0}, {\bf KInstance} $\ast$ {\em instance} = {\tt 0})}\label{classKActionCollection_a1}


Use this constructor if you want the collection's actions to restrict their accelerator keys to {\tt watch} rather than the {\tt parent}. 

If you don't require shortcuts, you can pass a null to the {\tt watch} parameter. 

Definition at line 92 of file kactioncollection.cpp.

References endl(), instance(), kd\-Debug(), and set\-Widget().

\subsection{Member Function Documentation}
\index{KActionCollection@{KAction\-Collection}!setWidget@{setWidget}}
\index{setWidget@{setWidget}!KActionCollection@{KAction\-Collection}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KAction\-Collection::set\-Widget ({\bf QWidget} $\ast$ {\em widget})\hspace{0.3cm}{\tt  [virtual]}}\label{classKActionCollection_a4}


This sets the widget to which the keyboard shortcuts should be attached. 

You only need to call this if a null pointer was passed in the constructor. 

Definition at line 152 of file kactioncollection.cpp.

References endl(), and kd\-Warning().

Referenced by KAction\-Collection().\index{KActionCollection@{KAction\-Collection}!setAutoConnectShortcuts@{setAutoConnectShortcuts}}
\index{setAutoConnectShortcuts@{setAutoConnectShortcuts}!KActionCollection@{KAction\-Collection}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KAction\-Collection::set\-Auto\-Connect\-Shortcuts (bool)}\label{classKActionCollection_a5}


This indicates whether new actions which are created in this collection should have their keyboard shortcuts automatically connected on construction. 

Set to 'false' if you will be loading XML-based settings. This is automatically done by KParts. The default is 'true'. \begin{Desc}
\item[See also:]{\bf is\-Auto\-Connect\-Shortcuts()}{\rm (p.\,\pageref{classKActionCollection_a6})} \end{Desc}


Definition at line 167 of file kactioncollection.cpp.\index{KActionCollection@{KAction\-Collection}!isAutoConnectShortcuts@{isAutoConnectShortcuts}}
\index{isAutoConnectShortcuts@{isAutoConnectShortcuts}!KActionCollection@{KAction\-Collection}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KAction\-Collection::is\-Auto\-Connect\-Shortcuts ()}\label{classKActionCollection_a6}


This indicates whether new actions which are created in this collection have their keyboard shortcuts automatically connected on construction. 

\begin{Desc}
\item[See also:]{\bf set\-Auto\-Connect\-Shortcuts()}{\rm (p.\,\pageref{classKActionCollection_a5})} \end{Desc}


Definition at line 172 of file kactioncollection.cpp.\index{KActionCollection@{KAction\-Collection}!addDocCollection@{addDocCollection}}
\index{addDocCollection@{addDocCollection}!KActionCollection@{KAction\-Collection}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KAction\-Collection::add\-Doc\-Collection ({\bf KAction\-Collection} $\ast$ {\em p\-Doc})}\label{classKActionCollection_a7}


Doc/View model. 

This lets you add the action collection of a document to a view's action collection. 

Definition at line 177 of file kactioncollection.cpp.\index{KActionCollection@{KAction\-Collection}!accel@{accel}}
\index{accel@{accel}!KActionCollection@{KAction\-Collection}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf KAccel} $\ast$ KAction\-Collection::accel ()\hspace{0.3cm}{\tt  [virtual]}}\label{classKActionCollection_a8}


\begin{Desc}
\item[{\bf Deprecated}]Deprecated because of ambiguous name. Use {\bf kaccel()}{\rm (p.\,\pageref{classKActionCollection_a10})}\end{Desc}


Definition at line 369 of file kactioncollection.cpp.

References kaccel().\index{KActionCollection@{KAction\-Collection}!accel@{accel}}
\index{accel@{accel}!KActionCollection@{KAction\-Collection}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}const {\bf KAccel} $\ast$ KAction\-Collection::accel () const\hspace{0.3cm}{\tt  [virtual]}}\label{classKActionCollection_a9}


\begin{Desc}
\item[{\bf Deprecated}]Deprecated because of ambiguous name. Use {\bf kaccel()}{\rm (p.\,\pageref{classKActionCollection_a10})}\end{Desc}


Definition at line 370 of file kactioncollection.cpp.

References kaccel().\index{KActionCollection@{KAction\-Collection}!kaccel@{kaccel}}
\index{kaccel@{kaccel}!KActionCollection@{KAction\-Collection}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf KAccel} $\ast$ KAction\-Collection::kaccel ()}\label{classKActionCollection_a10}


Returns the {\bf KAccel} object of the most recently set widget. 



Definition at line 282 of file kactioncollection.cpp.

Referenced by accel().\index{KActionCollection@{KAction\-Collection}!kaccel@{kaccel}}
\index{kaccel@{kaccel}!KActionCollection@{KAction\-Collection}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}const {\bf KAccel} $\ast$ KAction\-Collection::kaccel () const}\label{classKActionCollection_a11}


Returns the {\bf KAccel} object of the most recently set widget. 

Const version for convenience. 

Definition at line 291 of file kactioncollection.cpp.\index{KActionCollection@{KAction\-Collection}!count@{count}}
\index{count@{count}!KActionCollection@{KAction\-Collection}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}uint KAction\-Collection::count () const\hspace{0.3cm}{\tt  [virtual]}}\label{classKActionCollection_a13}


Returns the number of actions in the collection. 



Definition at line 418 of file kactioncollection.cpp.

Referenced by KAction::plug().\index{KActionCollection@{KAction\-Collection}!action@{action}}
\index{action@{action}!KActionCollection@{KAction\-Collection}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf KAction} $\ast$ KAction\-Collection::action (int {\em index}) const\hspace{0.3cm}{\tt  [virtual]}}\label{classKActionCollection_a15}


Return the KAction$\ast$ at position \char`\"{}index\char`\"{} in the action collection. 

\begin{Desc}
\item[See also:]{\bf count()}{\rm (p.\,\pageref{classKActionCollection_a13})} \end{Desc}


Definition at line 400 of file kactioncollection.cpp.

Referenced by KXMLGUIClient::action(), connect\-Highlight(), disconnect\-Highlight(), insert(), remove(), KXMLGUIClient::state\-Changed(), and take().\index{KActionCollection@{KAction\-Collection}!action@{action}}
\index{action@{action}!KActionCollection@{KAction\-Collection}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf KAction} $\ast$ KAction\-Collection::action (const char $\ast$ {\em name}, const char $\ast$ {\em classname} = {\tt 0}) const\hspace{0.3cm}{\tt  [virtual]}}\label{classKActionCollection_a16}


Find an action (optionally, of a given subclass of {\bf KAction}{\rm (p.\,\pageref{classKAction})}) in the action collection. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em name}]Name of the {\bf KAction}{\rm (p.\,\pageref{classKAction})}. \item[{\em classname}]Name of the {\bf KAction}{\rm (p.\,\pageref{classKAction})} subclass. \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]A pointer to the first {\bf KAction}{\rm (p.\,\pageref{classKAction})} in the collection which matches the parameters or null if nothing matches. \end{Desc}


Definition at line 373 of file kactioncollection.cpp.\index{KActionCollection@{KAction\-Collection}!groups@{groups}}
\index{groups@{groups}!KActionCollection@{KAction\-Collection}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString\-List} KAction\-Collection::groups () const\hspace{0.3cm}{\tt  [virtual]}}\label{classKActionCollection_a17}


Returns a list of all the groups of all the KActions in this action collection. 

\begin{Desc}
\item[See also:]KAction::group() 

KAction::set\-Group() \end{Desc}


Definition at line 423 of file kactioncollection.cpp.\index{KActionCollection@{KAction\-Collection}!actions@{actions}}
\index{actions@{actions}!KActionCollection@{KAction\-Collection}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KAction\-Ptr\-List KAction\-Collection::actions (const {\bf QString} \& {\em group}) const\hspace{0.3cm}{\tt  [virtual]}}\label{classKActionCollection_a18}


Returns the list of actions in a particular group managed by this action collection. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em group}]The name of the group. \end{description}
\end{Desc}


Definition at line 435 of file kactioncollection.cpp.\index{KActionCollection@{KAction\-Collection}!actions@{actions}}
\index{actions@{actions}!KActionCollection@{KAction\-Collection}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KAction\-Ptr\-List KAction\-Collection::actions () const\hspace{0.3cm}{\tt  [virtual]}}\label{classKActionCollection_a19}


Returns the list of actions managed by this action collection. 



Definition at line 449 of file kactioncollection.cpp.\index{KActionCollection@{KAction\-Collection}!readShortcutSettings@{readShortcutSettings}}
\index{readShortcutSettings@{readShortcutSettings}!KActionCollection@{KAction\-Collection}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KAction\-Collection::read\-Shortcut\-Settings (const {\bf QString} \& {\em s\-Config\-Group} = {\tt QString::null}, {\bf KConfig\-Base} $\ast$ {\em p\-Config} = {\tt 0})}\label{classKActionCollection_a20}


Used for reading shortcut configuration from a non-XML rc file. 



Definition at line 408 of file kactioncollection.cpp.\index{KActionCollection@{KAction\-Collection}!writeShortcutSettings@{writeShortcutSettings}}
\index{writeShortcutSettings@{writeShortcutSettings}!KActionCollection@{KAction\-Collection}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KAction\-Collection::write\-Shortcut\-Settings (const {\bf QString} \& {\em s\-Config\-Group} = {\tt QString::null}, {\bf KConfig\-Base} $\ast$ {\em p\-Config} = {\tt 0}) const}\label{classKActionCollection_a21}


Used for writing shortcut configuration to a non-XML rc file. 



Definition at line 413 of file kactioncollection.cpp.\index{KActionCollection@{KAction\-Collection}!instance@{instance}}
\index{instance@{instance}!KActionCollection@{KAction\-Collection}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf KInstance} $\ast$ KAction\-Collection::instance () const}\label{classKActionCollection_a23}


The instance with which this class is associated. 



Definition at line 468 of file kactioncollection.cpp.

Referenced by KAction\-Collection(), KPaste\-Text\-Action::plug(), KTool\-Bar\-Popup\-Action::plug(), KAction\-Menu::plug(), KRecent\-Files\-Action::plug(), and KAction::plug().\index{KActionCollection@{KAction\-Collection}!setXMLFile@{setXMLFile}}
\index{setXMLFile@{setXMLFile}!KActionCollection@{KAction\-Collection}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KAction\-Collection::set\-XMLFile (const {\bf QString} \&)}\label{classKActionCollection_a24}


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


Definition at line 473 of file kactioncollection.cpp.

Referenced by KXMLGUIClient::set\-XMLFile().\index{KActionCollection@{KAction\-Collection}!xmlFile@{xmlFile}}
\index{xmlFile@{xmlFile}!KActionCollection@{KAction\-Collection}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}const {\bf QString} \& KAction\-Collection::xml\-File () const}\label{classKActionCollection_a25}


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


Definition at line 478 of file kactioncollection.cpp.\index{KActionCollection@{KAction\-Collection}!setHighlightingEnabled@{setHighlightingEnabled}}
\index{setHighlightingEnabled@{setHighlightingEnabled}!KActionCollection@{KAction\-Collection}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KAction\-Collection::set\-Highlighting\-Enabled (bool {\em enable})}\label{classKActionCollection_a26}


Enable highlighting notification for specific KActions. 

This is false by default, so, by default, the highlighting signals will not be emitted.

\begin{Desc}
\item[See also:]{\bf connect\-Highlight()}{\rm (p.\,\pageref{classKActionCollection_a28})} 

{\bf disconnect\-Highlight()}{\rm (p.\,\pageref{classKActionCollection_a29})} 

{\bf action\-Highlighted()}{\rm (p.\,\pageref{classKActionCollection_l2})} 

{\bf action\-Highlighted()}{\rm (p.\,\pageref{classKActionCollection_l2})} 

{\bf highlighting\-Enabled()}{\rm (p.\,\pageref{classKActionCollection_a27})} \end{Desc}


Definition at line 483 of file kactioncollection.cpp.\index{KActionCollection@{KAction\-Collection}!highlightingEnabled@{highlightingEnabled}}
\index{highlightingEnabled@{highlightingEnabled}!KActionCollection@{KAction\-Collection}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KAction\-Collection::highlighting\-Enabled () const}\label{classKActionCollection_a27}


Return whether highlighting notifications are enabled. 

\begin{Desc}
\item[See also:]{\bf connect\-Highlight()}{\rm (p.\,\pageref{classKActionCollection_a28})} 

{\bf disconnect\-Highlight()}{\rm (p.\,\pageref{classKActionCollection_a29})} 

{\bf action\-Highlighted()}{\rm (p.\,\pageref{classKActionCollection_l2})} 

{\bf set\-Highlighting\-Enabled()}{\rm (p.\,\pageref{classKActionCollection_a26})} 

{\bf action\-Highlighted()}{\rm (p.\,\pageref{classKActionCollection_l2})} \end{Desc}


Definition at line 488 of file kactioncollection.cpp.\index{KActionCollection@{KAction\-Collection}!connectHighlight@{connectHighlight}}
\index{connectHighlight@{connectHighlight}!KActionCollection@{KAction\-Collection}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KAction\-Collection::connect\-Highlight ({\bf QWidget} $\ast$ {\em container}, {\bf KAction} $\ast$ {\em action})}\label{classKActionCollection_a28}


Call this function if you want to receive a signal whenever a {\bf KAction}{\rm (p.\,\pageref{classKAction})} is highlighted in a menu or a toolbar. 

This is only needed if you do not add this action to this container. You will generally not need to call this function.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em container}]A container in which the {\bf KAction}{\rm (p.\,\pageref{classKAction})} is plugged (must inherit {\bf QPopup\-Menu} or {\bf KTool\-Bar}{\rm (p.\,\pageref{classKToolBar})}) \item[{\em action}]The action you are interested in \end{description}
\end{Desc}
\begin{Desc}
\item[See also:]{\bf disconnect\-Highlight()}{\rm (p.\,\pageref{classKActionCollection_a29})} 

{\bf action\-Highlighted()}{\rm (p.\,\pageref{classKActionCollection_l2})} 

{\bf set\-Highlighting\-Enabled()}{\rm (p.\,\pageref{classKActionCollection_a26})} 

{\bf highlighting\-Enabled()}{\rm (p.\,\pageref{classKActionCollection_a27})} 

{\bf action\-Highlighted()}{\rm (p.\,\pageref{classKActionCollection_l2})} \end{Desc}


Definition at line 493 of file kactioncollection.cpp.

References action(), QPtr\-List::append(), QObject::connect(), QObject::destroyed(), and QPtr\-List::insert().

Referenced by KAction\-Menu::plug(), and KAction::plug().\index{KActionCollection@{KAction\-Collection}!disconnectHighlight@{disconnectHighlight}}
\index{disconnectHighlight@{disconnectHighlight}!KActionCollection@{KAction\-Collection}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KAction\-Collection::disconnect\-Highlight ({\bf QWidget} $\ast$ {\em container}, {\bf KAction} $\ast$ {\em action})}\label{classKActionCollection_a29}


Disconnect highlight notifications for a particular pair of contianer and action. 

This is only needed if you do not add this action to this container. You will generally not need to call this function.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em container}]A container in which the {\bf KAction}{\rm (p.\,\pageref{classKAction})} is plugged (must inherit {\bf QPopup\-Menu} or {\bf KTool\-Bar}{\rm (p.\,\pageref{classKToolBar})}) \item[{\em action}]The action you are interested in \end{description}
\end{Desc}
\begin{Desc}
\item[See also:]{\bf connect\-Highlight()}{\rm (p.\,\pageref{classKActionCollection_a28})} 

{\bf action\-Highlighted()}{\rm (p.\,\pageref{classKActionCollection_l2})} 

{\bf set\-Highlighting\-Enabled()}{\rm (p.\,\pageref{classKActionCollection_a26})} 

{\bf highlighting\-Enabled()}{\rm (p.\,\pageref{classKActionCollection_a27})} 

{\bf action\-Highlighted()}{\rm (p.\,\pageref{classKActionCollection_l2})} \end{Desc}


Definition at line 526 of file kactioncollection.cpp.

References action(), QPtr\-List::is\-Empty(), QPtr\-List::remove(), and QPtr\-List::remove\-Ref().

Referenced by KAction::unplug().\index{KActionCollection@{KAction\-Collection}!parentGUIClient@{parentGUIClient}}
\index{parentGUIClient@{parentGUIClient}!KActionCollection@{KAction\-Collection}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}const {\bf KXMLGUIClient} $\ast$ KAction\-Collection::parent\-GUIClient () const}\label{classKActionCollection_a30}


The parent {\bf KXMLGUIClient}{\rm (p.\,\pageref{classKXMLGUIClient})}, return 0L if not available. 



Definition at line 627 of file kactioncollection.cpp.\index{KActionCollection@{KAction\-Collection}!actionHighlighted@{actionHighlighted}}
\index{actionHighlighted@{actionHighlighted}!KActionCollection@{KAction\-Collection}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KAction\-Collection::action\-Highlighted ({\bf KAction} $\ast$ {\em action})\hspace{0.3cm}{\tt  [signal]}}\label{classKActionCollection_l2}


Emitted when \char`\"{}action\char`\"{} is highlighted. 

This is only emitted if you have {\bf set\-Highlighting\-Enabled()}{\rm (p.\,\pageref{classKActionCollection_a26})} \begin{Desc}
\item[See also:]{\bf connect\-Highlight()}{\rm (p.\,\pageref{classKActionCollection_a28})} 

{\bf disconnect\-Highlight()}{\rm (p.\,\pageref{classKActionCollection_a29})} 

{\bf action\-Highlighted()}{\rm (p.\,\pageref{classKActionCollection_l2})} 

{\bf set\-Highlighting\-Enabled()}{\rm (p.\,\pageref{classKActionCollection_a26})} 

{\bf highlighting\-Enabled()}{\rm (p.\,\pageref{classKActionCollection_a27})} \end{Desc}
\index{KActionCollection@{KAction\-Collection}!actionHighlighted@{actionHighlighted}}
\index{actionHighlighted@{actionHighlighted}!KActionCollection@{KAction\-Collection}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KAction\-Collection::action\-Highlighted ({\bf KAction} $\ast$ {\em action}, bool {\em highlight})\hspace{0.3cm}{\tt  [signal]}}\label{classKActionCollection_l3}


Emitted when \char`\"{}action\char`\"{} is highlighed or loses highlighting. 

This is only emitted if you have {\bf set\-Highlighting\-Enabled()}{\rm (p.\,\pageref{classKActionCollection_a26})} \begin{Desc}
\item[See also:]{\bf connect\-Highlight()}{\rm (p.\,\pageref{classKActionCollection_a28})} 

{\bf disconnect\-Highlight()}{\rm (p.\,\pageref{classKActionCollection_a29})} 

{\bf action\-Highlighted()}{\rm (p.\,\pageref{classKActionCollection_l2})} 

{\bf set\-Highlighting\-Enabled()}{\rm (p.\,\pageref{classKActionCollection_a26})} 

{\bf highlighting\-Enabled()}{\rm (p.\,\pageref{classKActionCollection_a27})} \end{Desc}
\index{KActionCollection@{KAction\-Collection}!actionStatusText@{actionStatusText}}
\index{actionStatusText@{actionStatusText}!KActionCollection@{KAction\-Collection}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KAction\-Collection::action\-Status\-Text (const {\bf QString} \& {\em text})\hspace{0.3cm}{\tt  [signal]}}\label{classKActionCollection_l4}


Emitted when an action is highlighted, with text being the tooltip for the action. 

This is only emitted if you have {\bf set\-Highlighting\-Enabled()}{\rm (p.\,\pageref{classKActionCollection_a26})}

This is useful to connect to {\bf KStatus\-Bar::message()}. See this class overview for more information.

\begin{Desc}
\item[See also:]{\bf set\-Highlighting\-Enabled()}{\rm (p.\,\pageref{classKActionCollection_a26})} \end{Desc}
\index{KActionCollection@{KAction\-Collection}!clearStatusText@{clearStatusText}}
\index{clearStatusText@{clearStatusText}!KActionCollection@{KAction\-Collection}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KAction\-Collection::clear\-Status\-Text ()\hspace{0.3cm}{\tt  [signal]}}\label{classKActionCollection_l5}


Emitted when an action loses highlighting. 

This is only emitted if you have {\bf set\-Highlighting\-Enabled()}{\rm (p.\,\pageref{classKActionCollection_a26})}

\begin{Desc}
\item[See also:]{\bf set\-Highlighting\-Enabled()}{\rm (p.\,\pageref{classKActionCollection_a26})} \end{Desc}
\index{KActionCollection@{KAction\-Collection}!insert@{insert}}
\index{insert@{insert}!KActionCollection@{KAction\-Collection}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KAction\-Collection::insert ({\bf KAction} $\ast$ {\em action})}\label{classKActionCollection_a32}


Add an action to the collection. 

Generally you don't have to call this. The action inserts itself automatically into its parent collection. This can be useful however for a short-lived collection (e.g. for a popupmenu, where the signals from the collection are needed too). (don't forget that in the simple case, a list of actions should be a simple KAction\-Ptr\-List). If you manually insert actions into a 2nd collection, don't forget to take them out again before destroying the collection. \begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em action}]The {\bf KAction}{\rm (p.\,\pageref{classKAction})} to add. \end{description}
\end{Desc}


Definition at line 365 of file kactioncollection.cpp.

References action().\index{KActionCollection@{KAction\-Collection}!remove@{remove}}
\index{remove@{remove}!KActionCollection@{KAction\-Collection}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KAction\-Collection::remove ({\bf KAction} $\ast$ {\em action})}\label{classKActionCollection_a33}


Removes an action from the collection and deletes it. 

Since the {\bf KAction}{\rm (p.\,\pageref{classKAction})} destructor removes the action from the collection, you generally don't have to call this. \begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em action}]The {\bf KAction}{\rm (p.\,\pageref{classKAction})} to remove. \end{description}
\end{Desc}


Definition at line 366 of file kactioncollection.cpp.

References action().\index{KActionCollection@{KAction\-Collection}!take@{take}}
\index{take@{take}!KActionCollection@{KAction\-Collection}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf KAction} $\ast$ KAction\-Collection::take ({\bf KAction} $\ast$ {\em action})}\label{classKActionCollection_a34}


Removes an action from the collection. 

Since the {\bf KAction}{\rm (p.\,\pageref{classKAction})} destructor removes the action from the collection, you generally don't have to call this. \begin{Desc}
\item[Returns:]NULL if not found else returns action. \end{Desc}
\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em action}]the {\bf KAction}{\rm (p.\,\pageref{classKAction})} to remove. \end{description}
\end{Desc}


Definition at line 367 of file kactioncollection.cpp.

References action().

Referenced by KAction::$\sim$KAction().\index{KActionCollection@{KAction\-Collection}!clear@{clear}}
\index{clear@{clear}!KActionCollection@{KAction\-Collection}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KAction\-Collection::clear ()\hspace{0.3cm}{\tt  [slot]}}\label{classKActionCollection_i0}


Clears the entire action\-Collection, deleting all actions. 

\begin{Desc}
\item[See also:]{\bf remove}{\rm (p.\,\pageref{classKActionCollection_a33})} \end{Desc}


Definition at line 368 of file kactioncollection.cpp.

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