En esta página

QVirtualKeyboardSelectionListModel Class

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

Cabecera: #include <QVirtualKeyboardSelectionListModel>
CMake: find_package(Qt6 REQUIRED COMPONENTS VirtualKeyboard)
target_link_libraries(mytarget PRIVATE Qt6::VirtualKeyboard)
qmake: QT += virtualkeyboard
En QML: SelectionListModel
Hereda: 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

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

Señales

void activeItemChanged(int index)
void countChanged()
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 tipos de miembros

enum class QVirtualKeyboardSelectionListModel::DictionaryType

Este enum especifica el tipo de diccionario de una palabra.

ConstanteValorDescripción
QVirtualKeyboardSelectionListModel::DictionaryType::Default0La palabra candidata es del diccionario por defecto.
QVirtualKeyboardSelectionListModel::DictionaryType::User1La palabra candidata es del diccionario del usuario.

enum class QVirtualKeyboardSelectionListModel::Role

Este enum especifica una función de los datos solicitados.

ConstanteValorDescripción
QVirtualKeyboardSelectionListModel::Role::DisplayQt::DisplayRoleLos datos a mostrar en forma de texto.
QVirtualKeyboardSelectionListModel::Role::DisplayRoleDisplayobsolete Utilice Role::Display.
QVirtualKeyboardSelectionListModel::Role::WordCompletionLengthQt::UserRole + 1Un número entero que especifica la longitud de la palabra que completa la parte expresada como el número de caracteres contados desde el final de la cadena.
QVirtualKeyboardSelectionListModel::Role::WordCompletionLengthRoleWordCompletionLengthobsolete Utilice 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

Este enum especifica el tipo de lista de selección.

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

Documentación de la Función 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 en index en la lista.

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

Esta señal se emite cuando el usuario selecciona un elemento en index.

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

Este método debe ser llamado cuando el usuario elimina un elemento en la posición index de la lista. La eliminación se reenvía al método de entrada para su posterior procesamiento.

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

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

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

Nota: Esta función puede invocarse 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.