SelectionListModel QML Type (Uncreatable)
Stellt ein Datenmodell für die Auswahllisten bereit. Mehr...
| Import Statement: | import QtQuick.VirtualKeyboard |
| In C++: | QVirtualKeyboardSelectionListModel |
Hinweis: Dies ist ein nicht erstellbarer Typ. Er kann in QML nicht instanziiert werden.
Signale
- void activeItemChanged(int index)
- void itemSelected(int index)
Methoden
- void removeItem(int index)
- void selectItem(int index)
Ausführliche Beschreibung
Das SelectionListModel ist ein Datenmodell für Wortvorschläge, die von der Eingabemethode bereitgestellt werden.
Eine Instanz eines „SelectionListModel“ kann nicht direkt erstellt werden. Stattdessen verwaltet das „ InputEngine “ die Instanzen und ermöglicht den Zugriff auf das Modell über die Eigenschaft „ InputEngine::wordCandidateListModel “.
Das Modell stellt die folgenden Datenrollen für den Listen-Delegaten bereit:
displayAnzeigetext für das Element.wordCompletionLengthLänge der Wortvervollständigung für das Element.dictionaryTypeWörterbuchtyp des Wortes, siehe „ QVirtualKeyboardSelectionListModel::DictionaryType “.canRemoveSuggestionEin boolescher Wert, der angibt, ob das Wort aus dem Wörterbuch entfernt werden kann.
Das Signal „ activeItemChanged “ gibt an, welches Element derzeit von der Eingabemethode markiert ist. Die Ansicht sollte auf dieses Signal reagieren, indem sie das entsprechende Element in der Liste markiert.
Die Benutzerauswahl wird von der Methode ` selectItem()` verarbeitet. Die Ansicht sollte diese Methode aufrufen, wenn der Benutzer ein Element aus der Liste auswählt.
Signaldokumentation
void 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.
Hinweis: Der entsprechende Handler lautet onActiveItemChanged.
void itemSelected(int index)
Dieses Signal wird ausgelöst, wenn der Benutzer ein Element unter index auswählt.
Hinweis: Der entsprechende Handler lautet onItemSelected.
Methodendokumentation
void 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.
void 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.
© 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.