\section{KChar\-Select Class Reference}
\label{classKCharSelect}\index{KCharSelect@{KCharSelect}}
A Widget which allows the user to select a character of a specified font in a table Character-Selection Widget.  


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

Inheritance diagram for KChar\-Select:\begin{figure}[H]
\begin{center}
\leavevmode
\includegraphics[width=53pt]{classKCharSelect__inherit__graph}
\end{center}
\end{figure}
Collaboration diagram for KChar\-Select:\begin{figure}[H]
\begin{center}
\leavevmode
\includegraphics[width=304pt]{classKCharSelect__coll__graph}
\end{center}
\end{figure}
\subsection*{Signals}
\begin{CompactItemize}
\item 
void {\bf highlighted} (const  {\bf QChar} \&c)\label{classKCharSelect_l0}

\item 
void {\bf highlighted} ()\label{classKCharSelect_l1}

\item 
void {\bf activated} (const  {\bf QChar} \&c)\label{classKCharSelect_l2}

\item 
void {\bf activated} ()\label{classKCharSelect_l3}

\item 
void {\bf font\-Changed} (const  {\bf QString} \&\_\-font)\label{classKCharSelect_l4}

\item 
void {\bf focus\-Item\-Changed} ()\label{classKCharSelect_l5}

\item 
void {\bf focus\-Item\-Changed} (const  {\bf QChar} \&c)\label{classKCharSelect_l6}

\item 
void {\bf double\-Clicked} ()\label{classKCharSelect_l7}

\end{CompactItemize}
\subsection*{Public Member Functions}
\begin{CompactItemize}
\item 
{\bf KChar\-Select} ({\bf QWidget} $\ast$parent, const  char $\ast$name, const  {\bf QString} \&font=QString::null, const  {\bf QChar} \&chr= ' ', int table\-Num=0)
\begin{CompactList}\small\item\em Constructor. \item\end{CompactList}\item 
virtual {\bf QSize} {\bf size\-Hint} () const 
\begin{CompactList}\small\item\em Reimplemented. \item\end{CompactList}\item 
virtual void {\bf set\-Font} (const  {\bf QString} \&font)
\begin{CompactList}\small\item\em Sets the font which is displayed to {\tt font}. \item\end{CompactList}\item 
virtual void {\bf set\-Char} (const  {\bf QChar} \&chr)
\begin{CompactList}\small\item\em Sets the currently selected character to {\tt chr}. \item\end{CompactList}\item 
virtual void {\bf set\-Table\-Num} (int table\-Num)
\begin{CompactList}\small\item\em Sets the currently displayed table to {\tt table\-Num}. \item\end{CompactList}\item 
virtual {\bf QChar} {\bf chr} () const 
\begin{CompactList}\small\item\em Returns the currently selected character. \item\end{CompactList}\item 
virtual {\bf QString} {\bf font} () const 
\begin{CompactList}\small\item\em Returns the currently displayed font. \item\end{CompactList}\item 
virtual int {\bf table\-Num} () const 
\begin{CompactList}\small\item\em Returns the currently displayed table. \item\end{CompactList}\item 
virtual void {\bf enable\-Font\-Combo} (bool e)
\begin{CompactList}\small\item\em If {\tt e} is set to TRUE, the combobox which allows the user to select the font which should be displayed is enabled, else disabled. \item\end{CompactList}\item 
virtual void {\bf enable\-Table\-Spin\-Box} (bool e)
\begin{CompactList}\small\item\em If {\tt e} is set to TRUE, the spinbox which allows the user to specify which characters of the font should be displayed, is enabled, else disabled. \item\end{CompactList}\item 
virtual bool {\bf is\-Font\-Combo\-Enabled} () const 
\begin{CompactList}\small\item\em Returns wether the font combobox on the top is enabled or disabled. \item\end{CompactList}\item 
virtual bool {\bf is\-Table\-Spin\-Box\-Enabled} () const 
\begin{CompactList}\small\item\em Returns wether the table spinbox on the top is enabled or disabled. \item\end{CompactList}\end{CompactItemize}
\subsection*{Protected Slots}
\begin{CompactItemize}
\item 
void {\bf font\-Selected} (const  {\bf QString} \&\_\-font)\label{classKCharSelect_j0}

\item 
void {\bf table\-Changed} (int \_\-value)\label{classKCharSelect_j1}

\item 
void {\bf char\-Highlighted} (const  {\bf QChar} \&c)\label{classKCharSelect_j2}

\item 
void {\bf char\-Highlighted} ()\label{classKCharSelect_j3}

\item 
void {\bf char\-Activated} (const  {\bf QChar} \&c)\label{classKCharSelect_j4}

\item 
void {\bf char\-Activated} ()\label{classKCharSelect_j5}

\item 
void {\bf char\-Focus\-Item\-Changed} ()\label{classKCharSelect_j6}

\item 
void {\bf char\-Focus\-Item\-Changed} (const  {\bf QChar} \&c)\label{classKCharSelect_j7}

\item 
void {\bf char\-Table\-Up} ()\label{classKCharSelect_j8}

\item 
void {\bf char\-Table\-Down} ()\label{classKCharSelect_j9}

\item 
void {\bf slot\-Double\-Clicked} ()\label{classKCharSelect_j10}

\end{CompactItemize}
\subsection*{Protected Member Functions}
\begin{CompactItemize}
\item 
virtual void {\bf fill\-Font\-Combo} ()\label{classKCharSelect_b0}

\item 
virtual void {\bf virtual\_\-hook} (int id, void $\ast$data)\label{classKCharSelect_b1}

\end{CompactItemize}
\subsection*{Static Protected Member Functions}
\begin{CompactItemize}
\item 
void {\bf cleanup\-Font\-Database} ()\label{classKCharSelect_f0}

\end{CompactItemize}
\subsection*{Protected Attributes}
\begin{CompactItemize}
\item 
{\bf QCombo\-Box} $\ast$ {\bf font\-Combo}\label{classKCharSelect_p0}

\item 
{\bf QSpin\-Box} $\ast$ {\bf table\-Spin\-Box}\label{classKCharSelect_p1}

\item 
{\bf KChar\-Select\-Table} $\ast$ {\bf char\-Table}\label{classKCharSelect_p2}

\item 
{\bf QString\-List} {\bf font\-List}\label{classKCharSelect_p3}

\end{CompactItemize}
\subsection*{Static Protected Attributes}
\begin{CompactItemize}
\item 
{\bf QFont\-Database} $\ast$ {\bf font\-Data\-Base} = 0\label{classKCharSelect_t0}

\end{CompactItemize}


\subsection{Detailed Description}
A Widget which allows the user to select a character of a specified font in a table Character-Selection Widget. 

You can specify the font whoes characters should be displayed via {\bf set\-Font}{\rm (p.\,\pageref{classKCharSelect_a2})}(). Using {\bf enable\-Font\-Combo}{\rm (p.\,\pageref{classKCharSelect_a8})}() you can allow the user to choose the font from a combob-box. As only 256 characters are displayed at once in the table, using the spinbox on the top the user can choose starting from which chracater the table displayes them. This spinbox also can be enabled or disabled using {\bf enable\-Table\-Spin\-Box}{\rm (p.\,\pageref{classKCharSelect_a9})}().

KChar\-Select supports keyboard and mouse navigation. Click+Move selects always the character below the mouse cursor. Using the arrow keys the focus mark is moved around and with pressing RETURN or SPACE the cell which contains the focus mark gets selected.

To get the current selected character, use the {\bf chr}{\rm (p.\,\pageref{classKCharSelect_a5})}() method. You can set the character which should be displayed with {\bf set\-Char}{\rm (p.\,\pageref{classKCharSelect_a3})}() and the table number which should be displayed with {\bf set\-Table\-Num}{\rm (p.\,\pageref{classKCharSelect_a4})}().

\begin{Desc}
\item[Version:]\begin{Desc}
\item[Id]{\bf kcharselect.h}{\rm (p.\,\pageref{kcharselect_8h})},v 1.21 2002/03/04 00:51:46 lunakl Exp \end{Desc}
\end{Desc}
\begin{Desc}
\item[Author:]Reginald Stadlbauer $<${\tt reggie@kde.org}$>$ \end{Desc}




Definition at line 134 of file kcharselect.h.

\subsection{Constructor \& Destructor Documentation}
\index{KCharSelect@{KChar\-Select}!KCharSelect@{KCharSelect}}
\index{KCharSelect@{KCharSelect}!KCharSelect@{KChar\-Select}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KChar\-Select::KChar\-Select ({\bf QWidget} $\ast$ {\em parent}, const char $\ast$ {\em name}, const {\bf QString} \& {\em font} = QString::null, const {\bf QChar} \& {\em chr} = ' ', int {\em table\-Num} = 0)}\label{classKCharSelect_a0}


Constructor. 

{\tt font} specifies which font should be displayed, {\tt chr} which character should be selected and {\tt table\-Num} specifies the number of the table which should be displayed. 

Definition at line 333 of file kcharselect.cpp.

References QString::is\-Empty(), KStd\-Accel::name(), QLabel::set\-Alignment(), set\-Font(), QHBox::set\-Spacing(), set\-Table\-Num(), and KDialog::spacing\-Hint().

\subsection{Member Function Documentation}
\index{KCharSelect@{KChar\-Select}!sizeHint@{sizeHint}}
\index{sizeHint@{sizeHint}!KCharSelect@{KChar\-Select}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QSize} KChar\-Select::size\-Hint () const\hspace{0.3cm}{\tt  [virtual]}}\label{classKCharSelect_a1}


Reimplemented. 



Definition at line 390 of file kcharselect.cpp.\index{KCharSelect@{KChar\-Select}!setFont@{setFont}}
\index{setFont@{setFont}!KCharSelect@{KChar\-Select}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KChar\-Select::set\-Font (const {\bf QString} \& {\em font})\hspace{0.3cm}{\tt  [virtual]}}\label{classKCharSelect_a2}


Sets the font which is displayed to {\tt font}. 



Definition at line 396 of file kcharselect.cpp.

References QCombo\-Box::set\-Current\-Item(), and KChar\-Select\-Table::set\-Font().

Referenced by KChar\-Select().\index{KCharSelect@{KChar\-Select}!setChar@{setChar}}
\index{setChar@{setChar}!KCharSelect@{KChar\-Select}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KChar\-Select::set\-Char (const {\bf QChar} \& {\em chr})\hspace{0.3cm}{\tt  [virtual]}}\label{classKCharSelect_a3}


Sets the currently selected character to {\tt chr}. 



Definition at line 411 of file kcharselect.cpp.

References KChar\-Select\-Table::set\-Char().\index{KCharSelect@{KChar\-Select}!setTableNum@{setTableNum}}
\index{setTableNum@{setTableNum}!KCharSelect@{KChar\-Select}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KChar\-Select::set\-Table\-Num (int {\em table\-Num})\hspace{0.3cm}{\tt  [virtual]}}\label{classKCharSelect_a4}


Sets the currently displayed table to {\tt table\-Num}. 



Definition at line 417 of file kcharselect.cpp.

References KChar\-Select\-Table::set\-Table\-Num(), and QSpin\-Box::set\-Value().

Referenced by KChar\-Select().\index{KCharSelect@{KChar\-Select}!chr@{chr}}
\index{chr@{chr}!KCharSelect@{KChar\-Select}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}virtual {\bf QChar} KChar\-Select::chr () const\hspace{0.3cm}{\tt  [inline, virtual]}}\label{classKCharSelect_a5}


Returns the currently selected character. 



Definition at line 173 of file kcharselect.h.

References KChar\-Select\-Table::chr().\index{KCharSelect@{KChar\-Select}!font@{font}}
\index{font@{font}!KCharSelect@{KChar\-Select}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}virtual {\bf QString} KChar\-Select::font () const\hspace{0.3cm}{\tt  [inline, virtual]}}\label{classKCharSelect_a6}


Returns the currently displayed font. 



Definition at line 178 of file kcharselect.h.

References QCombo\-Box::current\-Text().\index{KCharSelect@{KChar\-Select}!tableNum@{tableNum}}
\index{tableNum@{tableNum}!KCharSelect@{KChar\-Select}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}virtual int KChar\-Select::table\-Num () const\hspace{0.3cm}{\tt  [inline, virtual]}}\label{classKCharSelect_a7}


Returns the currently displayed table. 



Definition at line 183 of file kcharselect.h.

References QSpin\-Box::value().\index{KCharSelect@{KChar\-Select}!enableFontCombo@{enableFontCombo}}
\index{enableFontCombo@{enableFontCombo}!KCharSelect@{KChar\-Select}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}virtual void KChar\-Select::enable\-Font\-Combo (bool {\em e})\hspace{0.3cm}{\tt  [inline, virtual]}}\label{classKCharSelect_a8}


If {\tt e} is set to TRUE, the combobox which allows the user to select the font which should be displayed is enabled, else disabled. 



Definition at line 190 of file kcharselect.h.\index{KCharSelect@{KChar\-Select}!enableTableSpinBox@{enableTableSpinBox}}
\index{enableTableSpinBox@{enableTableSpinBox}!KCharSelect@{KChar\-Select}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}virtual void KChar\-Select::enable\-Table\-Spin\-Box (bool {\em e})\hspace{0.3cm}{\tt  [inline, virtual]}}\label{classKCharSelect_a9}


If {\tt e} is set to TRUE, the spinbox which allows the user to specify which characters of the font should be displayed, is enabled, else disabled. 



Definition at line 198 of file kcharselect.h.\index{KCharSelect@{KChar\-Select}!isFontComboEnabled@{isFontComboEnabled}}
\index{isFontComboEnabled@{isFontComboEnabled}!KCharSelect@{KChar\-Select}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}virtual bool KChar\-Select::is\-Font\-Combo\-Enabled () const\hspace{0.3cm}{\tt  [inline, virtual]}}\label{classKCharSelect_a10}


Returns wether the font combobox on the top is enabled or disabled. 

\begin{Desc}
\item[See also:]{\bf enable\-Font\-Combo()}{\rm (p.\,\pageref{classKCharSelect_a8})} \end{Desc}


Definition at line 206 of file kcharselect.h.\index{KCharSelect@{KChar\-Select}!isTableSpinBoxEnabled@{isTableSpinBoxEnabled}}
\index{isTableSpinBoxEnabled@{isTableSpinBoxEnabled}!KCharSelect@{KChar\-Select}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}virtual bool KChar\-Select::is\-Table\-Spin\-Box\-Enabled () const\hspace{0.3cm}{\tt  [inline, virtual]}}\label{classKCharSelect_a11}


Returns wether the table spinbox on the top is enabled or disabled. 

\begin{Desc}
\item[See also:]{\bf enable\-Table\-Spin\-Box()}{\rm (p.\,\pageref{classKCharSelect_a9})} \end{Desc}


Definition at line 214 of file kcharselect.h.

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