Auf dieser Seite

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

Methoden

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:

  • display Anzeigetext für das 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 “ 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.