En esta página

KeyboardLayoutLoader QML Type

Permite la carga dinámica de la distribución del teclado. Más...

Import Statement: import QtQuick.VirtualKeyboard.Components
Since: QtQuick.VirtualKeyboard 1.1
Inherits:

Loader

Propiedades

Métodos

Descripción detallada

Este tipo resulta útil para distribuciones de teclado que constan de varias páginas de teclas.

Se define una única distribución de teclado (una página) utilizando el componente como contenedor. A continuación, la distribución de teclado activa se puede cambiar estableciendo la propiedad `sourceComponent` en un valor diferente.

Ejemplo:

import QtQuick
import QtQuick.Layouts
import QtQuick.VirtualKeyboard

// file: layouts/en_GB/symbols.qml

KeyboardLayoutLoader {
    property bool secondPage
    onVisibleChanged: if (!visible) secondPage = false
    sourceComponent: secondPage ? page2 : page1
    Component {
        id: page1
        KeyboardLayout {
            // Keyboard layout definition for page 1
        }
    }
    Component {
        id: page2
        KeyboardLayout {
            // Keyboard layout definition for page 2
        }
    }
}

Documentación de la propiedad

inputMethod : var

Establece el método de entrada para todas las distribuciones de teclado cargadas en este contexto.

El método de entrada puede configurarse por separado para cada distribución de teclado o de forma global en este contexto. Si se configura por separado, esta propiedad no debe modificarse.

inputMode : int

Establece el modo de entrada para todas las distribuciones de teclado cargadas en este contexto.

El modo de entrada puede configurarse por separado para cada distribución de teclado o de forma global en este contexto. Si se configura por separado, no se debe modificar esta propiedad.

sharedLayouts : var

Lista de nombres de diseños que comparten el método de entrada creado por la función createInputMethod().

Si la lista está vacía (valor por defecto), el método de entrada no se comparte con ningún otro diseño y se eliminará cuando cambie el diseño.

La lista solo debe contener el nombre del tipo de diseño, p. ej., ['symbols']. No es necesario incluir el diseño actual en la lista.

Documentación del método

createInputMethod()

Esta función puede ser sobrescrita por la distribución de teclado para crear el objeto de método de entrada de forma dinámica. La implementación por defecto reenvía la llamada a la distribución de teclado secundaria.

El objeto de método de entrada creado por esta función puede sobrevivir a las transiciones de distribución de teclado en determinados casos. En concreto, esto se aplica a las transiciones entre las distribuciones enumeradas en la propiedad ` sharedLayouts `.

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