\section{KXMLGUIBuilder Class Reference}
\label{classKXMLGUIBuilder}\index{KXMLGUIBuilder@{KXMLGUIBuilder}}
Abstract interface for a \char`\"{}GUI builder\char`\"{}, used by the GUIFactory This interface is implemented by {\bf KMain\-Window}{\rm (p.\,\pageref{classKMainWindow})} for the case where the toplevel widget is a {\bf KMain\-Window}{\rm (p.\,\pageref{classKMainWindow})}.  


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

Inheritance diagram for KXMLGUIBuilder:\begin{figure}[H]
\begin{center}
\leavevmode
\includegraphics[width=111pt]{classKXMLGUIBuilder__inherit__graph}
\end{center}
\end{figure}
\subsection*{Public Member Functions}
\begin{CompactItemize}
\item 
{\bf KXMLGUIBuilder} ({\bf QWidget} $\ast$widget)\label{classKXMLGUIBuilder_a0}

\item 
{\bf KXMLGUIClient} $\ast$ {\bf builder\-Client} () const \label{classKXMLGUIBuilder_a2}

\item 
void {\bf set\-Builder\-Client} ({\bf KXMLGUIClient} $\ast$client)\label{classKXMLGUIBuilder_a3}

\item 
{\bf KInstance} $\ast$ {\bf builder\-Instance} () const \label{classKXMLGUIBuilder_a4}

\item 
void {\bf set\-Builder\-Instance} ({\bf KInstance} $\ast$instance)\label{classKXMLGUIBuilder_a5}

\item 
{\bf QWidget} $\ast$ {\bf widget} ()\label{classKXMLGUIBuilder_a6}

\item 
virtual {\bf QString\-List} {\bf container\-Tags} () const \label{classKXMLGUIBuilder_a7}

\item 
virtual {\bf QWidget} $\ast$ {\bf create\-Container} ({\bf QWidget} $\ast$parent, int index, const  {\bf QDom\-Element} \&element, int \&id)
\begin{CompactList}\small\item\em Creates a container (menubar/menu/toolbar/statusbar/separator/...) from an element in the XML file. \item\end{CompactList}\item 
virtual void {\bf remove\-Container} ({\bf QWidget} $\ast$container, {\bf QWidget} $\ast$parent, {\bf QDom\-Element} \&element, int id)
\begin{CompactList}\small\item\em Removes the given (and previously via {\bf create\-Container}{\rm (p.\,\pageref{classKXMLGUIBuilder_a8})} ) created container. \item\end{CompactList}\item 
virtual {\bf QString\-List} {\bf custom\-Tags} () const \label{classKXMLGUIBuilder_a10}

\item 
virtual int {\bf create\-Custom\-Element} ({\bf QWidget} $\ast$parent, int index, const  {\bf QDom\-Element} \&element)\label{classKXMLGUIBuilder_a11}

\item 
virtual void {\bf remove\-Custom\-Element} ({\bf QWidget} $\ast$parent, int id)\label{classKXMLGUIBuilder_a12}

\item 
virtual void {\bf finalize\-GUI} ({\bf KXMLGUIClient} $\ast$client)\label{classKXMLGUIBuilder_a13}

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

\end{CompactItemize}


\subsection{Detailed Description}
Abstract interface for a \char`\"{}GUI builder\char`\"{}, used by the GUIFactory This interface is implemented by {\bf KMain\-Window}{\rm (p.\,\pageref{classKMainWindow})} for the case where the toplevel widget is a {\bf KMain\-Window}{\rm (p.\,\pageref{classKMainWindow})}. 

Other implementations may appear in the future (dialogs for instance) 



Definition at line 37 of file kxmlguibuilder.h.

\subsection{Member Function Documentation}
\index{KXMLGUIBuilder@{KXMLGUIBuilder}!createContainer@{createContainer}}
\index{createContainer@{createContainer}!KXMLGUIBuilder@{KXMLGUIBuilder}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QWidget} $\ast$ KXMLGUIBuilder::create\-Container ({\bf QWidget} $\ast$ {\em parent}, int {\em index}, const {\bf QDom\-Element} \& {\em element}, int \& {\em id})\hspace{0.3cm}{\tt  [virtual]}}\label{classKXMLGUIBuilder_a8}


Creates a container (menubar/menu/toolbar/statusbar/separator/...) from an element in the XML file. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em parent}]The parent for the container \item[{\em index}]The index where the container should be inserted into the parent container/widget \item[{\em element}]The element from the DOM tree describing the container (use it to access container specified attributes or child elements) \item[{\em container\-State\-Buffer}]A buffer which possibibly contains previously saved container state information, return via {\bf remove\-Container}{\rm (p.\,\pageref{classKXMLGUIBuilder_a9})} . \end{description}
\end{Desc}


Definition at line 111 of file kxmlguibuilder.cpp.

References QDom\-Element::attribute(), KGlobal::instance(), KNotify\-Client::instance(), QString::is\-Empty(), QCString::is\-Empty(), KTool\-Bar::load\-State(), KStd\-Accel::name(), QWidget::parent\-Widget(), KTool\-Bar::set\-XMLGUIClient(), KMenu\-Bar::show(), KMain\-Window::status\-Bar(), QDom\-Element::tag\-Name(), and QDom\-Element::text().\index{KXMLGUIBuilder@{KXMLGUIBuilder}!removeContainer@{removeContainer}}
\index{removeContainer@{removeContainer}!KXMLGUIBuilder@{KXMLGUIBuilder}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KXMLGUIBuilder::remove\-Container ({\bf QWidget} $\ast$ {\em container}, {\bf QWidget} $\ast$ {\em parent}, {\bf QDom\-Element} \& {\em element}, int {\em id})\hspace{0.3cm}{\tt  [virtual]}}\label{classKXMLGUIBuilder_a9}


Removes the given (and previously via {\bf create\-Container}{\rm (p.\,\pageref{classKXMLGUIBuilder_a8})} ) created container. 

\begin{Desc}
\item[Returns:]A buffer containing state information about the deleted container (like the last position of a toolbar container for example). The buffer is passed again to {\bf create\-Container}{\rm (p.\,\pageref{classKXMLGUIBuilder_a8})} when the same container is about to be created again later. \end{Desc}


Definition at line 228 of file kxmlguibuilder.cpp.

References QWidget::hide(), QMenu\-Bar::hide(), and KTool\-Bar::save\-State().

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