QTextBlock Class

멤버 함수 문서

QTextBlock::QTextBlock(const QTextBlock &other)

other 텍스트 블록의 속성을 이 텍스트 블록으로 복사합니다.

QTextBlock::iterator QTextBlock::begin() const

텍스트 블록의 시작 부분을 가리키는 텍스트 블록 반복자를 반환합니다.

end()도 참조하십시오 .

QTextBlockFormat QTextBlock::blockFormat() const

블록별 속성을 설명하는 QTextBlockFormat 객체를 반환합니다.

charFormat()도 참조하십시오 .

int QTextBlock::blockFormatIndex() const

텍스트 블록의 형식에 대한 문서의 내부 블록 형식 목록에서 해당 인덱스를 반환합니다.

QTextDocument::allFormats()도 참조하십시오 .

int QTextBlock::blockNumber() const

이 블록의 번호를 반환하며, 블록이 유효하지 않은 경우 -1을 반환합니다.

QTextCursor::blockNumber()도 참조하십시오 .

QTextCharFormat QTextBlock::charFormat() const

블록의 문자 형식을 설명하는 ` QTextCharFormat `를 반환합니다. 블록의 문자 형식은 빈 블록에 텍스트를 삽입할 때 사용됩니다.

blockFormat()도 참조하십시오 .

int QTextBlock::charFormatIndex() const

텍스트 블록의 문자 형식에 해당하는, 문서의 내부 문자 형식 목록 내 인덱스를 반환합니다.

QTextDocument::allFormats()도 참조하십시오 .

void QTextBlock::clearLayout()

블록의 내용을 배치하고 표시하는 데 사용되는 레이아웃 객체( QTextLayout )를 지웁니다.

layout()도 참조하십시오 .

bool QTextBlock::contains(int position) const

지정된 ` position `가 텍스트 블록 내에 있는 경우 ` true `을 반환하고, 그렇지 않은 경우 ` false`을 반환합니다.

const QTextDocument *QTextBlock::document() const

이 텍스트 블록이 속한 텍스트 문서를 반환하거나, 해당 텍스트 블록이 어떤 문서에도 속하지 않는 경우 ` nullptr `를 반환합니다.

QTextBlock::iterator QTextBlock::end() const

텍스트 블록의 끝을 가리키는 텍스트 블록 반복자를 반환합니다.

begin(), next(), previous()도 참조하십시오 .

int QTextBlock::firstLineNumber() const

이 블록의 첫 번째 줄 번호를 반환하며, 블록이 유효하지 않은 경우 -1을 반환합니다. 레이아웃에서 이를 지원하는 경우가 아니라면, 줄 번호는 블록 번호와 동일합니다.

QTextBlock::blockNumber()도 참조하십시오 .

bool QTextBlock::isValid() const

이 텍스트 블록이 유효하면 ` true `를 반환하고, 그렇지 않으면 ` false`를 반환합니다.

bool QTextBlock::isVisible() const

블록이 표시되어 있으면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.

setVisible()도 참조하십시오 .

QTextLayout *QTextBlock::layout() const

블록의 내용을 레이아웃하고 표시하는 데 사용되는 ` QTextLayout ` 객체를 반환합니다.

반환된 ` QTextLayout ` 객체는 ` QAbstractTextDocumentLayout ` 하위 클래스의 `documentChanged` 구현에서만 수정할 수 있다는 점에 유의하십시오. 외부에서 적용된 모든 변경 사항은 정의되지 않은 동작을 유발합니다.

clearLayout()도 참조하십시오 .

int QTextBlock::length() const

블록의 길이를 문자 단위로 반환합니다.

참조: text(), charFormat(), blockFormat().

int QTextBlock::lineCount() const

줄 수를 반환합니다. 모든 문서 레이아웃이 이 기능을 지원하는 것은 아닙니다.

setLineCount()도 참조하십시오 .

QTextBlock QTextBlock::next() const

이 블록 다음의 문서 내 텍스트 블록을 반환하며, 이 블록이 마지막 블록인 경우에는 빈 텍스트 블록을 반환합니다.

다음 블록은 이 블록과 다른 프레임이나 테이블에 있을 수 있다는 점에 유의하십시오.

previous(), begin(), end()도 참조하십시오 .

int QTextBlock::position() const

문서 내에서 해당 블록의 첫 번째 문자가 위치한 인덱스를 반환합니다.

QTextBlock QTextBlock::previous() const

이 블록 바로 앞의 문서 내 텍스트 블록을 반환하며, 이 블록이 첫 번째 블록인 경우에는 빈 텍스트 블록을 반환합니다.

이전 블록은 이 블록과 다른 프레임이나 테이블에 위치할 수 있습니다.

next(), begin(), end()도 참조하십시오 .

int QTextBlock::revision() const

블록의 리비전을 반환합니다.

setRevision() 및 QTextDocument::revision()도 참조하십시오 .

void QTextBlock::setLineCount(int count)

줄 수를 count 로 설정합니다.

lineCount()도 참조하십시오 .

void QTextBlock::setRevision(int rev)

블록의 개정 버전을 rev 로 설정합니다.

revision() 및 QTextDocument::revision()도 참조하십시오 .

void QTextBlock::setUserData(QTextBlockUserData *data)

지정된 ` data ` 객체를 텍스트 블록에 연결합니다.

QTextBlockUserData 사용자 정의 설정을 저장하는 데 사용할 수 있습니다. 소유권은 기본 텍스트 문서로 전달되므로, 즉 해당 텍스트 블록이 삭제되면 제공된 ` QTextBlockUserData ` 객체도 함께 삭제됩니다. 사용자 데이터 객체는 실행 취소 기록에 저장되지 않으므로, 텍스트 블록 삭제를 실행 취소한 후에는 사용할 수 없게 됩니다.

예를 들어, IDE에서 프로그래밍 편집기를 작성할 때, 통합 디버거를 위해 사용자가 코드 내에서 시각적으로 중단점을 설정할 수 있도록 하고 싶을 수 있습니다. 프로그래밍 편집기에서 텍스트 한 줄은 일반적으로 하나의 ` QTextBlock`에 해당합니다. ` QTextBlockUserData ` 인터페이스를 사용하면 개발자가 각 ` QTextBlock`에 대한 데이터를 저장할 수 있습니다. 예를 들어, 사용자가 소스 코드의 어느 줄에 중단점을 설정했는지 등의 정보를 저장할 수 있습니다. 물론 이 정보를 외부에 저장할 수도 있지만, QTextDocument 내에 저장하면 사용자가 관련 줄을 삭제할 때 해당 정보도 자동으로 삭제됩니다. 이는 QTextFormat 의 사용자 정의 속성을 사용하지 않고도 QTextDocument 에 사용자 정의 정보를 저장하는 방법일 뿐이며, 사용자 정의 속성을 사용할 경우 실행 취소/다시 실행 스택에 영향을 미칠 수 있습니다.

userData()도 참조하십시오 .

void QTextBlock::setUserState(int state)

지정된 ` state ` 정수 값을 텍스트 블록에 저장합니다. 이는 예를 들어 구문 강조 표시기에서 텍스트 구문 분석 상태를 저장하는 데 유용할 수 있습니다.

userState()도 참조하십시오 .

void QTextBlock::setVisible(bool visible)

블록의 표시 상태를 ‘ visible ’로 설정합니다.

isVisible()도 참조하십시오 .

QString QTextBlock::text() const

블록의 내용을 일반 텍스트로 반환합니다.

length(), charFormat() 및 blockFormat()도 참조하십시오 .

Qt::LayoutDirection QTextBlock::textDirection() const

해결된 텍스트 방향을 반환합니다.

블록에 명시적인 방향이 설정되어 있지 않은 경우, 블록의 내용을 바탕으로 방향을 결정합니다. Qt::LeftToRight 또는 Qt::RightToLeft 중 하나를 반환합니다.

QTextFormat::layoutDirection(), QString::isRightToLeft(), Qt::LayoutDirection도 참조하십시오 .

QList<QTextLayout::FormatRange> QTextBlock::textFormats() const

블록의 텍스트 서식 옵션을 ` QTextCharFormat`의 연속된 범위 목록으로 반환합니다. 범위 경계 내에 텍스트를 삽입할 때 해당 범위의 문자 서식이 사용됩니다.

charFormat() 및 blockFormat()도 참조하십시오 .

QTextList *QTextBlock::textList() const

블록이 목록 항목을 나타내는 경우, 해당 항목이 속한 목록을 반환하고, 그렇지 않은 경우 ` nullptr`을 반환합니다.

QTextBlockUserData *QTextBlock::userData() const

setUserData() 또는 nullptr 를 통해 설정된 경우, QTextBlockUserData 객체에 대한 포인터를 반환합니다.

setUserData()도 참조하십시오 .

int QTextBlock::userState() const

setUserState()를 통해 이전에 설정된 정수 값을 반환하거나 -1을 반환합니다.

setUserState()도 참조하십시오 .

bool QTextBlock::operator!=(const QTextBlock &other) const

이 텍스트 블록이 ‘ other ’ 텍스트 블록과 다를 경우, ‘ true ’을 반환합니다.

bool QTextBlock::operator<(const QTextBlock &other) const

문서 내에서 이 텍스트 블록이 ‘ other ’ 텍스트 블록보다 앞에 위치할 경우, true 를 반환합니다.

QTextBlock &QTextBlock::operator=(const QTextBlock &other)

other 텍스트 블록을 이 텍스트 블록에 할당합니다.

bool QTextBlock::operator==(const QTextBlock &other) const

이 텍스트 블록이 ‘ other ’ 텍스트 블록과 동일할 경우 ‘ true ’를 반환합니다.