TextSelection QML Type
연속된 텍스트 선택 영역과 해당 속성을 나타냅니다. 더 보기...
| Import Statement: | import QtQuick |
| Since: | Qt 6.7 |
속성
- alignment : enumeration
- color : color
- document : TextDocument
(since 6.11) - font : color
- selectionEnd : int
(since 6.11) - selectionStart : int
(since 6.11) - text : string
방법
- void duplicate()
(since 6.11) - void linkTo(url destination)
(since 6.11) - void moveSelectionEnd(MoveOperation op, int n)
(since 6.11) - bool moveSelectionStart(MoveOperation op, int n)
(since 6.11)
상세 설명
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.