\section{KIcon\-Button Class Reference}
\label{classKIconButton}\index{KIconButton@{KIconButton}}
A pushbutton for choosing an icon. A push button that allows selection of an icon.  


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

Inheritance diagram for KIcon\-Button:\begin{figure}[H]
\begin{center}
\leavevmode
\includegraphics[width=56pt]{classKIconButton__inherit__graph}
\end{center}
\end{figure}
Collaboration diagram for KIcon\-Button:\begin{figure}[H]
\begin{center}
\leavevmode
\includegraphics[width=224pt]{classKIconButton__coll__graph}
\end{center}
\end{figure}
\subsection*{Signals}
\begin{CompactItemize}
\item 
void {\bf icon\-Changed} ({\bf QString} icon)
\begin{CompactList}\small\item\em Emitted when the icon has changed. \item\end{CompactList}\end{CompactItemize}
\subsection*{Public Member Functions}
\begin{CompactItemize}
\item 
{\bf KIcon\-Button} ({\bf QWidget} $\ast$parent=0L, const  char $\ast$name=0L)
\begin{CompactList}\small\item\em Constructs a KIcon\-Button using the global iconloader. \item\end{CompactList}\item 
{\bf KIcon\-Button} ({\bf KIcon\-Loader} $\ast$loader, {\bf QWidget} $\ast$parent, const  char $\ast$name=0L)
\begin{CompactList}\small\item\em Constructs a KIcon\-Button using a specific {\bf KIcon\-Loader}. \item\end{CompactList}\item 
{\bf $\sim$KIcon\-Button} ()
\begin{CompactList}\small\item\em Destructs the button. \item\end{CompactList}\item 
void {\bf set\-Strict\-Icon\-Size} (bool b)
\begin{CompactList}\small\item\em Sets a strict icon size policy for allowed icons. \item\end{CompactList}\item 
bool {\bf strict\-Icon\-Size} () const 
\begin{CompactList}\small\item\em Returns true if a strict icon size policy is set. \item\end{CompactList}\item 
void {\bf set\-Icon\-Type} ({\bf KIcon::Group} {\bf group}, {\bf KIcon::Context} context, bool user=false)
\begin{CompactList}\small\item\em Sets the icon group and context. \item\end{CompactList}\item 
void {\bf set\-Icon} (const  {\bf QString} \&icon)
\begin{CompactList}\small\item\em Sets the button's initial icon. \item\end{CompactList}\item 
void {\bf reset\-Icon} ()
\begin{CompactList}\small\item\em Resets the icon (reverts to an empty button). \item\end{CompactList}\item 
{\bf QString} {\bf icon} () const 
\begin{CompactList}\small\item\em Returns the name of the selected icon. \item\end{CompactList}\item 
void {\bf set\-Icon\-Size} (int size)
\begin{CompactList}\small\item\em Sets the size of the icon to be shown / selected. \item\end{CompactList}\item 
int {\bf icon\-Size} () const 
\begin{CompactList}\small\item\em Returns the iconsize set via {\bf set\-Icon\-Size}{\rm (p.\,\pageref{classKIconButton_a9})}() or 0, if the default iconsize will be used. \item\end{CompactList}\end{CompactItemize}


\subsection{Detailed Description}
A pushbutton for choosing an icon. A push button that allows selection of an icon. 

Pressing on the button will open a {\bf KIcon\-Dialog}{\rm (p.\,\pageref{classKIconDialog})} for the user to select an icon. The current icon will be displayed on the button.

\begin{Desc}
\item[See also:]{\bf KIcon\-Dialog}{\rm (p.\,\pageref{classKIconDialog})} \end{Desc}




Definition at line 227 of file kicondialog.h.

\subsection{Constructor \& Destructor Documentation}
\index{KIconButton@{KIcon\-Button}!KIconButton@{KIconButton}}
\index{KIconButton@{KIconButton}!KIconButton@{KIcon\-Button}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KIcon\-Button::KIcon\-Button ({\bf QWidget} $\ast$ {\em parent} = 0L, const char $\ast$ {\em name} = 0L)}\label{classKIconButton_a0}


Constructs a KIcon\-Button using the global iconloader. 



Definition at line 477 of file kicondialog.cpp.

References KIcon::Application, QPush\-Button::clicked(), KGlobal::icon\-Loader(), and KStd\-Accel::name().\index{KIconButton@{KIcon\-Button}!KIconButton@{KIconButton}}
\index{KIconButton@{KIconButton}!KIconButton@{KIcon\-Button}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KIcon\-Button::KIcon\-Button ({\bf KIcon\-Loader} $\ast$ {\em loader}, {\bf QWidget} $\ast$ {\em parent}, const char $\ast$ {\em name} = 0L)}\label{classKIconButton_a1}


Constructs a KIcon\-Button using a specific {\bf KIcon\-Loader}. 



Definition at line 491 of file kicondialog.cpp.

References KIcon::Application, QPush\-Button::clicked(), and KStd\-Accel::name().\index{KIconButton@{KIcon\-Button}!~KIconButton@{$\sim$KIconButton}}
\index{~KIconButton@{$\sim$KIconButton}!KIconButton@{KIcon\-Button}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KIcon\-Button::$\sim${\bf KIcon\-Button} ()}\label{classKIconButton_a2}


Destructs the button. 



Definition at line 505 of file kicondialog.cpp.

\subsection{Member Function Documentation}
\index{KIconButton@{KIcon\-Button}!setStrictIconSize@{setStrictIconSize}}
\index{setStrictIconSize@{setStrictIconSize}!KIconButton@{KIcon\-Button}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KIcon\-Button::set\-Strict\-Icon\-Size (bool {\em b})}\label{classKIconButton_a3}


Sets a strict icon size policy for allowed icons. 

When true, only icons of the specified group's size in set\-Icon\-Type are allowed, and only icons of that size will be shown in the icon dialog. 

Definition at line 511 of file kicondialog.cpp.

Referenced by KFile\-Props\-Plugin::KFile\-Props\-Plugin(), and KURLBar\-Item\-Dialog::KURLBar\-Item\-Dialog().\index{KIconButton@{KIcon\-Button}!strictIconSize@{strictIconSize}}
\index{strictIconSize@{strictIconSize}!KIconButton@{KIcon\-Button}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KIcon\-Button::strict\-Icon\-Size () const}\label{classKIconButton_a4}


Returns true if a strict icon size policy is set. 



Definition at line 516 of file kicondialog.cpp.\index{KIconButton@{KIcon\-Button}!setIconType@{setIconType}}
\index{setIconType@{setIconType}!KIconButton@{KIcon\-Button}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KIcon\-Button::set\-Icon\-Type ({\bf KIcon::Group} {\em group}, {\bf KIcon::Context} {\em context}, bool {\em user} = false)}\label{classKIconButton_a5}


Sets the icon group and context. 

Use KIcon::No\-Group if you want to allow icons for any group in the given context. 

Definition at line 531 of file kicondialog.cpp.

Referenced by KFile\-Props\-Plugin::KFile\-Props\-Plugin().\index{KIconButton@{KIcon\-Button}!setIcon@{setIcon}}
\index{setIcon@{setIcon}!KIconButton@{KIcon\-Button}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KIcon\-Button::set\-Icon (const {\bf QString} \& {\em icon})}\label{classKIconButton_a6}


Sets the button's initial icon. 



Definition at line 538 of file kicondialog.cpp.

References KIcon\-Loader::icon\-Path(), KIcon\-Loader::load\-Icon(), KIcon\-Dialog::set\-Custom\-Location(), and QPush\-Button::set\-Pixmap().

Referenced by KFile\-Props\-Plugin::KFile\-Props\-Plugin(), and KURLBar\-Item\-Dialog::KURLBar\-Item\-Dialog().\index{KIconButton@{KIcon\-Button}!resetIcon@{resetIcon}}
\index{resetIcon@{resetIcon}!KIconButton@{KIcon\-Button}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KIcon\-Button::reset\-Icon ()}\label{classKIconButton_a7}


Resets the icon (reverts to an empty button). 



Definition at line 548 of file kicondialog.cpp.

References QPush\-Button::set\-Pixmap().\index{KIconButton@{KIcon\-Button}!icon@{icon}}
\index{icon@{icon}!KIconButton@{KIcon\-Button}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString} KIcon\-Button::icon () const\hspace{0.3cm}{\tt  [inline]}}\label{classKIconButton_a8}


Returns the name of the selected icon. 



Definition at line 276 of file kicondialog.h.

Referenced by KDevice\-Props\-Plugin::apply\-Changes(), and KURLBar\-Item\-Dialog::icon().\index{KIconButton@{KIcon\-Button}!setIconSize@{setIconSize}}
\index{setIconSize@{setIconSize}!KIconButton@{KIcon\-Button}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KIcon\-Button::set\-Icon\-Size (int {\em size})}\label{classKIconButton_a9}


Sets the size of the icon to be shown / selected. 

\begin{Desc}
\item[See also:]{\bf KIcon::Std\-Sizes} 

{\bf icon\-Size}{\rm (p.\,\pageref{classKIconButton_a10})} \end{Desc}


Definition at line 521 of file kicondialog.cpp.

Referenced by KURLBar\-Item\-Dialog::KURLBar\-Item\-Dialog().\index{KIconButton@{KIcon\-Button}!iconSize@{iconSize}}
\index{iconSize@{iconSize}!KIconButton@{KIcon\-Button}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}int KIcon\-Button::icon\-Size () const}\label{classKIconButton_a10}


Returns the iconsize set via {\bf set\-Icon\-Size}{\rm (p.\,\pageref{classKIconButton_a9})}() or 0, if the default iconsize will be used. 



Definition at line 526 of file kicondialog.cpp.\index{KIconButton@{KIcon\-Button}!iconChanged@{iconChanged}}
\index{iconChanged@{iconChanged}!KIconButton@{KIcon\-Button}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KIcon\-Button::icon\-Changed ({\bf QString} {\em icon})\hspace{0.3cm}{\tt  [signal]}}\label{classKIconButton_l0}


Emitted when the icon has changed. 



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