QVirtualKeyboardAbstractInputMethod Class

Documentación de Funciones Miembro

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

Construye un método de entrada con parent.

[virtual noexcept] QVirtualKeyboardAbstractInputMethod::~QVirtualKeyboardAbstractInputMethod()

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

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

Borra el modo de entrada.

Este método es llamado por el teclado virtual cuando este método de entrada está siendo reemplazado por otro método de entrada. Debe borrar las operaciones realizadas por el método setInputMode(), por ejemplo, para desconectar los manejadores de señales del teclado virtual o liberar recursos.

El modo de entrada puede reactivarse llamando a setInputMode(). Sin embargo, tenga en cuenta que las llamadas a setInputMethod() y clearInputMethod() no están equilibradas. Así, por ejemplo, setInputMethod() puede ser llamada varias veces sin que coincidan las llamadas a clearInputMethod().

La implementación por defecto no hace nada.

Esta función se introdujo en Qt 6.1.

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

Llamada cuando el usuario hace click en el texto pre-editado en cursorPosition.

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

Esta función fue introducida en QtQuick.VirtualKeyboard 2.4.

QVirtualKeyboardInputContext *QVirtualKeyboardAbstractInputMethod::inputContext() const

Devuelve el contexto de entrada asociado al método de entrada. Este método devuelve 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 propósito de este método es manejar los eventos clave generados por el motor de entrada.

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

Este método devuelve true si el evento de clave se ha gestionado correctamente. Si el valor devuelto es false, el evento de clave 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 la lista de modos de reconocimiento de patrones soportados.

Este método es llamado por el motor de entrada para consultar la lista de modos de reconocimiento de patrones soportados.

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 cursorPosition. En reselectFlags se definen las reglas de selección de la palabra en relación con la posición del cursor.

La función devuelve true si la palabra ha sido seleccionada con éxito.

Esta función fue introducida en QtQuick.VirtualKeyboard 2.0.

[virtual slot] void QVirtualKeyboardAbstractInputMethod::reset()

Este método es llamado por el motor de entrada cuando el método de entrada necesita ser reiniciado. El método de entrada sólo debe restablecer su estado interno. La principal diferencia con el método update() es que reset() sólo 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 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 el contenido de la lista de selección ha cambiado. 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 del elemento 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 basado en cero dentro de la lista.

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

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

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

Se llama a este método cuando el usuario ha seleccionado un elemento en 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 ejecuta cuando un elemento de index debe eliminarse del diccionario. 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 utilizadas por este método de entrada.

Este método es llamado por el motor de entrada cuando el método de entrada está siendo activado y cada vez que las sugerencias del método de entrada son actualizadas. 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 la señal selectionListsChanged(). Esta señal activará una llamada a este método, permitiendo al método de entrada actualizar los tipos de lista de selección.

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

El método de entrada emite esta señal cuando los tipos de la lista de selección han cambiado. Esta señal activará una llamada al método selectionLists(), permitiendo 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 inputMode y locale para este método de entrada. Devuelve true si tiene éxito.

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

Actualiza el textCase para este método de entrada. El método devuelve true si tiene éxito.

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

Se llama a este método cuando se inicia una interacción de rastreo con el patternRecognitionMode especificado. La traza se identifica unívocamente 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 la 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 QVirtualKeyboardTrace es renderizado en pantalla, permanece allí hasta que el objeto QVirtualKeyboardTrace es destruido.

Esta función fue introducida en QtQuick.VirtualKeyboard 2.0.

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

Se llama a este método cuando finaliza la interacción de rastreo. El método de entrada debe destruir el objeto trace en algún momento después de que se llame a esta función. Consulte la API de rastreo para métodos de entrada sobre cómo acceder a los datos recopilados.

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

Esta función fue introducida en QtQuick.VirtualKeyboard 2.0.

[virtual slot] void QVirtualKeyboardAbstractInputMethod::update()

Este método es llamado por el motor de entrada cuando el método de entrada necesita ser actualizado. El método de entrada debe cerrar el texto actual previo a la edición y restaurar su estado interno al predeterminado.