Редактирование: Syntax Highlighting in QTextEdit


__NOTOC__

<div class="introduction">
The appropriate use of colors and fonts to highlight the differentelements of programming and markup languages helpsthe brain to grasp document structures. By flaggingsyntax errors, interactive syntax highlighting also helpsreduce the time spent in the "compile, run, test" cycle.Highlighting can even be used to flag spelling mistakes in textdocuments. With Qt, adding syntax highlighting to a QTextEdit is veryeasy, as this article will demonstrate.

*[[#subclassingqsyntaxhighlighter | Subclassing QSyntaxHighlighter]]
*[[#keepingtrackofstateinformation | Keeping Track of State Information]]
*[[#example | Example: A Basic HTML Highlighter]]
*[[#summary | Summary]]
</div>
Qt 3.1 introduced [[Qt:Документация_4.3.2/qsyntaxhighlighter  | QSyntaxHighlighter]]as an abstract base class to provide syntax highlighting to a[[Qt:Документация_4.3.2/qtextedit  | QTextEdit]]. In Qt 4, the class was moved to the<tt>Qt3Support</tt> library, and a new[[Qt:Документация_4.3.2/qsyntaxhighlighter  | QSyntaxHighlighter]] class took its place.The new [[Qt:Документация_4.3.2/qsyntaxhighlighter  | QSyntaxHighlighter]] class isbased on Qt 4's new rich text engine and works on arbitrary[[Qt:Документация_4.3.2/qtextdocument  | QTextDocument]] objects. In this article, wewill concentrate on the new class.
<div id="subclassingqsyntaxhighlighter"></div>
===Subclassing QSyntaxHighlighter===

Adding syntax highlighting to a [[Qt:Документация_4.3.2/qtextedit  | QTextEdit]]involves subclassing [[Qt:Документация_4.3.2/qsyntaxhighlighter  | QSyntaxHighlighter]],reimplementing the <tt>highlightBlock()</tt> function, and instantiating the[[Qt:Документация_4.3.2/qsyntaxhighlighter  | QSyntaxHighlighter]] subclass withthe [[Qt:Документация_4.3.2/qtextedit  | QTextEdit]]'s underlying[[Qt:Документация_4.3.2/qtextdocument  | QTextDocument]] (returned by[http://www.crossplatform.ru/documentation/qtdoc4.3/qtextedit.php#document QTextEdit::document()]) as the parent.

[[Qt:Документация_4.3.2/qtextdocument  | QTextDocument]] will then call<tt>highlightBlock()</tt> for every line in the document as necessary.In the <tt>highlightBlock()</tt> reimplementation, we can call<tt>setFormat()</tt> to set the formatting of the different elements in theline. The following code snippet shows a trivial reimplementation of<tt>highlightBlock()</tt>, where we set every non-alphanumeric character tobe green:
<source lang="cpp-qt">
void MyHighlighter::highlightBlock(const QString &amp;text)
{
    for (int i = 0; i < text.length(); ++i) {
        if (!text.at(i).isLetterOrNumber())
            setFormat(i, 1, Qt::green);
    }
}
</source> 
The [http://www.crossplatform.ru/documentation/qtdoc4.3/qsyntaxhighlighter.php#setFormat QSyntaxHighlighter::setFormat()] function exists in threeversions, with the following signatures:
<source lang="cpp-qt">
void setFormat(int start, int count, const QTextCharFormat &amp;format);
void setFormat(int start, int count, const QColor &amp;color);
void setFormat(int start, int count, const QFont &amp;font);
</source> 
The <tt>start</tt> parameter indicates the start index in the <tt>text</tt>string; <tt>count</tt>, the number of characters. The third parameter canbe a [[Qt:Документация_4.3.2/qtextcharformat  | QTextCharFormat]] object, a[[Qt:Документация_4.3.2/qcolor  | QColor]], or a [[Qt:Документация_4.3.2/qfont  | QFont]].
<div id="keepingtrackofstateinformation"></div>
===Keeping Track of State Information===

In the trivial example above, the highlighting of each line could bedone independently of other lines. For most realistic languages, thisassumption does not hold. Take a C++ syntax highlighter as anexample. If the user opens a C-style comment on line 10 and closes iton line 15, the lines in between should be highlighted differentlythan if they were not part of a comment.

[[Qt:Документация_4.3.2/qsyntaxhighlighter  | QSyntaxHighlighter]] makes this possiblethrough its "state" mechanism. When we finish highlighting a line, we canassociate a state with the line (e.g., "Inside C-Style Comment"), which we canretrieve when we start highlighting the following line. The state isstored as an <tt>int</tt>.

The following code shows how to handle both C-style and C++-stylecomments in a C++ syntax highlighter. The highlighter has twostates: <tt>NormalState</tt> and <tt>InsideCStyleComment</tt>. We define<tt>NormalState</tt> as equal to -1 because[[Qt:Документация_4.3.2/qsyntaxhighlighter  | QSyntaxHighlighter]]'s stateat the top of the document is always -1.
<source lang="cpp-qt">
void CppHighlighter::highlightBlock(const QString &amp;text)
{
    enum { NormalState = -1, InsideCStyleComment };

    int state = previousBlockState();
    int start = 0;

    for (int i = 0; i < text.length(); ++i) {

        if (state == InsideCStyleComment) {
            if (text.mid(i, 2) == "*/") {
                state = NormalState;
                setFormat(start, i - start + 2, Qt::blue);
            }
        } else {
            if (text.mid(i, 2) == "//") {
                setFormat(i, text.length() - i, Qt::red);
                break;
            } else if (text.mid(i, 2) == "/*") {
                start = i;
                state = InsideCStyleComment;
            }
        }
    }
    if (state == InsideCStyleComment)
        setFormat(start, text.length() - start, Qt::blue);

    setCurrentBlockState(state);
}
</source> 
At the beginning of the function, we retrieve the previous line'sstate using [http://www.crossplatform.ru/documentation/qtdoc4.3/qsyntaxhighlighter.php#previousBlockState QSyntaxHighlighter::previousBlockState()]and store it in the <tt>state</tt> local variable. Then we iterate over thecharacters in <tt>text</tt> and update the state as necessary when we meet<tt>/*</tt> or <tt>*/</tt>.

We also highlight <tt>//</tt> comments. Since these comments cannot spanmultiple lines, we don't need a separate state for these. At the endof the function, we call <tt>setCurrentBlockState()</tt>  with the newstate so that it's available when highlighting the next line.

[[Image:qq21-cpp-highlight.png|center]]

In addition to keeping track of the state, we also call<tt>setFormat()</tt> to show C-style comments in blue and C++-stylecomments in red.

The ''Syntax Highlighter'' example provided with Qt 4.2 alsodemonstrates many of the same principles as this example, but relies on regularexpressions to locate different tokens in C++ source code.The state-based approach used by[[Qt:Документация_4.3.2/qsyntaxhighlighter  | QSyntaxHighlighter]] allows for a certaindegree of flexibility in the way highlighters are implemented.
<div id="example"></div>
===Example: A Basic HTML Highlighter===

We will now show the full code for a slightly more complexexample &endash; a class to highlight HTML entities (e.g., <tt>&amp;mdash;</tt>),tags (e.g., <tt><p></tt>), and comments (e.g., <tt><!-- sep--></tt>).

In addition to reimplementing <tt>highlightBlock()</tt>, as in the previous example,we also provide functions to let the user of the class specify which colors touse for the various HTML constructs.Let's start with the class definition.
<source lang="cpp-qt">
class HtmlHighlighter : public QSyntaxHighlighter
{
    Q_OBJECT

public:
    enum Construct {
        Entity,
        Tag,
        Comment,
        LastConstruct = Comment
    };

    HtmlHighlighter(QTextDocument *document);

    void setFormatFor(Construct construct,
                      const QTextCharFormat &amp;format);
    QTextCharFormat formatFor(Construct construct) const
        { return m_formats[construct]; }

protected:
    enum State {
        NormalState = -1,
        InComment,
        InTag
    };

    void highlightBlock(const QString &amp;text);

private:
    QTextCharFormat m_formats[LastConstruct + 1];
};
</source> 
The <tt>setFormatFor()</tt> and <tt>formatFor()</tt> functions let the useraccess the formatting used for the supported HTML constructs(entities, tags, and comments). The <tt>State</tt> enum specifies thethree states in which our HTML parser can be in after parsing oneline. The <tt>NormalState</tt> is set to -1, the default state in[[Qt:Документация_4.3.2/qsyntaxhighlighter  | QSyntaxHighlighter]].

[[Image:qq21-html-highlight.png|center]]

Let's review the implementation, starting with the constructor:
<source lang="cpp-qt">
HtmlHighlighter::HtmlHighlighter(QTextDocument *document)
    : QSyntaxHighlighter(document)
{
    QTextCharFormat entityFormat;
    entityFormat.setForeground(QColor(0, 128, 0));
    entityFormat.setFontWeight(QFont::Bold);
    setFormatFor(Entity, entityFormat);

    QTextCharFormat tagFormat;
    tagFormat.setForeground(QColor(192, 16, 112));
    tagFormat.setFontWeight(QFont::Bold);
    setFormatFor(Tag, tagFormat);

    QTextCharFormat commentFormat;
    commentFormat.setForeground(QColor(128, 10, 74));
    commentFormat.setFontItalic(true);
    setFormatFor(Comment, commentFormat);
}
</source> 
In the constructor, we set the default formats for HTML entities,tags, and comments. A format is represented by a[[Qt:Документация_4.3.2/qtextcharformat  | QTextCharFormat]]object. We specify the properties that we want for the highlightedtext &endash; the foreground color, the font width (bold or not), theunderline style (single, "wiggly"), etc. &endash; and these are applied ontop of the existing attributes of the[[Qt:Документация_4.3.2/qtextdocument  | QTextDocument]].
<source lang="cpp-qt">
void HtmlHighlighter::setFormatFor(Construct construct,
                            const QTextCharFormat &amp;format)
{
    m_formats[construct] = format;
    rehighlight();
}
</source> 
The <tt>setFormatFor()</tt> function sets the[[Qt:Документация_4.3.2/qtextcharformat  | QTextCharFormat]] for agiven HTML construct. We call[http://www.crossplatform.ru/documentation/qtdoc4.3/qsyntaxhighlighter.php#rehighlight QSyntaxHighlighter::rehighlight()]to immediately apply the change on the whole document.

The only function left to review is <tt>highlightBlock()</tt>, which isreimplemented from [[Qt:Документация_4.3.2/qsyntaxhighlighter  | QSyntaxHighlighter]].It's a rather big function, so we will study it chuck by chuck.
<source lang="cpp-qt">
void HtmlHighlighter::highlightBlock(const QString &amp;text)
{
    int state = previousBlockState();
    int len = text.length();
    int start = 0;
    int pos = 0;
</source> 
Like in the C++ highlighter example, we start by retrieving theprevious line's state using <tt>previousBlockState()</tt>. Inside theloop, we switch on the current state, interpreting charactersdifferently depending on whether we are inside a tag or a comment.
<source lang="cpp-qt">
  while (pos < len) {
        switch (state) {
        case NormalState:
        default:
            while (pos < len) {
                QChar ch = text.at(pos);
                if (ch == '<') {
                    if (text.mid(pos, 4) == "<!--") {
                        state = InComment;
                    } else {
                        state = InTag;
                    }
                    break;
                } else if (ch == '&amp;') {
                    start = pos;
                    while (pos < len
                           &amp;&amp; text.at(pos++) != ';')
                        ;
                    setFormat(start, pos - start,
                              m_formats[Entity]);
                } else {
                    ++pos;
                }
            }
            break;
</source> 
For the <tt>NormalState</tt>, we advance looking for a left angle (<tt><</tt>)or an ampersand (<tt>&amp;</tt>) character.

If we hit a left angle (<tt><</tt>), we enter the <tt>InTag</tt> or<tt>InComment</tt> state. If we hit an ampersand (<tt>&amp;</tt>), we dealwith the HTML entity on the spot, formatting it as required. (We couldhave used an <tt>InEntity</tt> state instead and handled it in its own<tt>switch</tt> case, but it isn't necessary because entities, unliketags and comments, cannot span multiple lines.)
<source lang="cpp-qt">
      case InComment:
            start = pos;
            while (pos < len) {
                if (text.mid(pos, 3) == "-->") {
                    pos += 3;
                    state = NormalState;
                    break;
                } else {
                    ++pos;
                }
            }
            setFormat(start, pos - start,
                      m_formats[Comment]);
            break;
</source> 
If we are inside a comment, we look for the closing <tt>--></tt> token. Ifwe find it, we enter the <tt>NormalState</tt>. In all cases, we highlightthe comment using[http://www.crossplatform.ru/documentation/qtdoc4.3/qsyntaxhighlighter.php#setFormat QSyntaxHighlighter::setFormat()].
<source lang="cpp-qt">
      case InTag:
            QChar quote = QChar::Null;
            start = pos;
            while (pos < len) {
                QChar ch = text.at(pos);
                if (quote.isNull()) {
                    if (ch == '\" || ch == '"') {
                        quote = ch;
                    } else if (ch == '>') {
                        ++pos;
                        state = NormalState;
                        break;
                    }
                } else if (ch == quote) {
                    quote = QChar::Null;
                }
                ++pos;
            }
            setFormat(start, pos - start, m_formats[Tag]);
        }
    }
</source> 
If we are inside a tag, we look for the <tt>></tt> token, skipping anyquoted attribute value (e.g., <tt><img alt=">>>>"></tt>). Ifwe find a <tt>></tt>, we enter the <tt>NormalState</tt>. In all cases,we highlight the tag.
<source lang="cpp-qt">
  setCurrentBlockState(state);
}
</source> 
At the end of the function, we store the current state so that thenext line can start in the correct state.

To use the highlighter, we simply need to instantiate it witha [[Qt:Документация_4.3.2/qtextdocument  | QTextDocument]] as the parent. For example:
<source lang="cpp-qt">
int main(int argc, char *argv[])
{
    QApplication app(argc, argv);
    QTextEdit editor;
    HtmlSyntaxHighlighter highlighter(editor.document());
    editor.show();
    return app.exec();
}
</source> 
If we wanted to improve the HTML highlighter further, we would usedifferent highlighting for the tag delimiters, names, attributes, andattribute values.
<div id="summary"></div>
===Summary===

[[Qt:Документация_4.3.2/qsyntaxhighlighter  | QSyntaxHighlighter]] makes it very easyto write interactive syntax highlighters. When the user edits the text, itonly rehighlights the parts of the text that need to be updated. For example,if the user modifies line 3 of a 2,000-line document,[[Qt:Документация_4.3.2/qsyntaxhighlighter  | QSyntaxHighlighter]]will start by rehighlighting line 3, and will continue only if the stateassociated with line 3 has changed as a result, stopping at the first linefor which the old and new states are identical.

[[Image:qq21-syntaxhighlighter-graphicsview.png|center]]

In Qt 4, [[Qt:Документация_4.3.2/qsyntaxhighlighter  | QSyntaxHighlighter]] isn'trestricted to [[Qt:Документация_4.3.2/qtextedit  | QTextEdit]]. It can be used withany editor based on [[Qt:Документация_4.3.2/qtextdocument  | QTextDocument]], includingthe new [[Qt:Документация_4.3.2/qgraphicstextitem  | QGraphicsTextItem]] for[[Qt:Документация_4.3.2/qgraphicsview  | QGraphicsView]], making it possible toprovide highlighted text editing facilities for transformed text.

The new[[Qt:Документация_4.3.2/qsyntaxhighlighter  | QSyntaxHighlighter]] is also extremelyflexible when it comes to handling character formats, thanks to the powerful[[Qt:Документация_4.3.2/qtextcharformat  | QTextCharFormat]] class.


[[Категория:Qt_Издания]]