Drawer QML Type
Panel lateral que se puede abrir y cerrar con un gesto de deslizamiento. Más...
| Import Statement: | import QtQuick.Controls |
| Inherits: |
Propiedades
- dragMargin : real
- edge : enumeration
- interactive : bool
(since QtQuick.Controls 2.2 (Qt 5.9)) - position : real
Descripción detallada
Drawer ofrece un panel lateral que se abre deslizando el dedo, similar a los que suelen utilizarse en las interfaces táctiles para proporcionar un punto central de navegación.
El «Drawer» puede colocarse en cualquiera de los cuatro bordes del elemento de contenido. El «Drawer» de la imagen superior está situado junto al borde izquierdo de la ventana. Para abrirlo, basta con «arrastrarlo» desde el borde izquierdo de la ventana.
import QtQuick
import QtQuick.Controls
ApplicationWindow {
id: window
visible: true
Drawer {
id: drawer
width: 0.66 * window.width
height: window.height
Label {
text: "Content goes here!"
anchors.centerIn: parent
}
}
}Drawer es un tipo especial de ventana emergente que reside en uno de los bordes de la ventana edges. Por defecto, Drawer se vincula a la ventana overlay y, por lo tanto, opera con coordenadas de ventana. También es posible establecer manualmente el parent en otro valor para que el panel se utilice en un espacio de coordenadas específico.
Drawer se puede configurar para que cubra solo una parte del borde de su ventana. El siguiente ejemplo ilustra cómo se puede colocar Drawer para que aparezca debajo del encabezado de una ventana:
import QtQuick
import QtQuick.Controls
ApplicationWindow {
id: window
visible: true
header: ToolBar { }
Drawer {
y: header.height
width: window.width * 0.6
height: window.height - header.height
}
}La propiedad ` position ` determina qué parte del cajón queda visible, con un valor comprendido entre ` 0.0 ` y ` 1.0`. No es posible establecer la coordenada x (o los márgenes horizontales) de un cajón en el borde izquierdo o derecho de la ventana, ni la coordenada y (o los márgenes verticales) de un cajón en el borde superior o inferior de la ventana.
En la imagen anterior, el contenido de la aplicación se «desplaza» por la pantalla. Esto se consigue aplicando una traslación al contenido:
import QtQuick
import QtQuick.Controls
ApplicationWindow {
id: window
width: 200
height: 228
visible: true
Drawer {
id: drawer
width: 0.66 * window.width
height: window.height
}
Label {
id: content
text: "Aa"
font.pixelSize: 96
anchors.fill: parent
verticalAlignment: Label.AlignVCenter
horizontalAlignment: Label.AlignHCenter
transform: Translate {
x: drawer.position * content.width * 0.33
}
}
}Si deseas que el contenido de la aplicación permanezca donde está cuando se abre el cajón, no apliques una traslación.
El cajón se puede configurar como un panel lateral persistente que no se puede cerrar estableciendo el cajón como « non-modal » y « non-interactive ». Consulta el ejemplo de la Galería para obtener más detalles.
Nota: En algunas plataformas, ciertos bordes pueden estar reservados para gestos del sistema y, por lo tanto, no se pueden utilizar con el «Drawer». Por ejemplo, los bordes superior e inferior pueden estar reservados para notificaciones del sistema y centros de control en Android e iOS.
Véase también SwipeView, Personalización de Drawer, Controles de navegación y Controles emergentes.
Documentación de propiedades
dragMargin : real
Esta propiedad indica la distancia desde el borde de la pantalla dentro de la cual las acciones de arrastre abrirán el cajón. Si se establece el valor en 0 o menos, se impide que el cajón se abra al arrastrar.
El valor por defecto es Application.styleHints.startDragDistance.
Véase también interactive.
edge : enumeration
Esta propiedad indica el borde de la ventana desde el que se abrirá el cajón. Los valores válidos son:
| Constante | Descripción |
|---|---|
Qt.TopEdge | El borde superior de la ventana. |
Qt.LeftEdge | El borde izquierdo de la ventana (por defecto). |
Qt.RightEdge | El borde derecho de la ventana. |
Qt.BottomEdge | El borde inferior de la ventana. |
interactive : bool [since QtQuick.Controls 2.2 (Qt 5.9)]
Esta propiedad indica si el cajón es interactivo. Un cajón no interactivo no reacciona a los deslizamientos.
El valor por defecto es « true ».
Esta propiedad se introdujo en QtQuick.Controls 2.2 (Qt 5.9).
Véase también dragMargin.
position : real
Esta propiedad indica la posición del cajón con respecto a su posición final. Es decir, la posición será 0.0 cuando el cajón esté completamente cerrado, y 1.0 cuando esté completamente abierto.
© 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.