.TH "KCharSelect" kde3 "11 Jun 2005" "Version Version 3.4.1" "kdeui Library" \" -*- nroff -*-
.ad l
.nh
.SH NAME
KCharSelect \- Character selection widget.  

.PP
.SH SYNOPSIS
.br
.PP
\fC#include <kcharselect.h>\fP
.PP
Inherits \fBQVBox\fP.
.PP
.SS "Signals"

.in +1c
.ti -1c
.RI "void \fBhighlighted\fP (const \fBQChar\fP &c)"
.br
.ti -1c
.RI "void \fBhighlighted\fP ()"
.br
.ti -1c
.RI "void \fBactivated\fP (const \fBQChar\fP &c)"
.br
.ti -1c
.RI "void \fBactivated\fP ()"
.br
.ti -1c
.RI "void \fBfontChanged\fP (const \fBQString\fP &_font)"
.br
.ti -1c
.RI "void \fBfocusItemChanged\fP ()"
.br
.ti -1c
.RI "void \fBfocusItemChanged\fP (const \fBQChar\fP &c)"
.br
.ti -1c
.RI "void \fBdoubleClicked\fP ()"
.br
.in -1c
.SS "Public Member Functions"

.in +1c
.ti -1c
.RI "\fBKCharSelect\fP (\fBQWidget\fP *parent, const char *name, const \fBQString\fP &font=QString::null, const \fBQChar\fP &chr= ' ', int tableNum=0)"
.br
.ti -1c
.RI "virtual \fBQSize\fP \fBsizeHint\fP () const "
.br
.ti -1c
.RI "virtual void \fBsetFont\fP (const \fBQString\fP &font)"
.br
.ti -1c
.RI "virtual void \fBsetChar\fP (const \fBQChar\fP &chr)"
.br
.ti -1c
.RI "virtual void \fBsetTableNum\fP (int tableNum)"
.br
.ti -1c
.RI "virtual \fBQChar\fP \fBchr\fP () const "
.br
.ti -1c
.RI "virtual \fBQString\fP \fBfont\fP () const "
.br
.ti -1c
.RI "virtual int \fBtableNum\fP () const "
.br
.ti -1c
.RI "virtual void \fBenableFontCombo\fP (bool e)"
.br
.ti -1c
.RI "virtual void \fBenableTableSpinBox\fP (bool e)"
.br
.ti -1c
.RI "virtual bool \fBisFontComboEnabled\fP () const "
.br
.ti -1c
.RI "virtual bool \fBisTableSpinBoxEnabled\fP () const "
.br
.in -1c
.SS "Protected Slots"

.in +1c
.ti -1c
.RI "void \fBfontSelected\fP (const \fBQString\fP &_font)"
.br
.ti -1c
.RI "void \fBtableChanged\fP (int _value)"
.br
.ti -1c
.RI "void \fBcharHighlighted\fP (const \fBQChar\fP &c)"
.br
.ti -1c
.RI "void \fBcharHighlighted\fP ()"
.br
.ti -1c
.RI "void \fBcharActivated\fP (const \fBQChar\fP &c)"
.br
.ti -1c
.RI "void \fBcharActivated\fP ()"
.br
.ti -1c
.RI "void \fBcharFocusItemChanged\fP ()"
.br
.ti -1c
.RI "void \fBcharFocusItemChanged\fP (const \fBQChar\fP &c)"
.br
.ti -1c
.RI "void \fBcharTableUp\fP ()"
.br
.ti -1c
.RI "void \fBcharTableDown\fP ()"
.br
.ti -1c
.RI "void \fBslotDoubleClicked\fP ()"
.br
.ti -1c
.RI "void \fBslotUnicodeEntered\fP ()"
.br
.ti -1c
.RI "void \fBslotUpdateUnicode\fP (const \fBQChar\fP &c)"
.br
.in -1c
.SS "Protected Member Functions"

.in +1c
.ti -1c
.RI "virtual void \fBfillFontCombo\fP ()"
.br
.ti -1c
.RI "virtual void \fBvirtual_hook\fP (int id, void *data)"
.br
.in -1c
.SS "Static Protected Member Functions"

.in +1c
.ti -1c
.RI "static void \fBcleanupFontDatabase\fP ()"
.br
.in -1c
.SS "Protected Attributes"

.in +1c
.ti -1c
.RI "\fBQComboBox\fP * \fBfontCombo\fP"
.br
.ti -1c
.RI "\fBQSpinBox\fP * \fBtableSpinBox\fP"
.br
.ti -1c
.RI "\fBKCharSelectTable\fP * \fBcharTable\fP"
.br
.ti -1c
.RI "\fBQStringList\fP \fBfontList\fP"
.br
.in -1c
.SS "Static Protected Attributes"

.in +1c
.ti -1c
.RI "static \fBQFontDatabase\fP * \fBfontDataBase\fP = 0"
.br
.in -1c
.SS "Properties"

.in +1c
.ti -1c
.RI "\fBQString\fP \fBfontFamily\fP"
.br
.ti -1c
.RI "int \fBtableNum\fP"
.br
.ti -1c
.RI "bool \fBfontComboEnabled\fP"
.br
.ti -1c
.RI "bool \fBtableSpinBoxEnabled\fP"
.br
.in -1c
.SH "Detailed Description"
.PP 
Character selection widget. 

This widget allows the user to select a character of a specified font in a table
.PP
Character Selection Widget You can specify the font whose characters should be displayed via \fBsetFont()\fP or in the constructor. Using \fBenableFontCombo()\fP 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 character the table displays them. This spinbox also can be enabled or disabled using \fBenableTableSpinBox()\fP.
.PP
KCharSelect supports keyboard and mouse navigation. Click+Move always selects the character below the mouse cursor. Using the arrow keys moves the focus mark around and pressing RETURN or SPACE selects the cell which contains the focus mark.
.PP
To get the current selected character, use the \fBchr()\fP method. You can set the character which should be displayed with \fBsetChar()\fP and the table number which should be displayed with \fBsetTableNum()\fP.
.PP
\fBAuthor:\fP
.RS 4
Reginald Stadlbauer <reggie@kde.org> 
.RE
.PP

.PP
Definition at line 140 of file kcharselect.h.
.SH "Constructor & Destructor Documentation"
.PP 
.SS "KCharSelect::KCharSelect (\fBQWidget\fP * parent, const char * name, const \fBQString\fP & font = \fCQString::null\fP, const \fBQChar\fP & chr = \fC' '\fP, int tableNum = \fC0\fP)"
.PP
Constructor. 
.PP
\fCfont\fP specifies which font should be displayed, \fCchr\fP which character should be selected and \fCtableNum\fP specifies the number of the table which should be displayed. 
.PP
Definition at line 366 of file kcharselect.cpp.
.PP
References QString::isEmpty(), QLabel::setAlignment(), QLabel::setBuddy(), setFont(), QHBox::setSpacing(), and setTableNum().
.SH "Member Function Documentation"
.PP 
.SS "\fBQSize\fP KCharSelect::sizeHint () const\fC [virtual]\fP"
.PP
Reimplemented. 
.PP
Definition at line 445 of file kcharselect.cpp.
.SS "void KCharSelect::setFont (const \fBQString\fP & font)\fC [virtual]\fP"
.PP
Sets the font which is displayed to \fCfont\fP. 
.PP
Definition at line 451 of file kcharselect.cpp.
.PP
References endl(), kdWarning(), QComboBox::setCurrentItem(), and KCharSelectTable::setFont().
.PP
Referenced by KCharSelect().
.SS "void KCharSelect::setChar (const \fBQChar\fP & chr)\fC [virtual]\fP"
.PP
Sets the currently selected character to \fCchr\fP. 
.PP
Definition at line 466 of file kcharselect.cpp.
.PP
References KCharSelectTable::setChar().
.SS "void KCharSelect::setTableNum (int tableNum)\fC [virtual]\fP"
.PP
Sets the currently displayed table to \fCtableNum\fP. 
.PP
Definition at line 473 of file kcharselect.cpp.
.PP
References KCharSelectTable::setTableNum(), and QSpinBox::setValue().
.PP
Referenced by KCharSelect().
.SS "virtual \fBQChar\fP KCharSelect::chr () const\fC [inline, virtual]\fP"
.PP
Returns the currently selected character. 
.PP
Definition at line 180 of file kcharselect.h.
.SS "virtual \fBQString\fP KCharSelect::font () const\fC [inline, virtual]\fP"
.PP
Returns the currently displayed font. 
.PP
Definition at line 185 of file kcharselect.h.
.SS "virtual int KCharSelect::tableNum () const\fC [inline, virtual]\fP"
.PP
Returns the currently displayed table. 
.PP
Definition at line 190 of file kcharselect.h.
.SS "virtual void KCharSelect::enableFontCombo (bool e)\fC [inline, virtual]\fP"
.PP
If \fCe\fP is set to true, the combobox which allows the user to select the font which should be displayed is enabled, else disabled. 
.PP
Definition at line 197 of file kcharselect.h.
.SS "virtual void KCharSelect::enableTableSpinBox (bool e)\fC [inline, virtual]\fP"
.PP
If \fCe\fP is set to true, the spinbox which allows the user to specify which characters of the font should be displayed, is enabled, else disabled. 
.PP
Definition at line 205 of file kcharselect.h.
.SS "virtual bool KCharSelect::isFontComboEnabled () const\fC [inline, virtual]\fP"
.PP
Returns wether the font combobox on the top is enabled or disabled. 
.PP
\fBSee also:\fP
.RS 4
\fBenableFontCombo()\fP 
.RE
.PP

.PP
Definition at line 213 of file kcharselect.h.
.SS "virtual bool KCharSelect::isTableSpinBoxEnabled () const\fC [inline, virtual]\fP"
.PP
Returns wether the table spinbox on the top is enabled or disabled. 
.PP
\fBSee also:\fP
.RS 4
\fBenableTableSpinBox()\fP 
.RE
.PP

.PP
Definition at line 221 of file kcharselect.h.

.SH "Author"
.PP 
Generated automatically by Doxygen for kdeui Library from the source code.
