Highlighter Class Reference
from PyKDE4.kdeui import *
Inherits: QSyntaxHighlighter → QObject
Namespace: Sonnet
Detailed Description
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) |
| | addWordToDictionary (self, QString word) |
| bool | automatic (self) |
| bool | checkerEnabledByDefault (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) |
| | 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 () |
Signal Documentation
| activeChanged |
( |
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)
| newSuggestions |
( |
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)
Method Documentation
| __init__ |
( |
self, |
|
|
|
QTextEdit |
textEdit, |
|
|
QString |
configFile=QString(), |
|
|
QColor |
col=QColor() |
|
) |
|
|
|
| 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 checkerEnabledByDefault |
( |
|
self ) |
|
Return true if checker is enabled by default
- Since:
- 4.5
| QString currentLanguage |
( |
|
self ) |
|
| bool eventFilter |
( |
self, |
|
|
|
QObject |
o, |
|
|
QEvent |
e |
|
) |
|
|
|
| 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 ) |
|
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
| 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 ) |
|
| 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 |
|
) |
|
|
|
Static Method Documentation
| QStringList personalWords |
( |
|
) |
|