KDE 4.3 PyKDE API Reference
Highlighter Class Reference
from PyKDE4.kdeui import *
Inherits: QSyntaxHighlighter → QObject
Namespace: Sonnet
Detailed Description
The Sonnet Highlighter
Signals | |
| activeChanged (QString description) | |
| newSuggestions (QString originalWord, QStringList suggestions) | |
Methods | |
| __init__ (self, QTextEdit textEdit, QString configFile=QString(), QColor col=QColor()) | |
| __init__ (self, Sonnet.Highlighter a0) | |
| activeChanged (self, QString description) | |
| addWordToDictionary (self, QString word) | |
| bool | automatic (self) |
| QString | currentLanguage (self) |
| bool | eventFilter (self, QObject o, QEvent e) |
| highlightBlock (self, QString text) | |
| ignoreWord (self, QString word) | |
| bool | intraWordEditing (self) |
| bool | isActive (self) |
| bool | isWordMisspelled (self, QString word) |
| newSuggestions (self, QString originalWord, QStringList suggestions) | |
| setActive (self, bool active) | |
| setAutomatic (self, bool automatic) | |
| setCurrentLanguage (self, QString lang) | |
| setIntraWordEditing (self, bool editing) | |
| setMisspelled (self, int start, int count) | |
| setMisspelledColor (self, QColor color) | |
| slotAutoDetection (self) | |
| slotRehighlight (self) | |
| bool | spellCheckerFound (self) |
| QStringList | suggestionsForWord (self, QString word, int max=10) |
| unsetMisspelled (self, int start, int count) | |
Static Methods | |
| QStringList | personalWords () |
Method Documentation
| __init__ | ( | self, | ||
| Sonnet.Highlighter | a0 | |||
| ) |
| activeChanged | ( | self, | ||
| QString | description | |||
| ) |
Emitted when as-you-type spell checking is enabled or disabled.
- Parameters:
-
description is a i18n description of the new state, with an optional reason
- Signal syntax:
QObject.connect(source, SIGNAL("activeChanged(const QString&)"), target_slot)
| addWordToDictionary | ( | self, | ||
| QString | word | |||
| ) |
Adds the given word permanently to the dictionary. It will never be marked as misspelled again, even after restarting the application.
- Parameters:
-
word the word which will be added to the dictionary
- Since:
- 4.1
| bool automatic | ( | self ) |
| QString currentLanguage | ( | self ) |
| highlightBlock | ( | self, | ||
| QString | text | |||
| ) |
| ignoreWord | ( | self, | ||
| QString | word | |||
| ) |
Ignores the given word. This word will not be marked misspelled for this session. It will again be marked as misspelled when creating new highlighters.
- Parameters:
-
word the word which will be ignored
- Since:
- 4.1
| bool intraWordEditing | ( | self ) |
| bool isActive | ( | self ) |
Returns the state of spell checking.
- Returns:
- true if spell checking is active
- See also:
- setActive()
| bool isWordMisspelled | ( | self, | ||
| QString | word | |||
| ) |
Checks if a given word is marked as misspelled by the highlighter.
- Parameters:
-
word the word to be checked
- Returns:
- true if the given word is misspelled.
- Since:
- 4.1
| newSuggestions | ( | self, | ||
| QString | originalWord, | |||
| QStringList | suggestions | |||
| ) |
- Parameters:
-
originalWord missspelled word suggestions list of word which can replace missspelled word
- Deprecated:
- use isWordMisspelled() and suggestionsForWord() instead.
- Signal syntax:
QObject.connect(source, SIGNAL("newSuggestions(const QString&, const QStringList&)"), target_slot)
| QStringList personalWords | ( | ) |
| setActive | ( | self, | ||
| bool | active | |||
| ) |
Enable/Disable spell checking.
If active is true then spell checking is enabled; otherwise it is disabled. Note that you have to disable automatic (de)activation with setAutomatic() before you change the state of spell checking if you want to persistently enable/disable spell checking.
- Parameters:
-
active if true, then spell checking is enabled
- See also:
- isActive(), setAutomatic()
| setAutomatic | ( | self, | ||
| bool | automatic | |||
| ) |
| setCurrentLanguage | ( | self, | ||
| QString | lang | |||
| ) |
| setIntraWordEditing | ( | self, | ||
| bool | editing | |||
| ) |
| setMisspelled | ( | self, | ||
| int | start, | |||
| int | count | |||
| ) |
| setMisspelledColor | ( | self, | ||
| QColor | color | |||
| ) |
Sets the color in which the highlighter underlines misspelled words.
- Since:
- 4.2
| slotAutoDetection | ( | self ) |
| slotRehighlight | ( | self ) |
| bool spellCheckerFound | ( | self ) |
| QStringList suggestionsForWord | ( | self, | ||
| QString | word, | |||
| int | max=10 | |||
| ) |
Returns a list of suggested replacements for the given misspelled word. If the word is not misspelled, the list will be empty.
- Parameters:
-
word the misspelled word max at most this many suggestions will be returned. If this is -1, as many suggestions as the spell backend supports will be returned.
- Returns:
- a list of suggested replacements for the word
- Since:
- 4.1
| unsetMisspelled | ( | self, | ||
| int | start, | |||
| int | count | |||
| ) |
