이 페이지에서

TextSelection QML Type

연속된 텍스트 선택 영역과 해당 속성을 나타냅니다. 더 보기...

Import Statement: import QtQuick
Since: Qt 6.7

속성

방법

상세 설명

TextEdit.cursorSelection 현재 선택된(예: 마우스를 드래그하여) 텍스트 범위를 나타냅니다. 이를 통해 선택된 텍스트는 물론, character 및 block 형식의 속성을 조회하고 수정할 수 있습니다.

또한, 6.11 버전부터는 명시적인 비시각적 인스턴스를 생성할 수 있습니다:

TextEdit {
    id: textEdit

    TextSelection {
        id: sel1
    }
}

TextEdit.cursorSelection 그리고 모든 명시적인 TextSelection 인스턴스는 지정된 텍스트 범위를 조회 및 수정하는 데 사용할 수 있을 뿐만 아니라, character 및 block 형식의 속성도 조회 및 수정할 수 있습니다.

참고: 이 API는 기술 미리보기(Tech Preview)로 간주되며, 향후 Qt 버전에서 변경되거나 제거될 수 있습니다.

TextEdit 및 QTextCursor도 참조하십시오 .

속성 설명서

alignment : enumeration

선택된 텍스트가 포함된 블록의 정렬 방식.

QTextBlockFormat::alignment()도 참조하십시오 .

color : color

선택된 텍스트의 전경색입니다.

QTextCharFormat::foreground()도 참조하십시오 .

document : TextDocument [since 6.11]

선택된 텍스트를 포함하는 ` QQuickTextDocument `입니다.

이 속성은 Qt 6.11에서 도입되었습니다.

QtQuick::TextEdit::textDocument도 참조하십시오 .

font : color

선택한 텍스트의 글꼴.

QTextCharFormat::font()도 참조하십시오 .

selectionEnd : int [since 6.11]

선택 영역의 마지막 문자가 끝난 뒤의 위치.

이 속성은 Qt 6.11에서 도입되었습니다.

QtQuick::TextEdit::selectionEnd도 참조하십시오 .

selectionStart : int [since 6.11]

선택 영역의 첫 번째 문자 바로 앞 위치.

이 속성은 Qt 6.11에서 도입되었습니다.

QtQuick::TextEdit::selectionStart도 참조하십시오 .

text : string

선택된 텍스트로, 서식 태그는 포함되어 있지 않습니다.

이 속성을 설정하면 선택된 텍스트가 지정된 문자열로 대체됩니다.

메서드 설명

[since 6.11] void duplicate()

선택한 텍스트를 앞으로 복사하되, 복사본의 모든 서식을 그대로 유지하고, 복사된 텍스트를 선택 상태로 지정합니다.

예를 들어, 한 줄 전체가 선택된 경우 이 함수는 해당 줄의 복사본을 바로 아래에 삽입하고, 복사본을 선택 상태로 만듭니다. 단어가 선택된 경우, 이 함수는 해당 단어를 오른쪽으로 복사하고 선택 상태로 만듭니다.

이 기능은 Qt 6.11에서 도입되었습니다.

[since 6.11] void linkTo(url destination)

선택한 텍스트에서 destination 로 연결되는 하이퍼링크를 만듭니다.

이 메서드는 Qt 6.11에서 도입되었습니다.

QTextCharFormat::setAnchorHref()도 참조하십시오 .

[since 6.11] void moveSelectionEnd(MoveOperation op, int n)

` selectionEnd `을 ` n `만큼 ` op`에 따라 이동합니다. 여기서 ` `은 ` moveSelectionStart()`에서 사용되는 열거형 값 중 하나입니다.

moveSelectionStart()가 selectionEnd == selectionStart 직전에 호출된 경우, 이 함수는 해당 위치에서 텍스트를 이동시켜 텍스트 범위가 선택되도록 합니다.

이 메서드는 Qt 6.11에서 도입되었습니다.

QTextCursor::movePosition, QTextCursor::KeepAnchor, moveSelectionStart() 및 QTextCursor::MoveOperation도 참조하십시오 .

[since 6.11] bool moveSelectionStart(MoveOperation op, int n)

텍스트 선택을 해제하고 selectionStart 를 op 에 따라 n 번 이동합니다. 여기서 는 다음 열거형 값 중 하나입니다:

상수설명
TextSelection.NoMove커서를 현재 위치에 유지
TextSelection.Start문서의 시작 부분으로 이동합니다.
TextSelection.StartOfLine현재 줄의 시작 부분으로 이동합니다.
TextSelection.StartOfBlock현재 블록의 시작 부분으로 이동합니다.
TextSelection.StartOfWord현재 단어의 시작 부분으로 이동합니다.
TextSelection.PreviousBlock이전 블록의 시작 부분으로 이동합니다.
TextSelection.PreviousCharacter이전 문자로 이동합니다.
TextSelection.PreviousWord이전 단어의 시작 부분으로 이동합니다.
TextSelection.Up한 줄 위로 이동합니다.
TextSelection.Left한 글자 왼쪽으로 이동합니다.
TextSelection.WordLeft한 단어 왼쪽으로 이동합니다.
TextSelection.End문서 끝으로 이동합니다.
TextSelection.EndOfLine현재 줄의 끝으로 이동합니다.
TextSelection.EndOfWord현재 단어의 끝으로 이동합니다.
TextSelection.EndOfBlock현재 블록의 끝으로 이동합니다.
TextSelection.NextBlock다음 블록의 시작 부분으로 이동합니다.
TextSelection.NextCharacter다음 문자로 이동합니다.
TextSelection.NextWord다음 단어로 이동합니다.
TextSelection.Down한 줄 아래로 이동합니다.
TextSelection.Right한 글자 오른쪽으로 이동합니다.
TextSelection.WordRight한 단어 오른쪽으로 이동합니다.
TextSelection.NextCell현재 표 내의 다음 표 셀 시작 부분으로 이동합니다. 현재 셀이 행의 마지막 셀인 경우, 커서는 다음 행의 첫 번째 셀로 이동합니다.
TextSelection.PreviousCell현재 표 내의 이전 표 셀의 시작 부분으로 이동합니다. 현재 셀이 행의 첫 번째 셀인 경우, 커서는 이전 행의 마지막 셀로 이동합니다.
TextSelection.NextRow현재 테이블에서 다음 행의 첫 번째 새 셀로 이동합니다.
TextSelection.PreviousRow현재 테이블에서 이전 행의 마지막 셀로 이동합니다.

모든 작업이 성공적으로 완료된 경우 ` true `을 반환하고, 그렇지 않은 경우 ` false`을 반환합니다.

이 메서드는 Qt 6.11에서 도입되었습니다.

QTextCursor::movePosition, QTextCursor::MoveAnchor 및 QTextCursor::MoveOperation도 참조하십시오 .

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.