QVirtualKeyboardSelectionListModel Class
선택 목록용 목록 모델. 더 보기...
| 헤더: | #include <QVirtualKeyboardSelectionListModel> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS VirtualKeyboard) target_link_libraries(mytarget PRIVATE Qt6::VirtualKeyboard) |
| qmake: | QT += virtualkeyboard |
| QML에서: | SelectionListModel |
| 상속: | QAbstractListModel |
공개 타입
| enum class | DictionaryType { Default, User } |
| enum class | Role { Display, DisplayRole, WordCompletionLength, WordCompletionLengthRole, Dictionary, CanRemoveSuggestion } |
| enum class | Type { WordCandidateList } |
공개 함수
| void | removeItem(int index) |
| void | selectItem(int index) |
신호
| void | activeItemChanged(int index) |
| void | itemSelected(int index) |
멤버 유형 설명
enum class QVirtualKeyboardSelectionListModel::DictionaryType
이 열거형은 단어의 사전 유형을 지정합니다.
| 상수 | 값 | 설명 |
|---|---|---|
QVirtualKeyboardSelectionListModel::DictionaryType::Default | 0 | 단어 후보는 기본 사전에서 가져온 것입니다. |
QVirtualKeyboardSelectionListModel::DictionaryType::User | 1 | 단어 후보가 사용자 사전에 있습니다. |
enum class QVirtualKeyboardSelectionListModel::Role
이 열거형은 요청된 데이터의 역할을 지정합니다.
| 상수 | 값 | 설명 |
|---|---|---|
QVirtualKeyboardSelectionListModel::Role::Display | Qt::DisplayRole | 텍스트 형태로 렌더링될 데이터입니다. |
QVirtualKeyboardSelectionListModel::Role::DisplayRole | Display | obsolete Role::Display를 사용하십시오. |
QVirtualKeyboardSelectionListModel::Role::WordCompletionLength | Qt::UserRole + 1 | 문자열 끝에서 시작해 계산된 문자 수로 표현된, 자동 완성 부분의 단어 길이를 지정하는 정수입니다. |
QVirtualKeyboardSelectionListModel::Role::WordCompletionLengthRole | WordCompletionLength | obsolete Role::WordCompletionLength를 사용하십시오. |
QVirtualKeyboardSelectionListModel::Role::Dictionary | 258 | l {QVirtualKeyboardSelectionListModel::DictionaryType} {사전 유형}을 지정하는 정수입니다. |
QVirtualKeyboardSelectionListModel::Role::CanRemoveSuggestion | 259 | 단어 후보가 사전에서 제거될 수 있는지 여부를 나타내는 부울 값입니다. |
enum class QVirtualKeyboardSelectionListModel::Type
이 열거형은 선택 목록의 유형을 지정합니다.
| 상수 | 값 | 설명 |
|---|---|---|
QVirtualKeyboardSelectionListModel::Type::WordCandidateList | 0 | 단어 후보 목록을 표시합니다. |
멤버 함수 설명
[signal] void QVirtualKeyboardSelectionListModel::activeItemChanged(int index)
이 신호는 목록에서 선택된 항목이 변경될 때 발생합니다. UI는 이 신호에 반응하여 목록의 index 위치에 있는 항목을 강조 표시해야 합니다.
[signal] void QVirtualKeyboardSelectionListModel::itemSelected(int index)
index 에 있는 항목이 사용자에 의해 선택되면 이 신호가 발생합니다.
[invokable] void QVirtualKeyboardSelectionListModel::removeItem(int index)
사용자가 목록의 index 위치에 있는 항목을 제거할 때 이 메서드를 호출해야 합니다. 제거 작업은 추가 처리를 위해 입력 메서드로 전달됩니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.
[invokable] void QVirtualKeyboardSelectionListModel::selectItem(int index)
사용자가 목록에서 index 위치에 있는 항목을 선택할 때 이 메서드를 호출해야 합니다. 선택된 항목은 추가 처리를 위해 입력 방식(input method)으로 전달됩니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하십시오.
© 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.
