En esta página

KeyboardLayout QML Type

Disposición del teclado. Más...

Import Statement: import QtQuick.VirtualKeyboard.Components
Inherits:

ColumnLayout

Propiedades

Métodos

Descripción detallada

Este tipo es el elemento raíz de la distribución del teclado. Utilice este elemento para crear una nueva distribución del teclado.

Ejemplo:

import QtQuick
import QtQuick.Layouts
import QtQuick.VirtualKeyboard

// file: layouts/en_GB/main.qml

KeyboardLayout {
    KeyboardRow {
        Key {
            key: Qt.Key_Q
            text: "q"
        }
        Key {
            key: Qt.Key_W
            text: "w"
        }
        Key {
            key: Qt.Key_E
            text: "e"
        }
        Key {
            key: Qt.Key_R
            text: "r"
        }
        Key {
            key: Qt.Key_T
            text: "t"
        }
        Key {
            key: Qt.Key_Y
            text: "y"
        }
    }
}

Documentación de propiedades

inputMethod : var

Establece el método de entrada que se utilizará en este diseño.

Esta propiedad permite utilizar un método de entrada personalizado en este diseño.

inputMode : int

Establece el modo de entrada que se utilizará en esta distribución.

Por defecto, el teclado virtual intenta conservar el modo de entrada actual al cambiar a una distribución de teclado diferente.

Si el modo de entrada actual no es válido en el contexto actual, el modo de entrada predeterminado se especifica mediante el método de entrada.

keyWeight : real

Establece el peso de la clave para todas las claves hijas.

El valor por defecto se hereda del elemento padre en la jerarquía de diseño.

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.

smallTextVisible : bool [since QtQuick.VirtualKeyboard 2.0]

Establece la dirección smallTextVisible para todas las claves hijas.

El valor por defecto se hereda del elemento padre en la jerarquía de diseño.

Esta propiedad fue introducida en QtQuick.VirtualKeyboard 2.0.

Documentación del método

createInputMethod()

Esta función puede ser sobrescrita por la distribución del teclado para crear el objeto de método de entrada dinámicamente. La implementación por defecto devuelve null.

El objeto de método de entrada creado por esta función puede sobrevivir a las transiciones de distribución del teclado en ciertos casos. 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.