KDE 4.7 PyKDE API Reference
KCharSelect Class Reference
from PyKDE4.kdeui import *
Inherits: QWidget → QObject
Detailed Description
Character selection widget
This widget allows the user to select a character of a specified font and to browse Unicode information
"Character Selection Widget"
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().
Enumerations | |
| Control | { SearchLine, FontCombo, FontSize, BlockCombos, CharacterTable, DetailBrowser, HistoryButtons, AllGuiElements } |
Signals | |
| charSelected (QChar c) | |
| currentCharChanged (QChar c) | |
| currentFontChanged (QFont font) | |
| displayedCharsChanged () | |
Methods | |
| __init__ (self, QWidget parent, KCharSelect.Controls controls=KCharSelect.AllGuiElements) | |
| __init__ (self, QWidget parent, KActionCollection collection, KCharSelect.Controls controls=KCharSelect.AllGuiElements) | |
| QChar | currentChar (self) |
| QFont | currentFont (self) |
| [QChar] | displayedChars (self) |
| setCurrentChar (self, QChar c) | |
| setCurrentFont (self, QFont font) | |
| QSize | sizeHint (self) |
Signal Documentation
| charSelected | ( | QChar | c | |
| ) |
A character is selected to be inserted somewhere.
- Parameters:
-
c the selected character
- Signal syntax:
QObject.connect(source, SIGNAL("charSelected(const QChar&)"), target_slot)
| currentCharChanged | ( | QChar | c | |
| ) |
The current character is changed.
- Parameters:
-
c the new character
- Signal syntax:
QObject.connect(source, SIGNAL("currentCharChanged(const QChar&)"), target_slot)
| currentFontChanged | ( | QFont | font | |
| ) |
A new font is selected or the font size changed.
- Parameters:
-
font the new font
- Signal syntax:
QObject.connect(source, SIGNAL("currentFontChanged(const QFont&)"), target_slot)
| displayedCharsChanged | ( | ) |
The currently displayed characters are changed (search results or block).
- Signal syntax:
QObject.connect(source, SIGNAL("displayedCharsChanged()"), target_slot)
Method Documentation
| __init__ | ( | self, | ||
| QWidget | parent, | |||
| KCharSelect.Controls | controls=KCharSelect.AllGuiElements | |||
| ) |
- Deprecated:
| __init__ | ( | self, | ||
| QWidget | parent, | |||
| KActionCollection | collection, | |||
| KCharSelect.Controls | controls=KCharSelect.AllGuiElements | |||
| ) |
Constructor. controls can be used to show a custom set of widgets.
The widget uses the following actions: - KStandardActions.find() (edit_find) - KStandardActions.back() (go_back) - KStandardActions.forward() (go_forward)
If you provide a KActionCollection, this will be populated with the above actions, which you can then manually trigger or place in menus and toolbars.
- Parameters:
-
parent the parent widget for this KCharSelect (see QWidget documentation) collection if this is not null, KCharSelect will place its actions into this collection controls selects the visible controls on the KCharSelect widget
- Since:
- 4.2
| QChar currentChar | ( | self ) |
Returns the currently selected character.
| QFont currentFont | ( | self ) |
Returns the currently displayed font.
| [QChar] displayedChars | ( | self ) |
Returns a list of currently displayed characters.
| setCurrentChar | ( | self, | ||
| QChar | c | |||
| ) |
Highlights the character c. If the character is not displayed, the block is changed.
- Parameters:
-
c the character to highlight
| setCurrentFont | ( | self, | ||
| QFont | font | |||
| ) |
Sets the font which is displayed to font
- Parameters:
-
font the display font for the widget
| QSize sizeHint | ( | self ) |
Reimplemented.
Enumeration Documentation
| Control |
Flags to set the shown widgets
- Enumerator:
-
SearchLine = 0x01 FontCombo = 0x02 FontSize = 0x04 BlockCombos = 0x08 CharacterTable = 0x10 DetailBrowser = 0x20 HistoryButtons = 0x40 AllGuiElements = 65535
