En esta página

QVirtualKeyboardSelectionListModel Class

Modelo de lista para listas de selección. Más...

Encabezado: #include <QVirtualKeyboardSelectionListModel>
CMake: find_package(Qt6 REQUIRED COMPONENTS VirtualKeyboard)
target_link_libraries(mytarget PRIVATE Qt6::VirtualKeyboard)
qmake: QT += virtualkeyboard
En QML: SelectionListModel
Heredan: QAbstractListModel

Tipos públicos

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

Funciones públicas

void removeItem(int index)
void selectItem(int index)

Señales

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

Descripción detallada

Esta clase actúa como puente entre la interfaz de usuario y el método de entrada que proporciona los datos para las listas de selección.

Documentación de los tipos de miembros

enum class QVirtualKeyboardSelectionListModel::DictionaryType

Esta enumeración especifica el tipo de diccionario de una palabra.

ConstanteValorDescripción
QVirtualKeyboardSelectionListModel::DictionaryType::Default0La palabra candidata procede del diccionario predeterminado.
QVirtualKeyboardSelectionListModel::DictionaryType::User1La palabra candidata procede del diccionario del usuario.

enum class QVirtualKeyboardSelectionListModel::Role

Esta enumeración especifica la función de los datos solicitados.

ConstanteValorDescripción
QVirtualKeyboardSelectionListModel::Role::DisplayQt::DisplayRoleLos datos que se van a mostrar en forma de texto.
QVirtualKeyboardSelectionListModel::Role::DisplayRoleDisplayobsolete Utiliza Role::Display.
QVirtualKeyboardSelectionListModel::Role::WordCompletionLengthQt::UserRole + 1Un número entero que especifica la longitud de la palabra que se completará, expresada como el número de caracteres contados desde el final de la cadena.
QVirtualKeyboardSelectionListModel::Role::WordCompletionLengthRoleWordCompletionLengthobsolete Utiliza Role::WordCompletionLength.
QVirtualKeyboardSelectionListModel::Role::Dictionary258Un entero que especifica l {QVirtualKeyboardSelectionListModel::DictionaryType}{tipo de diccionario}.
QVirtualKeyboardSelectionListModel::Role::CanRemoveSuggestion259Un valor booleano que indica si la palabra candidata puede eliminarse del diccionario.

enum class QVirtualKeyboardSelectionListModel::Type

Esta enumeración especifica el tipo de lista de selección.

ConstanteValorDescripción
QVirtualKeyboardSelectionListModel::Type::WordCandidateList0Muestra una lista de palabras candidatas.

Documentación de las funciones de miembro

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

Esta señal se emite cuando cambia el elemento activo de la lista. La interfaz de usuario debe reaccionar a esta señal resaltando el elemento situado en index de la lista.

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

Esta señal se emite cuando el usuario selecciona un artículo en index.

[invokable] void QVirtualKeyboardSelectionListModel::removeItem(int index)

Este método debe invocarse cuando el usuario elimina un elemento de la lista situado en la posición index. La eliminación se remite al método de entrada para su posterior procesamiento.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] void QVirtualKeyboardSelectionListModel::selectItem(int index)

Este método debe invocarse cuando el usuario selecciona un elemento situado en la posición index de la lista. La selección se envía al método de entrada para su posterior procesamiento.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase 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.