SelectionListModel QML Type (Uncreatable)

Fournit un modèle de données pour les listes de sélection. En savoir plus...

Remarque : il s'agit d'un type non instanciable. Il ne peut pas être instancié en QML.

• Liste de tous les membres, y compris les membres hérités

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 proposés par la méthode de saisie.

Il n'est pas possible de créer directement une instance de SelectionListModel. C'est l'InputEngine qui gère les instances et permet d'accéder au modèle via 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 de l'élément.
• wordCompletionLength Longueur de la suggestion de mot pour l'élément.
• dictionaryType Type de dictionnaire du mot, voir QVirtualKeyboardSelectionListModel::DictionaryType.
• canRemoveSuggestion Une valeur booléenne indiquant si le mot peut être supprimé du dictionnaire.

Le signal « activeItemChanged » indique quel élément est actuellement mis en surbrillance par la méthode de saisie. La vue doit répondre à ce signal en mettant en surbrillance 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 appeler 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 surbrillance l'élément situé à l'adresse index dans la liste.

void itemSelected(int index)

Ce signal est émis lorsqu'un élément de la page index est sélectionné par l'utilisateur.

Documentation de la méthode

void removeItem(int index)

Cette méthode doit être appelée lorsque l'utilisateur supprime un élément de la liste situé à la position index. La suppression est transmise à la méthode d'entrée pour un traitement ultérieur.

void selectItem(int index)

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