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
- void activeItemChanged(int index)
- void itemSelected(int index)
Méthodes
- void removeItem(int index)
- void selectItem(int index)
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 :
displayTexte d'affichage pour l'élément.wordCompletionLengthLongueur d'achèvement du mot pour l'élément.dictionaryTypeType de dictionnaire du mot, voir QVirtualKeyboardSelectionListModel::DictionaryType.canRemoveSuggestionUn 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.