QVirtualKeyboardSelectionListModel Class
Listenmodell für Auswahllisten. Mehr...
| Kopfzeile: | #include <QVirtualKeyboardSelectionListModel> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS VirtualKeyboard) target_link_libraries(mytarget PRIVATE Qt6::VirtualKeyboard) |
| qmake: | QT += virtualkeyboard |
| In QML: | SelectionListModel |
| Erbt von: | QAbstractListModel |
Öffentliche Typen
| enum class | DictionaryType { Default, User } |
| enum class | Role { Display, DisplayRole, WordCompletionLength, WordCompletionLengthRole, Dictionary, CanRemoveSuggestion } |
| enum class | Type { WordCandidateList } |
Öffentliche Funktionen
| void | removeItem(int index) |
| void | selectItem(int index) |
Signale
| void | activeItemChanged(int index) |
| void | itemSelected(int index) |
Ausführliche Beschreibung
Diese Klasse fungiert als Brücke zwischen der Benutzeroberfläche und der Eingabemethode, die die Daten für Auswahllisten bereitstellt.
Dokumentation zu den Member-Typen
enum class QVirtualKeyboardSelectionListModel::DictionaryType
Diese Enumeration gibt den Wörterbuchtyp eines Wortes an.
| Konstante | Wert | Beschreibung |
|---|---|---|
QVirtualKeyboardSelectionListModel::DictionaryType::Default | 0 | Der Wortvorschlag stammt aus dem Standardwörterbuch. |
QVirtualKeyboardSelectionListModel::DictionaryType::User | 1 | Der Wortvorschlag stammt aus dem Benutzerwörterbuch. |
enum class QVirtualKeyboardSelectionListModel::Role
Diese Enumeration legt eine Rolle der angeforderten Daten fest.
| Konstante | Wert | Beschreibung |
|---|---|---|
QVirtualKeyboardSelectionListModel::Role::Display | Qt::DisplayRole | Die Daten sollen in Form von Text dargestellt werden. |
QVirtualKeyboardSelectionListModel::Role::DisplayRole | Display | obsolete Verwenden Sie Role::Display. |
QVirtualKeyboardSelectionListModel::Role::WordCompletionLength | Qt::UserRole + 1 | Eine Ganzzahl, die die Länge des Wortes angibt, das durch die Wortvervollständigung ergänzt wird, ausgedrückt als Anzahl der Zeichen, gezählt ab dem Ende der Zeichenkette. |
QVirtualKeyboardSelectionListModel::Role::WordCompletionLengthRole | WordCompletionLength | obsolete Verwenden Sie Role::WordCompletionLength. |
QVirtualKeyboardSelectionListModel::Role::Dictionary | 258 | Eine Ganzzahl, die l {QVirtualKeyboardSelectionListModel::DictionaryType}{Wörterbuchtyp} angibt. |
QVirtualKeyboardSelectionListModel::Role::CanRemoveSuggestion | 259 | Ein boolescher Wert, der angibt, ob der Wortvorschlag aus dem Wörterbuch entfernt werden kann. |
enum class QVirtualKeyboardSelectionListModel::Type
Diese Enumeration legt den Typ der Auswahlliste fest.
| Konstante | Wert | Beschreibung |
|---|---|---|
QVirtualKeyboardSelectionListModel::Type::WordCandidateList | 0 | Zeigt eine Liste mit Wortvorschlägen an. |
Dokumentation der Mitgliedsfunktionen
[signal] void QVirtualKeyboardSelectionListModel::activeItemChanged(int index)
Dieses Signal wird ausgelöst, wenn sich das aktive Element in der Liste ändert. Die Benutzeroberfläche sollte auf dieses Signal reagieren, indem sie das Element unter index in der Liste hervorhebt.
[signal] void QVirtualKeyboardSelectionListModel::itemSelected(int index)
Dieses Signal wird ausgelöst, wenn der Benutzer ein Element unter index auswählt.
[invokable] void QVirtualKeyboardSelectionListModel::removeItem(int index)
Diese Methode sollte aufgerufen werden, wenn der Benutzer ein Element an der Position index aus der Liste entfernt. Das Entfernen wird zur weiteren Verarbeitung an die Eingabemethode weitergeleitet.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] void QVirtualKeyboardSelectionListModel::selectItem(int index)
Diese Methode sollte aufgerufen werden, wenn der Benutzer ein Element an der Position index aus der Liste auswählt. Die Auswahl wird zur weiteren Verarbeitung an die Eingabemethode weitergeleitet.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe 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.
