Sur cette page

SelectionListModel QML Type

Fournit un modèle de données pour les listes de sélection. Plus...

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

Signaux

Méthodes

Description détaillée

Le SelectionListModel est un modèle de données pour les mots candidats fournis par la méthode d'entrée.

Une instance d'un SelectionListModel ne peut pas être créée directement. Au lieu de cela, InputEngine gère les instances et fournit un accès au modèle par le biais de la propriété InputEngine::wordCandidateListModel.

Le modèle expose les rôles de données suivants pour le délégué de liste :

  • display Texte d'affichage pour l'élément.
  • wordCompletionLength Longueur d'achèvement du mot pour l'élément.
  • dictionaryType Type de dictionnaire du mot, voir QVirtualKeyboardSelectionListModel::DictionaryType.
  • canRemoveSuggestion Un booléen indiquant si le mot peut être supprimé du dictionnaire.

Le signal activeItemChanged indique quel élément est actuellement mis en évidence par la méthode de saisie. La vue doit répondre à ce signal en mettant en évidence l'élément correspondant dans la liste.

La sélection de l'utilisateur est gérée par la méthode selectItem(). La vue doit invoquer cette méthode lorsque l'utilisateur sélectionne un élément de la liste.

Documentation sur les signaux

void activeItemChanged(int index)

Ce signal est émis lorsque l'élément actif de la liste change. L'interface utilisateur doit réagir à ce signal en mettant en évidence l'élément situé à l'adresse index dans la liste.

Remarque : le gestionnaire correspondant est onActiveItemChanged.

void itemSelected(int index)

Ce signal est émis lorsqu'un élément situé à l'adresse index est sélectionné par l'utilisateur.

Remarque : le gestionnaire correspondant est onItemSelected.

Documentation de la méthode

void removeItem(int index)

Cette méthode doit être appelée lorsque l'utilisateur retire de la liste un élément situé à la position index. Le retrait est transmis à la méthode de saisie pour traitement ultérieur.

void selectItem(int index)

Cette méthode doit être appelée lorsque l'utilisateur sélectionne un élément de la liste à la position index. La sélection est transmise à la méthode de saisie pour traitement ultérieur.

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