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 es útil para distribuciones de teclado que constan de varias páginas de teclas.

Una única distribución de teclado (una página) se define utilizando el Componente como contenedor. La distribución de teclado activa puede cambiarse estableciendo un valor diferente en la propiedad sourceComponent.

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 propiedades

inputMethod : var

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

El método de entrada puede establecerse por separado para cada distribución de teclado, o de forma común en este contexto. Si se establece 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 establecerse por separado para cada distribución de teclado, o de forma común en este contexto. Si se establece por separado, esta propiedad no debe modificarse.

sharedLayouts : var

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

Si la lista está vacía (por defecto), el método de entrada no se comparte con ninguna otra presentación y se destruirá cuando cambie la presentación.

La lista debe contener únicamente el nombre del tipo de presentación, por ejemplo, ['symbols']. La disposición actual no tiene por qué estar incluida 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 método de entrada dinámicamente. La implementación predeterminada reenvía la llamada a la distribución de teclado secundaria.

En algunos casos, el objeto método de entrada creado por esta función puede sobrevivir a las transiciones entre distribuciones de teclado. En particular, esto se aplica a las transiciones entre las distribuciones listadas 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.