# class KCharSelect

###

Module | kdeui
Namespace |
Class | KCharSelect
Inherits | QWidget

Character selection widget

This widget allows the user to select a character of a specified font and to browse Unicode information

You can specify the font whose characters should be displayed via setCurrentFont(). Using the Controls argument in the contructor you can create a compact version of KCharSelect if there is not enough space and if you don't need all features.

KCharSelect displays one Unicode block at a time and provides categorized access to them. Unicode character names and further details, including cross references, are displayed. Additionally, there is a search to find characters.

To get the current selected character, use the currentChar() method. You can set the character which should be displayed with setCurrentChar().

Author Reginald Stadlbauer <reggie@kde.org> Author Daniel Laidig <d.laidig@gmx.de>

### enums

- Control { SearchLine, FontCombo, FontSize, BlockCombos, CharacterTable, DetailBrowser, AllGuiElements }
  typesafe object: Controls

enum details

### methods

- KCharSelect (parent, controls)

  returns ctor
  KDE 4.1.0 and later only

  Argument | Type | Default
  --- | --- | ---
  parent | QWidget |
  controls | KCharSelect.Controls | KCharSelect.AllGuiElements

  Constructor. controls can be used to show a custom set of widgets.

- KCharSelect (a0, a1)

  returns ctor
  before KDE 4.1.0 only

  Argument | Type | Default
  --- | --- | ---
  a0 | QWidget |
  a1 | KCharSelect.Controls | KCharSelect.AllGuiElements

- charSelected (c)

  returns Nothing
  SIGNAL ("charSelected (const QChar&)")

  Argument | Type | Default
  --- | --- | ---
  c | QChar |

  A character is selected to be inserted somewhere.

- currentChar ( )

  returns QChar

  Returns the currently selected character.

- currentCharChanged (c)

  returns Nothing
  SIGNAL ("currentCharChanged (const QChar&)")

  Argument | Type | Default
  --- | --- | ---
  c | QChar |

  The current character is changed.

- currentFont ( )

  returns QFont

  Returns the currently displayed font.

- currentFontChanged (_font)

  returns Nothing
  SIGNAL ("currentFontChanged (const QFont&)")

  Argument | Type | Default
  --- | --- | ---
  _font | QFont |

  A new font is selected or the font size changed.

- displayedChars ( )

  returns QList<QChar>

  Returns a list of currently displayed characters.

- displayedCharsChanged ( )

  returns Nothing
  SIGNAL ("displayedCharsChanged ()")

  The currently displayed characters are changed (search results or block).

- setCurrentChar (c)

  returns Nothing

  Argument | Type | Default
  --- | --- | ---
  c | QChar |

  Highlights the character c. If the character is not displayed, the block is changed.

- setCurrentFont (font)

  returns Nothing

  Argument | Type | Default
  --- | --- | ---
  font | QFont |

  Sets the font which is displayed to font

- sizeHint ( )

  returns QSize

  Reimplemented.

### enums - detail

- Control { SearchLine, FontCombo, FontSize, BlockCombos, CharacterTable, DetailBrowser, AllGuiElements }

  Shows the search widgets

  typesafe object: Controls

SearchLine - 0x01 -
FontCombo - 0x02 -
FontSize - 0x04 -
BlockCombos - 0x08 -
CharacterTable - 0x10 -
DetailBrowser - 0x20 -
AllGuiElements - 65535 -