En esta página

QVirtualKeyboardAbstractInputMethod Class

La clase base para los métodos de entrada. Más...

Encabezado: #include <QVirtualKeyboardAbstractInputMethod>
CMake: find_package(Qt6 REQUIRED COMPONENTS VirtualKeyboard)
target_link_libraries(mytarget PRIVATE Qt6::VirtualKeyboard)
qmake: QT += virtualkeyboard
Heredado de: QObject

Funciones públicas

QVirtualKeyboardAbstractInputMethod(QObject *parent = nullptr)
virtual ~QVirtualKeyboardAbstractInputMethod()
(since QtQuick.VirtualKeyboard 2.4) virtual bool clickPreeditText(int cursorPosition)
QVirtualKeyboardInputContext *inputContext() const
QVirtualKeyboardInputEngine *inputEngine() const
virtual QList<QVirtualKeyboardInputEngine::InputMode> inputModes(const QString &locale) = 0
virtual bool keyEvent(Qt::Key key, const QString &text, Qt::KeyboardModifiers modifiers) = 0
(since QtQuick.VirtualKeyboard 2.0) virtual QList<QVirtualKeyboardInputEngine::PatternRecognitionMode> patternRecognitionModes() const
(since QtQuick.VirtualKeyboard 2.0) virtual bool reselect(int cursorPosition, const QVirtualKeyboardInputEngine::ReselectFlags &reselectFlags)
virtual QVariant selectionListData(QVirtualKeyboardSelectionListModel::Type type, int index, QVirtualKeyboardSelectionListModel::Role role)
virtual int selectionListItemCount(QVirtualKeyboardSelectionListModel::Type type)
virtual void selectionListItemSelected(QVirtualKeyboardSelectionListModel::Type type, int index)
virtual bool selectionListRemoveItem(QVirtualKeyboardSelectionListModel::Type type, int index)
virtual QList<QVirtualKeyboardSelectionListModel::Type> selectionLists()
virtual bool setInputMode(const QString &locale, QVirtualKeyboardInputEngine::InputMode inputMode) = 0
virtual bool setTextCase(QVirtualKeyboardInputEngine::TextCase textCase) = 0
(since QtQuick.VirtualKeyboard 2.0) virtual QVirtualKeyboardTrace *traceBegin(int traceId, QVirtualKeyboardInputEngine::PatternRecognitionMode patternRecognitionMode, const QVariantMap &traceCaptureDeviceInfo, const QVariantMap &traceScreenInfo)
(since QtQuick.VirtualKeyboard 2.0) virtual bool traceEnd(QVirtualKeyboardTrace *trace)

Ranuras públicas

(since 6.1) virtual void clearInputMode()
virtual void reset()
virtual void update()

Señales

void selectionListActiveItemChanged(QVirtualKeyboardSelectionListModel::Type type, int index)
void selectionListChanged(QVirtualKeyboardSelectionListModel::Type type)
(since QtQuick.VirtualKeyboard 2.2) void selectionListsChanged()

Descripción detallada

Utiliza esta clase si deseas implementar un método de entrada personalizado utilizando el lenguaje C/C++.

Documentación de las funciones miembro

[explicit] QVirtualKeyboardAbstractInputMethod::QVirtualKeyboardAbstractInputMethod(QObject *parent = nullptr)

Crea un método de entrada con parent.

[virtual noexcept] QVirtualKeyboardAbstractInputMethod::~QVirtualKeyboardAbstractInputMethod()

Elimina el método de entrada y libera todos los recursos asignados.

[virtual slot, since 6.1] void QVirtualKeyboardAbstractInputMethod::clearInputMode()

Borra el modo de entrada.

El teclado virtual invoca este método cuando este método de entrada va a ser sustituido por otro. Debe borrar las operaciones realizadas por el método ` setInputMode()`, por ejemplo, para desconectar los controladores de señales del teclado virtual o liberar recursos.

El modo de entrada puede reactivarse llamando a ` setInputMode()`. Sin embargo, hay que tener en cuenta que las llamadas a `setInputMethod()` y `clearInputMethod()` no están equilibradas. Así, por ejemplo, `setInputMethod()` puede llamarse varias veces sin que haya llamadas correspondientes a `clearInputMethod()`.

La implementación por defecto no realiza ninguna acción.

Esta función se introdujo en Qt 6.1.

[virtual, since QtQuick.VirtualKeyboard 2.4] bool QVirtualKeyboardAbstractInputMethod::clickPreeditText(int cursorPosition)

Se invoca cuando el usuario hace clic en el texto de preedición en cursorPosition.

La función debe devolver true si gestiona el evento. De lo contrario, la entrada se redirige a reselect() para su posterior procesamiento.

Esta función se introdujo en QtQuick.VirtualKeyboard 2.4.

QVirtualKeyboardInputContext *QVirtualKeyboardAbstractInputMethod::inputContext() const

Devuelve el contexto de entrada asociado al método de entrada. Este método devuelve un objeto ` NULL ` si el método de entrada no está activo.

QVirtualKeyboardInputEngine *QVirtualKeyboardAbstractInputMethod::inputEngine() const

Devuelve el motor de entrada asociado al método de entrada. Este método devuelve « NULL » si el método de entrada no está activo.

[pure virtual] QList<QVirtualKeyboardInputEngine::InputMode> QVirtualKeyboardAbstractInputMethod::inputModes(const QString &locale)

Devuelve la lista de modos de entrada para ` locale`.

[pure virtual] bool QVirtualKeyboardAbstractInputMethod::keyEvent(Qt::Key key, const QString &text, Qt::KeyboardModifiers modifiers)

El objetivo de este método es gestionar los eventos de teclas generados por el motor de entrada.

El parámetro « key » especifica el código de la tecla que se va a gestionar. El código de la tecla no distingue entre mayúsculas y minúsculas. El parámetro « text » contiene el texto Unicode correspondiente a la tecla. El parámetro « modifiers » contiene los modificadores de tecla que se aplican a dicha tecla.

Este método devuelve true si el evento de tecla se ha gestionado correctamente. Si el valor devuelto es false, el evento de tecla se redirige al método de entrada predeterminado para su posterior procesamiento.

[virtual, since QtQuick.VirtualKeyboard 2.0] QList<QVirtualKeyboardInputEngine::PatternRecognitionMode> QVirtualKeyboardAbstractInputMethod::patternRecognitionModes() const

Devuelve una lista de los modos de reconocimiento de patrones compatibles.

El motor de entrada invoca este método para consultar la lista de modos de reconocimiento de patrones compatibles.

Esta función se introdujo en QtQuick.VirtualKeyboard 2.0.

[virtual, since QtQuick.VirtualKeyboard 2.0] bool QVirtualKeyboardAbstractInputMethod::reselect(int cursorPosition, const QVirtualKeyboardInputEngine::ReselectFlags &reselectFlags)

Esta función intenta volver a seleccionar una palabra situada en la posición cursorPosition. El parámetro reselectFlags define las reglas según las cuales debe seleccionarse la palabra en relación con la posición del cursor.

La función devuelve true si la palabra se ha vuelto a seleccionar correctamente.

Esta función se introdujo en QtQuick.VirtualKeyboard 2.0.

[virtual slot] void QVirtualKeyboardAbstractInputMethod::reset()

El motor de entrada invoca este método cuando es necesario restablecer el método de entrada. El método de entrada solo debe restablecer su estado interno. La principal diferencia con respecto al método update() es que reset() solo modifica el estado del método de entrada; es decir, no debe modificar el contexto de entrada.

[signal] void QVirtualKeyboardAbstractInputMethod::selectionListActiveItemChanged(QVirtualKeyboardSelectionListModel::Type type, int index)

El método de entrada emite esta señal cuando el elemento « index » actual ha cambiado en la lista de selección identificada por « type ».

[signal] void QVirtualKeyboardAbstractInputMethod::selectionListChanged(QVirtualKeyboardSelectionListModel::Type type)

El método de entrada emite esta señal cuando cambia el contenido de la lista de selección. El parámetro « type » especifica qué lista de selección ha cambiado.

[virtual] QVariant QVirtualKeyboardAbstractInputMethod::selectionListData(QVirtualKeyboardSelectionListModel::Type type, int index, QVirtualKeyboardSelectionListModel::Role role)

Devuelve los datos de los elementos de la lista de selección identificada por ` type`. El parámetro ` role ` especifica qué datos se solicitan. El parámetro ` index ` es un índice de la lista que comienza en cero.

[virtual] int QVirtualKeyboardAbstractInputMethod::selectionListItemCount(QVirtualKeyboardSelectionListModel::Type type)

Devuelve el número de elementos de la lista de selección identificada por ` type`.

[virtual] void QVirtualKeyboardAbstractInputMethod::selectionListItemSelected(QVirtualKeyboardSelectionListModel::Type type, int index)

Este método se invoca cuando el usuario ha seleccionado un elemento de index. La lista de selección se identifica mediante el parámetro type.

[virtual] bool QVirtualKeyboardAbstractInputMethod::selectionListRemoveItem(QVirtualKeyboardSelectionListModel::Type type, int index)

Este método se invoca cuando es necesario eliminar del diccionario un elemento de index. La lista de selección se identifica mediante el parámetro type. La función devuelve true si la palabra se ha eliminado correctamente.

[virtual] QList<QVirtualKeyboardSelectionListModel::Type> QVirtualKeyboardAbstractInputMethod::selectionLists()

Devuelve la lista de listas de selección que utiliza este método de introducción.

El motor de entrada invoca este método cuando se activa el método de entrada y cada vez que se actualizan las sugerencias del método de entrada. El método de entrada puede reservar listas de selección devolviendo los tipos de lista de selección deseados.

El método de entrada puede solicitar al motor de entrada que actualice las listas de selección en cualquier momento emitiendo una señal « selectionListsChanged()». Esta señal activará una llamada a este método, lo que permitirá al método de entrada actualizar los tipos de listas de selección.

[signal, since QtQuick.VirtualKeyboard 2.2] void QVirtualKeyboardAbstractInputMethod::selectionListsChanged()

El método de entrada emite esta señal cuando cambian los tipos de la lista de selección. Esta señal activará una llamada al método ` selectionLists()` (), lo que permite al método de entrada actualizar los tipos de la lista de selección.

Esta función se introdujo en QtQuick.VirtualKeyboard 2.2.

[pure virtual] bool QVirtualKeyboardAbstractInputMethod::setInputMode(const QString &locale, QVirtualKeyboardInputEngine::InputMode inputMode)

Establece los valores de « inputMode » y « locale » para este método de entrada. Devuelve « true » si la operación se realiza correctamente.

[pure virtual] bool QVirtualKeyboardAbstractInputMethod::setTextCase(QVirtualKeyboardInputEngine::TextCase textCase)

Actualiza el objeto ` textCase ` correspondiente a este método de entrada. El método devuelve un objeto ` true ` si la operación se realiza correctamente.

[virtual, since QtQuick.VirtualKeyboard 2.0] QVirtualKeyboardTrace *QVirtualKeyboardAbstractInputMethod::traceBegin(int traceId, QVirtualKeyboardInputEngine::PatternRecognitionMode patternRecognitionMode, const QVariantMap &traceCaptureDeviceInfo, const QVariantMap &traceScreenInfo)

Este método se invoca cuando se inicia una interacción de rastreo con el objeto ` patternRecognitionMode` especificado. El rastreo se identifica de forma única mediante el objeto ` traceId`. El objeto ` traceCaptureDeviceInfo ` proporciona información sobre el dispositivo de origen y el objeto ` traceScreenInfo ` proporciona información sobre el contexto de pantalla.

Si el método de entrada acepta el evento y desea capturar la entrada de rastreo, debe devolver un nuevo objeto ` QVirtualKeyboardTrace `. Este objeto debe permanecer válido hasta que se llame al método ` traceEnd()`. Si el objeto ` QVirtualKeyboardTrace ` se representa en pantalla, permanece allí hasta que se destruya el objeto ` QVirtualKeyboardTrace `.

Esta función se introdujo en QtQuick.VirtualKeyboard 2.0.

[virtual, since QtQuick.VirtualKeyboard 2.0] bool QVirtualKeyboardAbstractInputMethod::traceEnd(QVirtualKeyboardTrace *trace)

Este método se invoca cuando finaliza la interacción de rastreo. El método de entrada debe destruir el objeto ` trace ` en algún momento tras la invocación de esta función. Consulta la sección «API de rastreo para métodos de entrada» para saber cómo acceder a los datos recopilados.

El método devuelve un objeto ` true ` si se acepta la interacción de rastreo.

Esta función se introdujo en QtQuick.VirtualKeyboard 2.0.

[virtual slot] void QVirtualKeyboardAbstractInputMethod::update()

El motor de entrada invoca este método cuando es necesario actualizar el método de entrada. El método de entrada debe cerrar el texto de preedición actual y restablecer su estado interno a los valores por defecto.

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