QSyntaxHighlighter Class

멤버 함수 문서

[explicit] QSyntaxHighlighter::QSyntaxHighlighter(QObject *parent)

주어진 parent 으로 QSyntaxHighlighter를 생성합니다.

부모가 QTextEdit 인 경우 부모 문서에 구문 형광펜을 설치합니다. 지정된 QTextEdit 도 QSyntaxHighlighter의 소유자가 됩니다.

[explicit] QSyntaxHighlighter::QSyntaxHighlighter(QTextDocument *parent)

QSyntaxHighlighter를 생성하고 parent 에 설치합니다. 지정된 QTextDocument 도 QSyntaxHighlighter의 소유자가 됩니다.

[virtual noexcept] QSyntaxHighlighter::~QSyntaxHighlighter()

소멸자. 텍스트 문서에서 이 구문 형광펜을 제거합니다.

[protected] QTextBlock QSyntaxHighlighter::currentBlock() const

현재 텍스트 블록을 반환합니다.

[protected] int QSyntaxHighlighter::currentBlockState() const

현재 텍스트 블록의 상태를 반환합니다. 값을 설정하지 않으면 반환되는 값은 -1입니다.

setCurrentBlockState()도 참조하세요 .

[protected] QTextBlockUserData *QSyntaxHighlighter::currentBlockUserData() const

이전에 현재 텍스트 블록에 첨부된 QTextBlockUserData 객체를 반환합니다.

QTextBlock::userData() 및 setCurrentBlockUserData()도 참조하세요 .

QTextDocument *QSyntaxHighlighter::document() const

이 구문 형광펜이 설치된 QTextDocument 을 반환합니다.

setDocument()도 참조하세요 .

[protected] QTextCharFormat QSyntaxHighlighter::format(int position) const

구문 하이라이터의 현재 텍스트 블록 내부에 있는 position 형식을 반환합니다.

setFormat()도 참조하세요 .

[pure virtual protected] void QSyntaxHighlighter::highlightBlock(const QString &text)

지정된 텍스트 블록을 강조 표시합니다. 이 함수는 서식 있는 텍스트 엔진에서 필요할 때, 즉 변경된 텍스트 블록에서 호출됩니다.

고유한 구문 강조 표시를 제공하려면 QSyntaxHighlighter 를 서브클래싱하고 highlightBlock()을 다시 구현해야 합니다. 재구현할 때 블록의 text 을 파싱하고 필요한 만큼 자주 setFormat()을 호출하여 필요한 글꼴 및 색상 변경 사항을 적용해야 합니다. 예를 들어

void MyHighlighter::highlightBlock(const QString &text)
{
    QTextCharFormat myClassFormat;
    myClassFormat.setFontWeight(QFont::Bold);
    myClassFormat.setForeground(Qt::darkMagenta);

    QRegularExpression expression("\\bMy[A-Za-z]+\\b");
    QRegularExpressionMatchIterator i = expression.globalMatch(text);
    while (i.hasNext()) {
        QRegularExpressionMatch match = i.next();
        setFormat(match.capturedStart(), match.capturedLength(), myClassFormat);
    }
}

setCurrentBlockState(), currentBlockState() 및 previousBlockState()를 사용하여 여러 텍스트 블록에 걸쳐 있는 구문을 처리하는 예제는 Detailed Description 을 참조하세요.

previousBlockState(), setFormat() 및 setCurrentBlockState()도 참조하세요 .

[protected] int QSyntaxHighlighter::previousBlockState() const

구문 하이라이터의 현재 블록 이전 텍스트 블록의 끝 상태를 반환합니다. 이전에 설정한 값이 없는 경우 반환되는 값은 -1입니다.

highlightBlock() 및 setCurrentBlockState()도 참조하세요 .

[slot] void QSyntaxHighlighter::rehighlight()

강조 표시를 전체 문서에 다시 적용합니다.

rehighlightBlock()도 참조하세요 .

[slot] void QSyntaxHighlighter::rehighlightBlock(const QTextBlock &block)

주어진 QTextBlock block 에 강조 표시를 다시 적용합니다.

rehighlight()도 참조하세요 .

[protected] void QSyntaxHighlighter::setCurrentBlockState(int newState)

현재 텍스트 블록의 상태를 newState 로 설정합니다.

currentBlockState() 및 highlightBlock()도 참조하세요 .

[protected] void QSyntaxHighlighter::setCurrentBlockUserData(QTextBlockUserData *data)

주어진 data 을 현재 텍스트 블록에 첨부합니다. 소유권은 기본 텍스트 문서로 전달됩니다. 즉, 해당 텍스트 블록이 삭제되면 제공된 QTextBlockUserData 객체가 삭제됩니다.

QTextBlockUserData 사용자 정의 설정을 저장하는 데 사용할 수 있습니다. 구문 강조 표시의 경우 단락의 텍스트를 파싱하는 동안 알아낼 수 있는 정보를 위한 캐시 저장소로 특히 흥미롭습니다.

예를 들어 텍스트를 구문 분석하는 동안 발생하는 괄호 문자('{[(' 등)를 추적하고 그 상대적 위치와 실제 QChar 를 QTextBlockUserData 에서 파생된 간단한 클래스에 저장할 수 있습니다:

struct ParenthesisInfo
{
    QChar character;
    int position;
};

struct BlockData : public QTextBlockUserData
{
    QList<ParenthesisInfo> parentheses;
};

연결된 편집기에서 커서를 탐색하는 동안 현재 QTextBlock ( QTextCursor::block() 함수를 사용하여 검색)에 사용자 데이터 객체 집합이 있는지 물어보고 BlockData 객체로 캐스팅할 수 있습니다. 그러면 현재 커서 위치가 이전에 기록된 괄호 위치와 일치하는지 확인하고, 괄호 유형(열기 또는 닫기)에 따라 같은 레벨에서 다음 열기 또는 닫기 괄호를 찾을 수 있습니다.

이러한 방식으로 시각적 괄호 일치를 수행하고 현재 커서 위치에서 일치하는 괄호까지 강조 표시할 수 있습니다. 이렇게 하면 코드에서 누락된 괄호를 쉽게 발견하고 괄호 집약적인 코드를 편집할 때 해당 여는/닫는 괄호가 어디에 있는지 쉽게 찾을 수 있습니다.

currentBlockUserData() 및 QTextBlock::setUserData()도 참조하세요 .

void QSyntaxHighlighter::setDocument(QTextDocument *doc)

주어진 QTextDocument doc 에 구문 형광펜을 설치합니다. QSyntaxHighlighter 은 한 번에 하나의 문서에만 사용할 수 있습니다.

document()도 참조하세요 .

[protected] void QSyntaxHighlighter::setFormat(int start, int count, const QTextCharFormat &format)

이 함수는 구문 하이라이터의 현재 텍스트 블록(즉, highlightBlock() 함수에 전달되는 텍스트)에 적용됩니다.

지정된 format 은 start 위치의 텍스트에 count 문자 길이만큼 적용됩니다( count 이 0인 경우 아무 작업도 수행되지 않음). format 에 설정된 서식 속성은 표시 시점에 문서에 직접 저장된 서식 정보와 병합됩니다(예: 이전에 QTextCursor 의 함수로 설정한 것처럼). 문서 자체는 이 함수를 통해 설정된 서식에 의해 수정되지 않습니다.

format() 및 highlightBlock()도 참조하세요 .

[protected] void QSyntaxHighlighter::setFormat(int start, int count, const QColor &color)

이 함수는 과부하된 함수입니다.

지정된 color 은 start 위치에서 현재 텍스트 블록에 count 문자 길이만큼 적용됩니다.

현재 텍스트 블록의 다른 속성(예: 글꼴 및 배경색)은 기본값으로 재설정됩니다.

format() 및 highlightBlock()도 참조하세요 .

[protected] void QSyntaxHighlighter::setFormat(int start, int count, const QFont &font)

이 함수는 과부하된 함수입니다.

지정된 font 은 start 위치에서 현재 텍스트 블록에 count 문자 길이만큼 적용됩니다.

현재 텍스트 블록의 다른 속성(예: 글꼴 및 배경색)은 기본값으로 재설정됩니다.

format() 및 highlightBlock()도 참조하세요 .