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 명시적 텍스트 선택 인스턴스는 지정된 텍스트 범위와 character 및 block 형식의 속성을 쿼리하고 수정하는 데 사용할 수 있습니다.
참고: 이 API는 기술 프리뷰로 간주되며 향후 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)
moveSelectionStart()에 사용된 열거형 값 중 하나인 op 에 따라 selectionEnd n 을 여러 번 이동합니다.
moveSelectionStart()가 바로 전에 selectionEnd == selectionStart 을 호출했다면, 이 함수는 거기서부터 이동하여 텍스트 범위가 선택되도록 합니다.
이 메서드는 Qt 6.11에 도입되었습니다.
QTextCursor::movePosition, QTextCursor::KeepAnchor, moveSelectionStart() 및 QTextCursor::MoveOperation도 참조하십시오 .
[since 6.11] bool moveSelectionStart(MoveOperation op, int n)
텍스트를 선택 해제하고 다음 열거형 값 중 하나인 op 에 따라 selectionStart 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.