Sur cette page

QVirtualKeyboardSelectionListModel Class

Modèle de liste pour les listes de sélection. Plus d'informations...

En-tête : #include <QVirtualKeyboardSelectionListModel>
CMake : find_package(Qt6 REQUIRED COMPONENTS VirtualKeyboard)
target_link_libraries(mytarget PRIVATE Qt6::VirtualKeyboard)
qmake : QT += virtualkeyboard
En QML : SelectionListModel
Héritages : QAbstractListModel

Types publics

enum class DictionaryType { Default, User }
enum class Role { Display, DisplayRole, WordCompletionLength, WordCompletionLengthRole, Dictionary, CanRemoveSuggestion }
enum class Type { WordCandidateList }

Fonctions publiques

int count() const
void removeItem(int index)
void selectItem(int index)

Signaux

void activeItemChanged(int index)
void countChanged()
void itemSelected(int index)

Description détaillée

Cette classe sert de pont entre l'interface utilisateur et la méthode de saisie qui fournit les données pour les listes de sélection.

Documentation des types de membres

enum class QVirtualKeyboardSelectionListModel::DictionaryType

Cette énumération spécifie le type de dictionnaire d'un mot.

ConstanteValeurDescription
QVirtualKeyboardSelectionListModel::DictionaryType::Default0Le mot candidat provient du dictionnaire par défaut.
QVirtualKeyboardSelectionListModel::DictionaryType::User1Le mot candidat provient du dictionnaire de l'utilisateur.

enum class QVirtualKeyboardSelectionListModel::Role

Cette énumération spécifie le rôle des données demandées.

ConstanteValeurDescription
QVirtualKeyboardSelectionListModel::Role::DisplayQt::DisplayRoleLes données à restituer sous forme de texte.
QVirtualKeyboardSelectionListModel::Role::DisplayRoleDisplayobsolete Utiliser Role::Display.
QVirtualKeyboardSelectionListModel::Role::WordCompletionLengthQt::UserRole + 1Un nombre entier spécifiant la longueur du mot à compléter, exprimée en nombre de caractères comptés à partir de la fin de la chaîne.
QVirtualKeyboardSelectionListModel::Role::WordCompletionLengthRoleWordCompletionLengthobsolete Utilisez Role::WordCompletionLength.
QVirtualKeyboardSelectionListModel::Role::Dictionary258Un nombre entier indiquant l {QVirtualKeyboardSelectionListModel::DictionaryType}{type de dictionnaire}.
QVirtualKeyboardSelectionListModel::Role::CanRemoveSuggestion259Une valeur booléenne indiquant si le mot candidat peut être supprimé du dictionnaire.

enum class QVirtualKeyboardSelectionListModel::Type

Cette énumération spécifie le type de liste de sélection.

ConstanteValeurDescription de la liste
QVirtualKeyboardSelectionListModel::Type::WordCandidateList0Affiche la liste des mots candidats.

Fonction membre Documentation

[signal] void QVirtualKeyboardSelectionListModel::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 à l'adresse index dans la liste.

[signal] void QVirtualKeyboardSelectionListModel::itemSelected(int index)

Ce signal est émis lorsqu'un élément du site index est sélectionné par l'utilisateur.

[invokable] void QVirtualKeyboardSelectionListModel::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 d'entrée pour traitement ultérieur.

Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.

[invokable] void QVirtualKeyboardSelectionListModel::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 d'entrée pour traitement ultérieur.

Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.

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