kdeui Library API Documentation

KCharSelect Class Reference

A Widget which allows the user to select a character of a specified font in a table Character-Selection Widget. More...

#include <kcharselect.h>

Inheritance diagram for KCharSelect:

QVBox List of all members.

Public Methods

 KCharSelect (QWidget *parent, const char *name, const QString &font=QString::null, const QChar &chr= ' ', int tableNum=0)
virtual QSize sizeHint () const
virtual void setFont (const QString &font)
virtual void setChar (const QChar &chr)
virtual void setTableNum (int tableNum)
virtual QChar chr () const
virtual QString font () const
virtual int tableNum () const
virtual void enableFontCombo (bool e)
virtual void enableTableSpinBox (bool e)
virtual bool isFontComboEnabled () const
virtual bool isTableSpinBoxEnabled () const

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 whose characters should be displayed via setFont(). Using enableFontCombo() 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 enableTableSpinBox().

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.

To get the current selected character, use the chr() method. You can set the character which should be displayed with setChar() and the table number which should be displayed with setTableNum().

Version:
Id:
kcharselect.h,v 1.25 2003/08/21 09:51:37 coolo Exp
Author:
Reginald Stadlbauer <reggie@kde.org>

Definition at line 135 of file kcharselect.h.


Constructor & Destructor Documentation

KCharSelect::KCharSelect QWidget   parent,
const char *    name,
const QString   font = QString::null,
const QChar   chr = ' ',
int    tableNum = 0
 

Constructor.

font specifies which font should be displayed, chr which character should be selected and tableNum specifies the number of the table which should be displayed.

Definition at line 352 of file kcharselect.cpp.

References QString::isEmpty(), QLabel::setAlignment(), setFont(), QHBox::setSpacing(), setTableNum(), and KDialog::spacingHint().


Member Function Documentation

QSize KCharSelect::sizeHint   [virtual]
 

Reimplemented.

Definition at line 409 of file kcharselect.cpp.

void KCharSelect::setFont const QString   font [virtual]
 

Sets the font which is displayed to font.

Definition at line 415 of file kcharselect.cpp.

References QComboBox::setCurrentItem(), and KCharSelectTable::setFont().

Referenced by KCharSelect().

void KCharSelect::setChar const QChar   chr [virtual]
 

Sets the currently selected character to chr.

Definition at line 430 of file kcharselect.cpp.

References KCharSelectTable::setChar().

void KCharSelect::setTableNum int    tableNum [virtual]
 

Sets the currently displayed table to tableNum.

Definition at line 436 of file kcharselect.cpp.

References KCharSelectTable::setTableNum(), and QSpinBox::setValue().

Referenced by KCharSelect().

virtual QChar KCharSelect::chr   const [inline, virtual]
 

Returns the currently selected character.

Definition at line 174 of file kcharselect.h.

References KCharSelectTable::chr().

virtual QString KCharSelect::font   const [inline, virtual]
 

Returns the currently displayed font.

Definition at line 179 of file kcharselect.h.

References QComboBox::currentText().

virtual int KCharSelect::tableNum   const [inline, virtual]
 

Returns the currently displayed table.

Definition at line 184 of file kcharselect.h.

References QSpinBox::value().

virtual void KCharSelect::enableFontCombo bool    e [inline, virtual]
 

If 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 191 of file kcharselect.h.

virtual void KCharSelect::enableTableSpinBox bool    e [inline, virtual]
 

If 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 199 of file kcharselect.h.

virtual bool KCharSelect::isFontComboEnabled   const [inline, virtual]
 

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

See also:
enableFontCombo()

Definition at line 207 of file kcharselect.h.

virtual bool KCharSelect::isTableSpinBoxEnabled   const [inline, virtual]
 

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

See also:
enableTableSpinBox()

Definition at line 215 of file kcharselect.h.


The documentation for this class was generated from the following files:
KDE Logo
This file is part of the documentation for kdeui Library Version 3.2.2.
Documentation copyright © 1996-2004 the KDE developers.
Generated on Thu Apr 22 14:23:31 2004 by doxygen 1.2.18 written by Dimitri van Heesch, © 1997-2003