KeyNavigation QML Type (Uncreatable)
Admite la navegación mediante las teclas de flecha. Más...
| Import Statement: | import QtQuick |
Nota: Se trata de un tipo no creable. No se puede instanciar en QML.
Propiedades asociadas
Descripción detallada
Las interfaces de usuario basadas en teclas suelen permitir el uso de las teclas de flecha para navegar entre los elementos en los que se puede establecer el foco. El tipo de adjunto KeyNavigation habilita este comportamiento al proporcionar una forma cómoda de especificar el elemento que debe recibir el foco cuando se pulsa una tecla de flecha o la tecla Tab.
El siguiente ejemplo muestra la navegación mediante teclas para una cuadrícula de 2x2 elementos:
import QtQuick
Grid {
width: 100; height: 100
columns: 2
Rectangle {
id: topLeft
width: 50; height: 50
color: focus ? "red" : "lightgray"
focus: true
KeyNavigation.right: topRight
KeyNavigation.down: bottomLeft
}
Rectangle {
id: topRight
width: 50; height: 50
color: focus ? "red" : "lightgray"
KeyNavigation.left: topLeft
KeyNavigation.down: bottomRight
}
Rectangle {
id: bottomLeft
width: 50; height: 50
color: focus ? "red" : "lightgray"
KeyNavigation.right: bottomRight
KeyNavigation.up: topLeft
}
Rectangle {
id: bottomRight
width: 50; height: 50
color: focus ? "red" : "lightgray"
KeyNavigation.left: bottomLeft
KeyNavigation.up: topRight
}
}El elemento de la esquina superior izquierda recibe inicialmente el foco al establecer ` focus ` en ` true`. Cuando se pulsa una tecla de flecha, el foco se desplazará al elemento correspondiente, tal y como se define mediante el valor establecido para las propiedades ` left`, ` right`, ` up ` o ` down ` de `KeyNavigation`.
Tenga en cuenta que, si un tipo de acoplamiento de KeyNavigation recibe los eventos de pulsación y liberación de una tecla de flecha o de tabulación solicitada, el evento se acepta y no se propaga más allá.
De forma predeterminada, KeyNavigation recibe los eventos de tecla después del elemento al que está asociado. Si el elemento acepta el evento de tecla, el tipo asociado a KeyNavigation no recibirá un evento para esa tecla. Al establecer la propiedad ` priority ` en ` KeyNavigation.BeforeItem `, se permite que el evento se utilice para la navegación por teclas antes del elemento, en lugar de después.
Si el elemento al que se va a cambiar el foco no está habilitado o no es visible, se intentará omitir este elemento y centrar el foco en el siguiente. Esto es posible si hay una cadena de elementos con el mismo controlador de KeyNavigation. Si varios elementos consecutivos no están habilitados o no son visibles, también se omitirán.
KeyNavigation establecerá implícitamente la otra dirección para devolver el foco a este elemento. Así pues, si se establece « left » en otro elemento, se definirá « right » en el controlador KeyNavigation de ese elemento para devolver el foco a este elemento. Sin embargo, si en el KeyNavigation de ese elemento se ha establecido explícitamente la dirección «derecha», no se producirá ningún cambio. Esto significa que el ejemplo anterior podría lograr el mismo comportamiento sin especificar KeyNavigation.right ni KeyNavigation.down para ninguno de los elementos.
Véase también Keys attached property.
Documentación de la propiedad adjunta
KeyNavigation.backtab : Item [attached]
Esta propiedad especifica el elemento al que se debe asignar el foco cuando se pulsa la combinación de teclas Mayús+Tab (Backtab).
KeyNavigation.down : Item [attached]
Esta propiedad contiene el elemento al que se debe asignar el foco cuando se pulsa la tecla de cursor hacia abajo.
KeyNavigation.left : Item [attached]
Esta propiedad especifica el elemento al que se debe asignar el foco cuando se pulsa la tecla de cursor izquierda.
KeyNavigation.priority : enumeration [attached]
Esta propiedad determina si las claves se procesan antes o después de que el propio elemento adjunto gestione sus claves.
| Constante | Descripción |
|---|---|
KeyNavigation.BeforeItem | Procesa los eventos de tecla antes del procesamiento normal de teclas del elemento. Si el evento se utiliza para la navegación mediante teclas, se aceptará y no se transmitirá al elemento. |
KeyNavigation.AfterItem | (por defecto) procesa los eventos de tecla después del procesamiento normal de teclas del elemento. Si el elemento acepta el evento de tecla, este no será gestionado por el controlador de la propiedad adjunta « KeyNavigation ». |
KeyNavigation.right : Item [attached]
Esta propiedad contiene el elemento al que se debe asignar el foco cuando se pulsa la tecla de cursor derecha.
KeyNavigation.tab : Item [attached]
Esta propiedad contiene el elemento al que se debe asignar el foco cuando se pulsa la tecla Tab.
KeyNavigation.up : Item [attached]
Esta propiedad contiene el elemento al que se debe asignar el foco cuando se pulsa la tecla de cursor hacia arriba.
© 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.