QVirtualKeyboardSelectionListModel Class
Modèle de liste pour les listes de sélection. En savoir plus...
| 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érite de : | QAbstractListModel |
Types publics
| enum class | DictionaryType { Default, User } |
| enum class | Role { Display, DisplayRole, WordCompletionLength, WordCompletionLengthRole, Dictionary, CanRemoveSuggestion } |
| enum class | Type { WordCandidateList } |
Fonctions publiques
| void | removeItem(int index) |
| void | selectItem(int index) |
Signaux
| void | activeItemChanged(int index) |
| void | itemSelected(int index) |
Description détaillée
Cette classe sert de passerelle entre l'interface utilisateur et la méthode de saisie qui fournit les données pour les listes de sélection.
Documentation sur les types de membres
enum class QVirtualKeyboardSelectionListModel::DictionaryType
Cette énumération spécifie le type de dictionnaire d'un mot.
| Constante | Valeur | Description |
|---|---|---|
QVirtualKeyboardSelectionListModel::DictionaryType::Default | 0 | Le mot candidat provient du dictionnaire par défaut. |
QVirtualKeyboardSelectionListModel::DictionaryType::User | 1 | Le mot candidat provient du dictionnaire utilisateur. |
enum class QVirtualKeyboardSelectionListModel::Role
Cette énumération précise la nature des données demandées.
| Constante | Valeur | Description |
|---|---|---|
QVirtualKeyboardSelectionListModel::Role::Display | Qt::DisplayRole | Les données doivent être affichées sous forme de texte. |
QVirtualKeyboardSelectionListModel::Role::DisplayRole | Display | obsolete Utilisez Role::Display. |
QVirtualKeyboardSelectionListModel::Role::WordCompletionLength | Qt::UserRole + 1 | Un entier spécifiant la longueur de la partie de suggestion exprimée en nombre de caractères comptés à partir de la fin de la chaîne. |
QVirtualKeyboardSelectionListModel::Role::WordCompletionLengthRole | WordCompletionLength | obsolete Utilisez Role::WordCompletionLength. |
QVirtualKeyboardSelectionListModel::Role::Dictionary | 258 | Un entier spécifiant l {QVirtualKeyboardSelectionListModel::DictionaryType}{type de dictionnaire}. |
QVirtualKeyboardSelectionListModel::Role::CanRemoveSuggestion | 259 | Une 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.
| Constante | Valeur | Description |
|---|---|---|
QVirtualKeyboardSelectionListModel::Type::WordCandidateList | 0 | Affiche la liste des mots proposés. |
Documentation des fonctions membres
[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 surbrillance l'élément situé à l'adresse index dans la liste.
[signal] void QVirtualKeyboardSelectionListModel::itemSelected(int index)
Ce signal est émis lorsqu'un élément de la page index est sélectionné par l'utilisateur.
[invokable] void QVirtualKeyboardSelectionListModel::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.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis 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 situé à la position index dans la liste. La sélection est transmise à la méthode de saisie pour un traitement ultérieur.
Remarque : cette fonction peut être invoquée via le système de méta-objets et depuis 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.
