SelectionListModel QML Type

Stellt ein Datenmodell für die Auswahllisten bereit. Mehr...

Import Statement: import QtQuick.VirtualKeyboard
In C++: QVirtualKeyboardSelectionListModel

Signale

Methoden

Detaillierte Beschreibung

Das SelectionListModel ist ein Datenmodell für Wortkandidaten, die von der Eingabemethode geliefert werden.

Eine Instanz eines SelectionListModel kann nicht direkt erstellt werden. Stattdessen verwaltet die InputEngine die Instanzen und ermöglicht den Zugriff auf das Modell über die InputEngine::wordCandidateListModel Eigenschaft.

Das Modell stellt die folgenden Datenrollen für den Listendelegierten zur Verfügung:

  • display Anzeigetext für Element.
  • wordCompletionLength Länge der Wortvervollständigung für das Element.
  • dictionaryType Wörterbuchtyp des Wortes, siehe QVirtualKeyboardSelectionListModel::DictionaryType.
  • canRemoveSuggestion Ein Boolescher Wert, der angibt, ob das Wort aus dem Wörterbuch entfernt werden kann.

Das Signal activeItemChanged zeigt an, welches Element gerade von der Eingabemethode hervorgehoben wird. Die Ansicht sollte auf dieses Signal reagieren, indem sie den entsprechenden Eintrag in der Liste hervorhebt.

Die Benutzerauswahl wird von der Methode selectItem() verarbeitet. Die Ansicht sollte diese Methode aufrufen, wenn der Benutzer einen Eintrag in der Liste auswählt.

Signal Dokumentation

void activeItemChanged(int index)

Dieses Signal wird ausgegeben, 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.

Hinweis: Der entsprechende Handler ist onActiveItemChanged.


void itemSelected(int index)

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

Hinweis: Der entsprechende Handler ist onItemSelected.


Dokumentation der Methode

void 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.


void selectItem(int index)

Diese Methode sollte aufgerufen werden, wenn der Benutzer einen Eintrag an der Position index aus der Liste auswählt. Die Auswahl wird zur weiteren Verarbeitung an die Eingabemethode weitergeleitet.


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