QTextCursor Class

멤버 함수 문서

QTextCursor::QTextCursor()

널 커서를 생성합니다.

[explicit] QTextCursor::QTextCursor(QTextDocument *document)

document 의 시작 부분을 가리키는 커서를 생성합니다.

[explicit] QTextCursor::QTextCursor(QTextFrame *frame)

frame 의 시작 부분을 가리키는 커서를 생성합니다.

[explicit] QTextCursor::QTextCursor(const QTextBlock &block)

block 의 시작 부분을 가리키는 커서를 생성합니다.

QTextCursor::QTextCursor(const QTextCursor &cursor)

cursor 의 복사본인 새 커서를 생성합니다.

[noexcept] QTextCursor::~QTextCursor()

QTextCursor 를 파괴합니다.

int QTextCursor::anchor() const

선택 영역이 없는 경우 position()은 선택 영역의 한쪽 끝을 표시하고 anchor()는 다른 쪽 끝을 표시하는 경우를 제외하고 position()와 동일하게 앵커 위치를 반환합니다. 커서 위치와 마찬가지로 앵커 위치는 문자 사이입니다.

position(), setPosition(), movePosition(), selectionStart() 및 selectionEnd()도 참조하세요 .

bool QTextCursor::atBlockEnd() const

커서가 블록 끝에 있으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

atBlockStart() 및 atEnd()도 참조하세요 .

bool QTextCursor::atBlockStart() const

커서가 블록의 시작 부분에 있으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

atBlockEnd() 및 atStart()도 참조하세요 .

bool QTextCursor::atEnd() const

커서가 문서 끝에 있으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

atStart() 및 atBlockEnd()도 참조하세요 .

bool QTextCursor::atStart() const

커서가 문서의 시작 부분에 있으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

atBlockStart() 및 atEnd()도 참조하세요 .

void QTextCursor::beginEditBlock()

실행 취소/다시 실행 관점에서 단일 작업으로 표시되어야 하는 문서에 대한 편집 작업 블록의 시작을 나타냅니다.

예를 들어

QTextCursor cursor(textDocument);
cursor.beginEditBlock();
cursor.insertText("Hello");
cursor.insertText("World");
cursor.endEditBlock();

textDocument->undo();

undo()를 호출하면 두 삽입이 모두 실행 취소되어 "World"와 "Hello"가 모두 제거됩니다.

startEditBlock과 endEditBlock 에 대한 호출을 중첩할 수 있습니다. 가장 위에 있는 쌍에 따라 실행 취소/다시 실행 작업의 범위가 결정됩니다.

endEditBlock()도 참조하세요 .

QTextBlock QTextCursor::block() const

커서가 포함된 블록을 반환합니다.

QTextCharFormat QTextCursor::blockCharFormat() const

커서가 있는 블록의 블록 문자 형식을 반환합니다.

블록 문자 형식은 빈 블록의 시작 부분에 텍스트를 삽입할 때 사용되는 형식입니다.

setBlockCharFormat()도 참조하세요 .

QTextBlockFormat QTextCursor::blockFormat() const

커서가 있는 블록의 블록 형식을 반환합니다.

setBlockFormat() 및 charFormat()도 참조하세요 .

int QTextCursor::blockNumber() const

커서가 위치한 블록의 번호를 반환하거나 커서가 유효하지 않은 경우 0을 반환합니다.

이 함수는 표나 프레임과 같은 복잡한 개체가 없는 문서에서만 의미가 있습니다.

QTextCharFormat QTextCursor::charFormat() const

커서 바로 앞의 문자 position()의 형식을 반환합니다. 커서가 비어 있지 않은 텍스트 블록의 시작 부분에 위치한 경우 커서 바로 뒤에 있는 문자의 형식이 반환됩니다.

setCharFormat(), insertText() 및 blockFormat()도 참조하세요 .

void QTextCursor::clearSelection()

앵커를 커서 위치로 설정하여 현재 선택을 지웁니다.

선택 영역의 텍스트는 삭제되지 않습니다.

removeSelectedText() 및 hasSelection()도 참조하세요 .

int QTextCursor::columnNumber() const

포함된 줄 내에서 커서의 위치를 반환합니다.

이 값은 블록(즉, 단락)이 아니라 줄 바꿈된 줄을 기준으로 한 열 번호라는 점에 유의하세요.

대신 positionInBlock()를 호출하는 것이 좋습니다.

positionInBlock()도 참조하세요 .

QTextList *QTextCursor::createList(const QTextListFormat &format)

주어진 format 으로 새 목록을 만들어 반환하고 현재 단락을 커서가 첫 번째 목록 항목에 있는 상태로 만듭니다.

insertList() 및 currentList()도 참조하세요 .

QTextList *QTextCursor::createList(QTextListFormat::Style style)

이 함수는 오버로드된 함수입니다.

주어진 style 으로 새 목록을 생성하고 반환하여 커서의 현재 단락을 첫 번째 목록 항목으로 만듭니다.

사용할 스타일은 QTextListFormat::Style 열거형에 의해 정의됩니다.

insertList() 및 currentList()도 참조하세요 .

QTextFrame *QTextCursor::currentFrame() const

현재 프레임에 대한 포인터를 반환합니다. 커서가 유효하지 않은 경우 nullptr 를 반환합니다.

insertFrame()도 참조하세요 .

QTextList *QTextCursor::currentList() const

커서 position()가 목록의 일부인 블록 안에 있는 경우 현재 목록을 반환하고, 그렇지 않으면 nullptr 을 반환합니다.

insertList() 및 createList()도 참조하세요 .

QTextTable *QTextCursor::currentTable() const

커서 position()가 테이블의 일부인 블록 안에 있는 경우 현재 테이블에 대한 포인터를 반환하고, 그렇지 않으면 nullptr 을 반환합니다.

insertTable()도 참조하세요 .

void QTextCursor::deleteChar()

선택한 텍스트가 없으면 현재 커서 위치의 문자를 삭제하고, 그렇지 않으면 선택한 텍스트를 삭제합니다.

deletePreviousChar(), hasSelection() 및 clearSelection()도 참조하세요 .

void QTextCursor::deletePreviousChar()

선택한 텍스트가 없는 경우 현재 커서 위치 앞의 문자를 삭제하고, 그렇지 않으면 선택한 텍스트를 삭제합니다.

deleteChar(), hasSelection() 및 clearSelection()도 참조하세요 .

QTextDocument *QTextCursor::document() const

이 커서가 연결된 문서를 반환합니다.

void QTextCursor::endEditBlock()

실행 취소/다시 실행 관점에서 단일 작업으로 표시되어야 하는 문서에 대한 편집 작업 블록의 끝을 나타냅니다.

beginEditBlock()도 참조하세요 .

bool QTextCursor::hasComplexSelection() const

커서에 selectionStart() ~ selectionEnd() 범위가 아닌 선택 영역이 포함된 경우 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

복잡한 선택은 표에서 두 개 이상의 셀에 걸쳐 있는 선택이며, 범위는 selectedTableCells()로 지정합니다.

bool QTextCursor::hasSelection() const

커서에 선택 항목이 포함되어 있으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

void QTextCursor::insertBlock()

현재 blockFormat() 및 charFormat()와 함께 커서 position()에 새 빈 블록을 삽입합니다.

setBlockFormat()도 참조하세요 .

void QTextCursor::insertBlock(const QTextBlockFormat &format)

이 함수는 오버로드된 함수입니다.

커서 position()에 블록 형식 format 및 현재 charFormat()를 블록 문자 형식으로 새 빈 블록을 삽입합니다.

setBlockFormat()도 참조하세요 .

void QTextCursor::insertBlock(const QTextBlockFormat &format, const QTextCharFormat &charFormat)

이 함수는 오버로드된 함수입니다.

커서 position()에 블록 형식 format 및 블록 문자 형식 charFormat 으로 새 빈 블록을 삽입합니다.

setBlockFormat()도 참조하세요 .

void QTextCursor::insertFragment(const QTextDocumentFragment &fragment)

현재 position()에 fragment 텍스트를 삽입합니다.

QTextFrame *QTextCursor::insertFrame(const QTextFrameFormat &format)

현재 커서 position()에 주어진 format 으로 프레임을 삽입하고 커서 position()를 프레임 내부로 이동한 다음 프레임을 반환합니다.

커서가 선택 영역을 가리키고 있으면 전체 선택 영역이 프레임 내부로 이동합니다.

hasSelection()도 참조하세요 .

void QTextCursor::insertHtml(const QString &html)

현재 position()에 html 텍스트를 삽입합니다. 텍스트는 HTML로 해석됩니다.

void QTextCursor::insertImage(const QTextImageFormat &format)

현재 position()에 format 에 정의된 이미지를 삽입합니다.

void QTextCursor::insertImage(const QString &name)

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

현재 position()에 주어진 name 으로 이미지를 삽입하는 편리한 방법입니다.

QImage img;
textDocument->addResource(QTextDocument::ImageResource, QUrl("myimage"), img);
cursor.insertImage("myimage");

void QTextCursor::insertImage(const QImage &image, const QString &name = QString())

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

현재 position()에 선택 사항인 name 과 함께 주어진 image 을 삽입하는 편의 함수입니다.

void QTextCursor::insertImage(const QTextImageFormat &format, QTextFrameFormat::Position alignment)

이 함수는 오버로드된 함수입니다.

지정된 alignment 을 사용하여 커서의 현재 위치에 지정된 format 으로 정의된 이미지를 삽입합니다.

position()도 참조하세요 .

QTextList *QTextCursor::insertList(const QTextListFormat &format)

현재 위치에 새 블록을 삽입하고 지정된 format 으로 새로 생성된 목록의 첫 번째 목록 항목으로 만듭니다. 생성된 목록을 반환합니다.

currentList(), createList(), insertBlock()도 참조하세요 .

QTextList *QTextCursor::insertList(QTextListFormat::Style style)

이 함수는 오버로드된 함수입니다.

현재 위치에 새 블록을 삽입하고 지정된 style 으로 새로 생성된 목록의 첫 번째 목록 항목으로 만듭니다. 생성된 목록을 반환합니다.

currentList(), createList(), insertBlock()도 참조하세요 .

[since 6.4] void QTextCursor::insertMarkdown(const QString &markdown, QTextDocument::MarkdownFeatures features = QTextDocument::MarkdownDialectGitHub)

현재 position()에 지정된 마크다운 features 과 함께 markdown 텍스트를 삽입합니다. 기본값은 GitHub 방언입니다.

이 함수는 Qt 6.4에 도입되었습니다.

QTextTable *QTextCursor::insertTable(int rows, int columns, const QTextTableFormat &format)

지정된 format 에 지정된 수 rows 및 columns 의 새 테이블을 만들고 문서의 현재 커서 position()에 삽입한 다음 테이블 객체를 반환합니다. 커서가 첫 번째 셀의 시작 부분으로 이동합니다.

표에는 적어도 하나의 행과 하나의 열이 있어야 합니다.

currentTable()도 참조하세요 .

QTextTable *QTextCursor::insertTable(int rows, int columns)

이 함수는 오버로드된 함수입니다.

주어진 개수 rows 및 columns 의 새 표를 생성하고 문서의 현재 커서 position()에 삽입한 다음 표 개체를 반환합니다. 커서가 첫 번째 셀의 시작 부분으로 이동합니다.

표에는 적어도 하나의 행과 하나의 열이 있어야 합니다.

currentTable()도 참조하세요 .

void QTextCursor::insertText(const QString &text)

현재 문자 형식을 사용하여 현재 위치에 text 을 삽입합니다.

선택 영역이 있는 경우 선택 영역이 삭제되고 text 로 대체됩니다(예: ):

cursor.clearSelection();
cursor.movePosition(QTextCursor::NextWord, QTextCursor::KeepAnchor);
cursor.insertText("Hello World");

이렇게 하면 기존 선택 영역이 모두 지워지고 커서 위치의 단어(예: position() 앞으로)가 선택되며 선택 영역이 "Hello World"라는 문구로 바뀝니다.

삽입된 텍스트의 모든 ASCII 줄 바꿈 문자(\n)는 유니코드 블록 구분 기호로 변환되며 insertBlock() 호출에 해당합니다.

charFormat() 및 hasSelection()도 참조하세요 .

void QTextCursor::insertText(const QString &text, const QTextCharFormat &format)

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

주어진 format 을 사용하여 현재 위치에 text 을 삽입합니다.

bool QTextCursor::isCopyOf(const QTextCursor &other) const

이 커서와 other 이 서로의 복사본인 경우, 즉 둘 중 하나가 다른 커서의 복사본으로 생성되었고 그 이후 둘 다 이동하지 않은 경우 true 을 반환합니다. 이것은 동일성보다 훨씬 엄격합니다.

operator=() 및 operator==()도 참조하세요 .

bool QTextCursor::isNull() const

커서가 널이면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다. 널 커서는 기본 생성자에 의해 생성됩니다.

void QTextCursor::joinPreviousEditBlock()

beginEditBlock()와 마찬가지로 실행 취소/다시 실행을 위한 단일 작업으로 표시되어야 하는 편집 작업 블록의 시작을 나타냅니다. 그러나 beginEditBlock()와 달리 새 블록을 시작하는 것이 아니라 endEditBlock()로의 이전 호출을 되돌리므로 다음 작업이 이전에 생성된 편집 블록의 일부가 됩니다.

예를 들어

QTextCursor cursor(textDocument);
cursor.beginEditBlock();
cursor.insertText("Hello");
cursor.insertText("World");
cursor.endEditBlock();

// ...

cursor.joinPreviousEditBlock();
cursor.insertText("Hey");
cursor.endEditBlock();

textDocument->undo();

undo()를 호출하면 세 개의 삽입이 모두 실행 취소됩니다.

beginEditBlock() 및 endEditBlock()도 참조하세요 .

bool QTextCursor::keepPositionOnInsert() const

커서 위치에 텍스트가 삽입될 때 커서를 현재 위치로 유지할지 여부를 반환합니다.

기본값은 false입니다;

setKeepPositionOnInsert()도 참조하세요 .

void QTextCursor::mergeBlockCharFormat(const QTextCharFormat &modifier)

현재 블록(또는 선택 영역에 포함된 모든 블록)의 블록 문자 형식을 modifier 에 지정된 블록 형식으로 수정합니다.

setBlockCharFormat()도 참조하세요 .

void QTextCursor::mergeBlockFormat(const QTextBlockFormat &modifier)

현재 블록(또는 선택 영역에 포함된 모든 블록)의 블록 형식을 modifier 에 지정된 블록 형식으로 수정합니다.

setBlockFormat() 및 blockFormat()도 참조하세요 .

void QTextCursor::mergeCharFormat(const QTextCharFormat &modifier)

커서의 현재 문자 형식을 modifier 에 설명된 속성과 병합합니다. 커서에 선택 영역이 있는 경우 이 함수는 modifier 에 설정된 모든 속성을 선택 영역의 일부인 모든 문자 형식에 적용합니다.

hasSelection() 및 setCharFormat()도 참조하세요 .

bool QTextCursor::movePosition(QTextCursor::MoveOperation operation, QTextCursor::MoveMode mode = MoveAnchor, int n = 1)

지정된 mode 을 사용하여 지정된 operation n 번 수행하여 커서를 이동하고 모든 작업이 성공적으로 완료되면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

예를 들어, 이 함수를 반복적으로 사용하여 다음 단어의 끝을 찾는 경우 문서의 끝에 도달하면 결국 실패합니다.

기본적으로 이동 작업은 한 번 수행됩니다(n = 1).

mode 가 KeepAnchor 인 경우 커서가 이동하는 텍스트를 선택합니다. 이는 사용자가 Shift 키를 누른 상태에서 커서 키를 사용하여 커서를 이동할 때와 동일한 효과를 얻을 수 있습니다.

setVisualNavigation()도 참조하세요 .

int QTextCursor::position() const

문서 내에서 커서의 절대 위치를 반환합니다. 커서는 문자 사이에 위치합니다.

setPosition(), movePosition(), anchor() 및 positionInBlock()도 참조하세요 .

int QTextCursor::positionInBlock() const

블록 내에서 커서의 상대적 위치를 반환합니다. 커서는 문자 사이에 위치합니다.

이는 position() - block().position() 에 해당합니다.

position()도 참조하세요 .

void QTextCursor::removeSelectedText()

선택 항목이 있으면 해당 콘텐츠가 삭제되고, 그렇지 않으면 아무 작업도 수행하지 않습니다.

hasSelection()도 참조하세요 .

void QTextCursor::select(QTextCursor::SelectionType selection)

주어진 selection 에 따라 문서에서 텍스트를 선택합니다.

void QTextCursor::selectedTableCells(int *firstRow, int *numRows, int *firstColumn, int *numColumns) const

선택 영역이 테이블 셀에 걸쳐 있는 경우 firstRow 에는 선택 영역의 첫 번째 행 번호가, firstColumn 에는 선택 영역의 첫 번째 열 번호가, numRows 및 numColumns 에는 선택 영역의 행과 열 번호가 채워집니다. 선택 영역이 테이블 셀에 걸쳐 있지 않은 경우 결과는 무해하지만 정의되지 않습니다.

QString QTextCursor::selectedText() const

현재 선택 영역의 텍스트를 반환합니다(비어 있을 수 있음). 이 함수는 서식 있는 텍스트 정보 없이 텍스트만 반환합니다. 문서 조각(서식 있는 서식 있는 텍스트)을 원한다면 selection()를 대신 사용하세요.

QTextDocumentFragment QTextCursor::selection() const

현재 선택 영역(비어 있을 수 있음)을 모든 서식 정보와 함께 반환합니다. 선택한 텍스트(예: 일반 텍스트)만 반환하려면 selectedText()를 대신 사용합니다.

QTextDocumentFragment::toPlainText()도 참조하세요 .

int QTextCursor::selectionEnd() const

선택 영역의 끝을 반환하거나 커서에 선택 영역이 없는 경우 position()를 반환합니다.

selectionStart(), position() 및 anchor()도 참조하세요 .

int QTextCursor::selectionStart() const

선택 영역의 시작 부분을 반환하거나 커서에 선택 영역이 없는 경우 position()를 반환합니다.

selectionEnd(), position() 및 anchor()도 참조하세요 .

void QTextCursor::setBlockCharFormat(const QTextCharFormat &format)

현재 블록(또는 선택 항목에 포함된 모든 블록)의 블록 문자 형식을 format 으로 설정합니다.

blockCharFormat()도 참조하세요 .

void QTextCursor::setBlockFormat(const QTextBlockFormat &format)

현재 블록(또는 선택 항목에 포함된 모든 블록)의 블록 형식을 format 으로 설정합니다.

blockFormat() 및 mergeBlockFormat()도 참조하세요 .

void QTextCursor::setCharFormat(const QTextCharFormat &format)

커서의 현재 문자 형식을 지정된 format 으로 설정합니다. 커서에 선택 영역이 있는 경우 지정된 format 이 현재 선택 영역에 적용됩니다.

charFormat(), hasSelection() 및 mergeCharFormat()도 참조하세요 .

void QTextCursor::setKeepPositionOnInsert(bool b)

커서의 현재 위치에 텍스트가 삽입될 때 커서가 현재 위치를 유지할지 여부를 정의합니다.

b 이 참이면 커서가 위치한 위치에 텍스트가 삽입될 때 커서가 현재 위치를 유지합니다. b 이 거짓이면 커서가 삽입된 텍스트와 함께 이동합니다.

기본값은 false입니다.

커서의 현재 위치 앞에 텍스트가 삽입되면 커서가 항상 이동하고, 커서의 현재 위치 뒤에 텍스트가 삽입되면 커서가 항상 그 위치를 유지한다는 점에 유의하세요.

keepPositionOnInsert()도 참조하세요 .

void QTextCursor::setPosition(int pos, QTextCursor::MoveMode m = MoveAnchor)

pos 에서 지정한 MoveMode 을 사용하여 m 에서 지정한 문서 내 절대 위치로 커서를 이동합니다. 커서는 문자 사이에 위치합니다.

position(), movePosition() 및 anchor()도 참조하세요 .

void QTextCursor::setVerticalMovementX(int x)

수직 커서 이동의 시각적 x 위치를 x 로 설정합니다.

커서가 수평으로 이동하면 수직 이동 x 위치가 자동으로 지워지고, 커서가 수직으로 이동하면 변경되지 않은 상태로 유지됩니다. 이 메커니즘을 사용하면 커서가 비례 글꼴을 사용하여 시각적으로 직선으로 위아래로 이동하고 짧은 선 위로 부드럽게 '점프'할 수 있습니다.

값이 -1이면 미리 정의된 X 위치가 없음을 나타냅니다. 그러면 다음에 커서를 위아래로 움직일 때 자동으로 설정됩니다.

verticalMovementX()도 참조하세요 .

void QTextCursor::setVisualNavigation(bool b)

시각적 탐색을 b 로 설정합니다.

시각적 탐색은 숨겨진 텍스트 단락을 건너뛰는 것을 의미합니다. 기본값은 false입니다.

visualNavigation() 및 movePosition()도 참조하세요 .

[noexcept] void QTextCursor::swap(QTextCursor &other)

이 텍스트 커서 인스턴스를 other 로 바꿉니다. 이 작업은 매우 빠르며 실패하지 않습니다.

int QTextCursor::verticalMovementX() const

수직 커서 이동에 대한 시각적 x 위치를 반환합니다.

값이 -1이면 미리 정의된 x 위치가 없음을 나타냅니다. 그러면 다음에 커서를 위 또는 아래로 이동할 때 자동으로 설정됩니다.

setVerticalMovementX()도 참조하세요 .

bool QTextCursor::visualNavigation() const

커서가 시각적 탐색을 수행하면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

시각적 탐색은 숨겨진 텍스트 단락을 건너뛰는 것을 의미합니다. 기본값은 false입니다.

setVisualNavigation() 및 movePosition()도 참조하세요 .

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

other 커서가 문서에서 이 커서와 다른 위치에 있으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

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

other 커서가 이 커서보다 문서에서 뒤에 위치하면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

bool QTextCursor::operator<=(const QTextCursor &other) const

other 커서가 이 커서보다 뒤에 있거나 문서에서 이 커서와 같은 위치에 있으면 true 을 반환하고, 그렇지 않으면 false를 반환합니다.

QTextCursor &QTextCursor::operator=(const QTextCursor &cursor)

cursor 의 복사본을 만들어 이 QTextCursor 에 할당합니다. QTextCursor 은 암시적으로 공유되는 클래스입니다.

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

other 커서가 문서에서 이 커서와 같은 위치에 있으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

bool QTextCursor::operator>(const QTextCursor &other) const

other 커서가 이 커서보다 문서의 앞쪽에 위치하면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

bool QTextCursor::operator>=(const QTextCursor &other) const

other 커서가 이 커서보다 앞쪽에 있거나 문서에서 이 커서와 같은 위치에 있으면 true 을 반환하고, 그렇지 않으면 false를 반환합니다.