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: |
Propiedades
- inputMethod : var
- inputMode : int
- sharedLayouts : var
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.