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
Vererbt: 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)

Detaillierte Beschreibung

Diese Klasse dient als Brücke zwischen der Benutzeroberfläche und der Eingabemethode, die die Daten für Auswahllisten bereitstellt.

Dokumentation der Mitgliedstypen

enum class QVirtualKeyboardSelectionListModel::DictionaryType

Diese Aufzählung gibt den Wörterbuchtyp eines Wortes an.

KonstanteWertBeschreibung
QVirtualKeyboardSelectionListModel::DictionaryType::Default0Der Wortkandidat stammt aus dem Standardwörterbuch.
QVirtualKeyboardSelectionListModel::DictionaryType::User1Das Wort candidate stammt aus dem Benutzerwörterbuch.

enum class QVirtualKeyboardSelectionListModel::Role

Diese Aufzählung gibt eine Rolle der angeforderten Daten an.

KonstanteWertBeschreibung
QVirtualKeyboardSelectionListModel::Role::DisplayQt::DisplayRoleDie Daten, die in Form von Text wiedergegeben werden sollen.
QVirtualKeyboardSelectionListModel::Role::DisplayRoleDisplayobsolete Verwenden Sie Role::Display.
QVirtualKeyboardSelectionListModel::Role::WordCompletionLengthQt::UserRole + 1Eine ganze Zahl, die die Länge des Wortes angibt, das den Vervollständigungsteil bildet, ausgedrückt als Anzahl der Zeichen ab dem Ende der Zeichenkette.
QVirtualKeyboardSelectionListModel::Role::WordCompletionLengthRoleWordCompletionLengthobsolete Verwenden Sie Role::WordCompletionLength.
QVirtualKeyboardSelectionListModel::Role::Dictionary258Eine ganze Zahl, die l {QVirtualKeyboardSelectionListModel::DictionaryType}{Wörterbuchtyp} angibt.
QVirtualKeyboardSelectionListModel::Role::CanRemoveSuggestion259Ein boolescher Wert, der angibt, ob der Wortkandidat aus dem Wörterbuch entfernt werden kann.

enum class QVirtualKeyboardSelectionListModel::Type

Diese Aufzählung gibt den Typ der Auswahlliste an.

KonstanteWertBeschreibung
QVirtualKeyboardSelectionListModel::Type::WordCandidateList0Zeigt die Liste der Wortkandidaten an.

Dokumentation der Mitgliedsfunktionen

[signal] void QVirtualKeyboardSelectionListModel::activeItemChanged(int index)

Dieses Signal wird ausgesendet, wenn sich das aktive Element in der Liste ändert. Die Benutzeroberfläche sollte auf dieses Signal reagieren, indem das Element unter index in der Liste hervorgehoben wird.

[signal] void QVirtualKeyboardSelectionListModel::itemSelected(int index)

Dieses Signal wird ausgegeben, wenn ein Element auf index vom Benutzer ausgewählt wird.

[invokable] void QVirtualKeyboardSelectionListModel::removeItem(int index)

Diese Methode sollte aufgerufen werden, wenn der Benutzer ein Element an der Position index aus der Liste entfernt. Die Entfernung wird zur weiteren Verarbeitung an die Eingabemethode weitergeleitet.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus 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 Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

© 2025 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.