Sonnet::Highlighter

Search for usage in LXR

#include <highlighter.h>

Inheritance diagram for Sonnet::Highlighter:

Signals

void activeChanged (const QString &description)
 

Public Slots

void setCurrentLanguage (const QString &language)
 
void slotAutoDetection ()
 
void slotRehighlight ()
 

Public Member Functions

 Highlighter (QPlainTextEdit *textEdit, const QColor &col=QColor())
 
 Highlighter (QTextEdit *textEdit, const QColor &col=QColor())
 
void addWordToDictionary (const QString &word)
 
bool autoDetectLanguageDisabled () const
 
bool automatic () const
 
bool checkerEnabledByDefault () const
 
QString currentLanguage () const
 
void ignoreWord (const QString &word)
 
bool isActive () const
 
bool isWordMisspelled (const QString &word)
 
void setActive (bool active)
 
void setAutoDetectLanguageDisabled (bool autoDetectDisabled)
 
void setAutomatic (bool automatic)
 
void setDocument (QTextDocument *document)
 
void setMisspelledColor (const QColor &color)
 
bool spellCheckerFound () const
 
QStringList suggestionsForWord (const QString &word, const QTextCursor &cursor, int max=10)
 
QStringList suggestionsForWord (const QString &word, int max=10)
 
- Public Member Functions inherited from QSyntaxHighlighter
 QSyntaxHighlighter (QObject *parent)
 
 QSyntaxHighlighter (QTextDocument *parent)
 
QTextDocumentdocument () const const
 
void rehighlight ()
 
void rehighlightBlock (const QTextBlock &block)
 
void setDocument (QTextDocument *doc)
 
- Public Member Functions inherited from QObject
 QObject (QObject *parent)
 
bool blockSignals (bool block)
 
const QObjectListchildren () const const
 
QMetaObject::Connection connect (const QObject *sender, const char *signal, const char *method, Qt::ConnectionType type) const const
 
void deleteLater ()
 
void destroyed (QObject *obj)
 
bool disconnect (const char *signal, const QObject *receiver, const char *method) const const
 
bool disconnect (const QObject *receiver, const char *method) const const
 
void dumpObjectInfo ()
 
void dumpObjectInfo () const const
 
void dumpObjectTree ()
 
void dumpObjectTree () const const
 
QList< QByteArraydynamicPropertyNames () const const
 
virtual bool event (QEvent *e)
 
findChild (const QString &name, Qt::FindChildOptions options) const const
 
QList< T > findChildren (const QRegExp &regExp, Qt::FindChildOptions options) const const
 
QList< T > findChildren (const QRegularExpression &re, Qt::FindChildOptions options) const const
 
QList< T > findChildren (const QString &name, Qt::FindChildOptions options) const const
 
bool inherits (const char *className) const const
 
void installEventFilter (QObject *filterObj)
 
bool isWidgetType () const const
 
bool isWindowType () const const
 
void killTimer (int id)
 
virtual const QMetaObjectmetaObject () const const
 
void moveToThread (QThread *targetThread)
 
QString objectName () const const
 
void objectNameChanged (const QString &objectName)
 
QObjectparent () const const
 
QVariant property (const char *name) const const
 
 Q_CLASSINFO (Name, Value)
 
 Q_DISABLE_COPY (Class)
 
 Q_DISABLE_COPY_MOVE (Class)
 
 Q_DISABLE_MOVE (Class)
 
 Q_EMIT Q_EMIT
 
 Q_ENUM (...)
 
 Q_ENUM_NS (...)
 
 Q_ENUMS (...)
 
 Q_FLAG (...)
 
 Q_FLAG_NS (...)
 
 Q_FLAGS (...)
 
 Q_GADGET Q_GADGET
 
 Q_INTERFACES (...)
 
 Q_INVOKABLE Q_INVOKABLE
 
 Q_NAMESPACE Q_NAMESPACE
 
 Q_NAMESPACE_EXPORT (EXPORT_MACRO)
 
 Q_OBJECT Q_OBJECT
 
 Q_PROPERTY (...)
 
 Q_REVISION Q_REVISION
 
 Q_SET_OBJECT_NAME (Object)
 
 Q_SIGNAL Q_SIGNAL
 
 Q_SIGNALS Q_SIGNALS
 
 Q_SLOT Q_SLOT
 
 Q_SLOTS Q_SLOTS
 
qFindChild (const QObject *obj, const QString &name)
 
QList< T > qFindChildren (const QObject *obj, const QRegExp &regExp)
 
QList< T > qFindChildren (const QObject *obj, const QString &name)
 
qobject_cast (const QObject *object)
 
qobject_cast (QObject *object)
 
 QT_NO_NARROWING_CONVERSIONS_IN_CONNECT QT_NO_NARROWING_CONVERSIONS_IN_CONNECT
 
void removeEventFilter (QObject *obj)
 
void setObjectName (const QString &name)
 
void setParent (QObject *parent)
 
bool setProperty (const char *name, const QVariant &value)
 
bool signalsBlocked () const const
 
int startTimer (int interval, Qt::TimerType timerType)
 
int startTimer (std::chrono::milliseconds time, Qt::TimerType timerType)
 
QThreadthread () const const
 

Protected Member Functions

bool eventFilter (QObject *o, QEvent *e) override
 
void highlightBlock (const QString &text) override
 
bool intraWordEditing () const
 
void setIntraWordEditing (bool editing)
 
virtual void setMisspelled (int start, int count)
 
virtual void unsetMisspelled (int start, int count)
 
- Protected Member Functions inherited from QSyntaxHighlighter
QTextBlock currentBlock () const const
 
int currentBlockState () const const
 
QTextBlockUserDatacurrentBlockUserData () const const
 
QTextCharFormat format (int position) const const
 
int previousBlockState () const const
 
void setCurrentBlockState (int newState)
 
void setCurrentBlockUserData (QTextBlockUserData *data)
 
void setFormat (int start, int count, const QColor &color)
 
void setFormat (int start, int count, const QFont &font)
 
void setFormat (int start, int count, const QTextCharFormat &format)
 
- Protected Member Functions inherited from QObject
virtual void childEvent (QChildEvent *event)
 
virtual void connectNotify (const QMetaMethod &signal)
 
virtual void customEvent (QEvent *event)
 
virtual void disconnectNotify (const QMetaMethod &signal)
 
bool isSignalConnected (const QMetaMethod &signal) const const
 
int receivers (const char *signal) const const
 
QObjectsender () const const
 
int senderSignalIndex () const const
 
virtual void timerEvent (QTimerEvent *event)
 

Additional Inherited Members

- Properties inherited from QObject
 objectName
 
- Static Public Member Functions inherited from QObject
QMetaObject::Connection connect (const QObject *sender, const char *signal, const QObject *receiver, const char *method, Qt::ConnectionType type)
 
QMetaObject::Connection connect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type)
 
QMetaObject::Connection connect (const QObject *sender, PointerToMemberFunction signal, const QObject *context, Functor functor, Qt::ConnectionType type)
 
QMetaObject::Connection connect (const QObject *sender, PointerToMemberFunction signal, const QObject *receiver, PointerToMemberFunction method, Qt::ConnectionType type)
 
QMetaObject::Connection connect (const QObject *sender, PointerToMemberFunction signal, Functor functor)
 
bool disconnect (const QMetaObject::Connection &connection)
 
bool disconnect (const QObject *sender, const char *signal, const QObject *receiver, const char *method)
 
bool disconnect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method)
 
bool disconnect (const QObject *sender, PointerToMemberFunction signal, const QObject *receiver, PointerToMemberFunction method)
 
QString tr (const char *sourceText, const char *disambiguation, int n)
 
QString trUtf8 (const char *sourceText, const char *disambiguation, int n)
 
- Public Attributes inherited from QObject
typedef QObjectList
 

Detailed Description

The Sonnet Highlighter class, used for drawing pretty red lines in text fields.

Definition at line 23 of file highlighter.h.

Constructor & Destructor Documentation

◆ Highlighter()

Sonnet::Highlighter::Highlighter ( QPlainTextEdit textEdit,
const QColor col = QColor() 
)
explicit

Highlighter.

Parameters
textEdit
coldefine spellchecking color.
Since
5.12

Definition at line 152 of file highlighter.cpp.

Member Function Documentation

◆ activeChanged

void Sonnet::Highlighter::activeChanged ( const QString description)
signal

Emitted when as-you-type spell checking is enabled or disabled.

Parameters
descriptionis a i18n description of the new state, with an optional reason

◆ addWordToDictionary()

void Sonnet::Highlighter::addWordToDictionary ( const QString word)

Adds the given word permanently to the dictionary.

It will never be marked as misspelled again, even after restarting the application.

Parameters
wordthe word which will be added to the dictionary
Since
4.1

Definition at line 479 of file highlighter.cpp.

◆ autoDetectLanguageDisabled()

bool Sonnet::Highlighter::autoDetectLanguageDisabled ( ) const

Returns whether the automatic language detection is disabled, overriding the Sonnet settings.

Returns
true if the automatic language detection is disabled
Since
5.71

Definition at line 201 of file highlighter.cpp.

◆ automatic()

bool Sonnet::Highlighter::automatic ( ) const

Returns the state of the automatic disabling of spell checking.

Returns
true if spell checking is automatically disabled if there's too many errors

Definition at line 196 of file highlighter.cpp.

◆ checkerEnabledByDefault()

bool Sonnet::Highlighter::checkerEnabledByDefault ( ) const

Return true if checker is enabled by default.

Since
4.5

Definition at line 524 of file highlighter.cpp.

◆ currentLanguage()

QString Sonnet::Highlighter::currentLanguage ( ) const

Returns the current language used for spell checking.

Returns
the language code for the current language.

Definition at line 385 of file highlighter.cpp.

◆ ignoreWord()

void Sonnet::Highlighter::ignoreWord ( const 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
wordthe word which will be ignored
Since
4.1

Definition at line 484 of file highlighter.cpp.

◆ isActive()

bool Sonnet::Highlighter::isActive ( ) const

Returns the state of spell checking.

Returns
true if spell checking is active
See also
setActive()

Definition at line 283 of file highlighter.cpp.

◆ isWordMisspelled()

bool Sonnet::Highlighter::isWordMisspelled ( const QString word)

Checks if a given word is marked as misspelled by the highlighter.

Parameters
wordthe word to be checked
Returns
true if the given word is misspelled.
Since
4.1

Definition at line 514 of file highlighter.cpp.

◆ setActive()

void Sonnet::Highlighter::setActive ( 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
activeif true, then spell checking is enabled
See also
isActive(), setAutomatic()

Definition at line 268 of file highlighter.cpp.

◆ setAutoDetectLanguageDisabled()

void Sonnet::Highlighter::setAutoDetectLanguageDisabled ( bool  autoDetectDisabled)

Sets whether to disable the automatic language detection.

Parameters
autoDetectDisabledif true, the language will not be detected automatically by the spell checker, even if the option is enabled in the Sonnet settings.
Since
5.71

Definition at line 228 of file highlighter.cpp.

◆ setAutomatic()

void Sonnet::Highlighter::setAutomatic ( bool  automatic)

Sets whether to automatically disable spell checking if there's too many errors.

Parameters
automaticif true, spell checking will be disabled if there's a significant amount of errors.

Definition at line 216 of file highlighter.cpp.

◆ setCurrentLanguage

void Sonnet::Highlighter::setCurrentLanguage ( const QString language)
slot

Set language to use for spell checking.

Parameters
languagethe language code for the new language to use.

Definition at line 390 of file highlighter.cpp.

◆ setDocument()

void Sonnet::Highlighter::setDocument ( QTextDocument document)

Set a new QTextDocument for this highlighter to operate on.

Parameters
documentthe new document to operate on.

Definition at line 529 of file highlighter.cpp.

◆ setMisspelledColor()

void Sonnet::Highlighter::setMisspelledColor ( const QColor color)

Sets the color in which the highlighter underlines misspelled words.

Since
4.2

Definition at line 519 of file highlighter.cpp.

◆ slotAutoDetection

void Sonnet::Highlighter::slotAutoDetection ( )
slot

Run auto detection, disabling spell checking if too many errors are found.

Definition at line 233 of file highlighter.cpp.

◆ slotRehighlight

void Sonnet::Highlighter::slotRehighlight ( )
slot

Force a new highlighting.

Definition at line 172 of file highlighter.cpp.

◆ spellCheckerFound()

bool Sonnet::Highlighter::spellCheckerFound ( ) const

Returns whether a spell checking backend with support for the currentLanguage was found.

Returns
true if spell checking is supported for the current language.

Definition at line 167 of file highlighter.cpp.

◆ suggestionsForWord() [1/2]

QStringList Sonnet::Highlighter::suggestionsForWord ( const QString word,
const QTextCursor cursor,
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
wordthe misspelled word
cursorthe cursor pointing to the beginning of that word. This is used to determine the language to use, when AutoDetectLanguage is enabled.
maxat 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
5.42

Definition at line 498 of file highlighter.cpp.

◆ suggestionsForWord() [2/2]

QStringList Sonnet::Highlighter::suggestionsForWord ( const 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
wordthe misspelled word
maxat 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

Definition at line 489 of file highlighter.cpp.


The documentation for this class was generated from the following files:
This file is part of the KDE documentation.
Documentation copyright © 1996-2023 The KDE developers.
Generated on Wed Sep 27 2023 03:55:20 by doxygen 1.8.17 written by Dimitri van Heesch, © 1997-2006

KDE's Doxygen guidelines are available online.