QtShellChrome QML Type
Ofrece la funcionalidad predeterminada de un gestor de ventanas para su uso con la extensión « qt-shell ». Más información...
| Import Statement: | import QtWayland.Compositor.QtShell |
| Since: | Qt 6.3 |
Propiedades
- bottomLeftResizeHandle : Item
- bottomResizeHandle : Item
- bottomRightResizeHandle : Item
- frameMarginBottom : int
- frameMarginLeft : int
- frameMarginRight : int
- frameMarginTop : int
- hasDecorations : bool
- leftResizeHandle : Item
- maximizedRect : rect
- rightResizeHandle : Item
- shellSurfaceItem : ShellSurfaceItem
- titleBar : Item
- topLeftResizeHandle : Item
- topResizeHandle : Item
- topRightResizeHandle : Item
- windowFlags : int
- windowState : int
Métodos
- void activate()
- void deactivate()
- void lower()
- void raise()
- void toggleFullScreen()
- void toggleMaximized()
- void toggleMinimized()
Descripción detallada
QtShellChrome es un tipo de conveniencia que se puede utilizar para proporcionar funcionalidad de gestor de ventanas a la interacción con los clientes a través del protocolo de extensión de shell qt-shell.
Dado un ShellSurfaceItem con un QtShellSurface asociado, el elemento adaptará automáticamente su tamaño para ajustarse a la superficie. También proporcionará gestión automática de:
- Los estados de las ventanas, como maximizada, minimizada y a pantalla completa.
- La activación de la ventana.
- El cambio de tamaño de la ventana mediante los controladores de redimensionamiento (si se han configurado las propiedades adecuadas).
- El reposicionamiento de la ventana mediante la interacción con la barra de título (si se ha establecido la propiedad ` titleBar `).
QtShellChrome está pensado para utilizarse junto con QtShell y QtShellSurface.
Véase también QtShell Compositor.
Documentación de propiedades
bottomLeftResizeHandle : Item
Esta propiedad contiene el controlador de redimensionamiento predeterminado situado en la esquina inferior izquierda de la ventana « QtShellChrome ». Si se configura, se instalará un controlador de redimensionamiento « DragHandler » en dicho controlador, que redimensionará la ventana moviendo sus bordes inferior e izquierdo en la misma proporción.
El controlador se ocultará y mostrará automáticamente, en función de los indicadores de la ventana y de si esta se encuentra en modo de pantalla completa.
QtShellChrome {
Rectangle {
id: blrh
anchors.bottom: parent.bottom
anchors.left: parent.left
height: 5
width: 5
color: "white"
}
bottomLeftResizeHandle: blrh
}bottomResizeHandle : Item
Esta propiedad contiene el controlador de redimensionamiento inferior predeterminado de la clase ` QtShellChrome`. Si se establece, se instalará un controlador de redimensionamiento ( DragHandler ) en dicho controlador, que permite redimensionar la ventana moviendo su borde inferior.
El control de redimensionamiento se ocultará y mostrará automáticamente, en función de los indicadores de la ventana y de si esta se encuentra en modo de pantalla completa.
QtShellChrome {
Rectangle {
id: brh
anchors.bottom: parent.bottom
anchors.left: parent.left
anchors.right: parent.right
height: 5
color: "white"
}
bottomResizeHandle: brh
}Nota: A menos que se establezcan márgenes de marco explícitos, la altura del controlador se incluirá en el margen inferior del marco de la ventana.
bottomRightResizeHandle : Item
Esta propiedad contiene el controlador de redimensionamiento predeterminado situado en la esquina inferior derecha de la ventana de la clase « QtShellChrome ». Si se establece, se instalará un « DragHandler » en el controlador de redimensionamiento, lo que permite redimensionar la ventana desplazando sus bordes inferior y derecho en la misma medida.
El controlador se ocultará y se mostrará automáticamente, dependiendo de los indicadores de la ventana y de si esta se encuentra en modo de pantalla completa.
QtShellChrome {
Rectangle {
id: brrh
anchors.bottom: parent.bottom
anchors.right: parent.right
height: 5
width: 5
color: "white"
}
bottomRightResizeHandle: brrh
}frameMarginBottom : int
Establece el tamaño del margen inferior del « QtShellChrome », que se reserva para las decoraciones de la ventana. Por defecto, este valor será igual a la altura del « bottomResizeHandle » si se ha establecido. De lo contrario, será 0.
Nota: Al establecer esta propiedad de forma explícita, todos los márgenes predeterminados del marco quedarán anulados por sus propiedades correspondientes.
frameMarginLeft : int
Establece el tamaño del margen izquierdo de la propiedad « QtShellChrome », que se reserva para las decoraciones de la ventana. Por defecto, este valor será igual al ancho de la propiedad « leftResizeHandle » si se ha establecido. De lo contrario, será 0.
Nota: Al establecer esta propiedad de forma explícita, todos los márgenes predeterminados del marco se anularán con sus propiedades correspondientes.
frameMarginRight : int
Establece el tamaño del margen derecho del « QtShellChrome », que se reserva para los elementos decorativos de la ventana. Por defecto, este valor será igual al ancho del « rightResizeHandle » si se ha establecido. De lo contrario, será 0.
Nota: Al establecer esta propiedad de forma explícita, todos los márgenes predeterminados del marco quedarán anulados por sus propiedades correspondientes.
frameMarginTop : int
Establece el tamaño del margen superior de la ventana « QtShellChrome », que se reserva para las decoraciones de la ventana. Por defecto, este valor será igual a la suma de las alturas de « leftResizeHandle » y « titleBar », si se han definido. De lo contrario, será 0.
Nota: Al establecer esta propiedad de forma explícita, todos los márgenes predeterminados del marco quedarán anulados por sus propiedades correspondientes.
hasDecorations : bool [read-only]
Esta propiedad es verdadera si las decoraciones del objeto ` QtShellChrome` deben estar visibles, en función del estado de la ventana y de sus indicadores.
leftResizeHandle : Item
Esta propiedad contiene el controlador de redimensionamiento izquierdo predeterminado de QtShellChrome. Si se configura, se instalará un controlador de redimensionamiento ( DragHandler ) en dicho controlador, que permite redimensionar la ventana moviendo su borde izquierdo.
El controlador se ocultará y mostrará automáticamente, dependiendo de los indicadores de la ventana y de si esta se encuentra en modo de pantalla completa.
QtShellChrome {
Rectangle {
id: lrh
anchors.left: parent.left
anchors.top: parent.top
anchors.bottom: parent.bottom
width: 5
color: "white"
}
leftResizeHandle: lrh
}Nota: A menos que se hayan establecido márgenes de marco explícitos, el ancho del controlador se incluirá en el margen izquierdo del marco de la ventana.
maximizedRect : rect
Esta propiedad define el área de la ventana « WaylandOutput », que la ventana puede ocupar cuando se encuentra maximizada. Por defecto, la ventana ocupará toda la geometría de la ventana « WaylandOutput » cuando esté maximizada. Modificar este valor puede resultar útil, por ejemplo, cuando el compositor tenga otros elementos de la interfaz de usuario del sistema que no deban quedar ocultos por las aplicaciones maximizadas, como la barra de tareas.
rightResizeHandle : Item
Esta propiedad contiene el controlador de redimensionamiento predeterminado de la parte derecha de la ventana « QtShellChrome ». Si se configura, se instalará un controlador de redimensionamiento « DragHandler » en dicho controlador, que permite redimensionar la ventana moviendo su borde derecho.
El control se ocultará y mostrará automáticamente, en función de los indicadores de la ventana y de su estado a pantalla completa.
QtShellChrome {
Rectangle {
id: rrh
anchors.right: parent.right
anchors.top: parent.top
anchors.bottom: parent.bottom
width: 5
color: "white"
}
rightResizeHandle: rrh
}Nota: A menos que se hayan establecido márgenes de marco explícitos, el ancho del controlador se incluirá en el margen derecho del marco de la ventana.
shellSurfaceItem : ShellSurfaceItem
Esta propiedad contiene el elemento de superficie del shell asociado a este QtShellChrome. A su vez, gestionará el shellSurface de este elemento. Se espera que el shellSurface del elemento sea del tipo QtShellSurface.
QtShellChrome {
id: chrome
ShellSurfaceItem {
id: sfi
anchors.fill: parent
moveItem: chrome
}
shellSurfaceItem: sfi
}titleBar : Item
Esta propiedad contiene el elemento predeterminado de la barra de título del ` QtShellChrome`. Si se activa, se instalará un ` DragHandler ` en la barra de título que permitirá desplazar la ventana mediante la interacción del usuario. Además, la ventana se activará automáticamente al hacer clic en la barra de título.
La barra de título se ocultará y mostrará automáticamente, dependiendo de los indicadores de la ventana y de si esta se encuentra en modo de pantalla completa.
QtShellChrome {
Rectangle {
id: tb
anchors.top: parent.top
anchors.right: parent.right
anchors.left: parent.left
height: 50
color: "black"
Text {
color: "white"
anchors.centerIn: parent
text: shellSurfaceItem.shellSurface.windowTitle
font.pixelSize: 25
}
}
titleBar: tb
}Nota: A menos que se establezcan márgenes de marco explícitos, la altura de la barra de título se incluirá en el margen superior del marco de la ventana.
topLeftResizeHandle : Item
Esta propiedad contiene el controlador de redimensionamiento predeterminado situado en la esquina superior izquierda de la ventana « QtShellChrome ». Si se establece, se instalará un controlador de redimensionamiento « DragHandler » en dicho controlador, que redimensionará la ventana desplazando sus bordes superior e izquierdo en la misma cantidad.
El controlador se ocultará y mostrará automáticamente, en función de los indicadores de la ventana y de si esta se encuentra en modo de pantalla completa.
QtShellChrome {
Rectangle {
id: tlrh
anchors.top: parent.top
anchors.left: parent.left
height: 5
width: 5
color: "white"
}
topLeftResizeHandle: tlrh
}topResizeHandle : Item
Esta propiedad contiene el controlador de redimensionamiento superior predeterminado de la clase ` QtShellChrome`. Si se establece, se instalará un controlador de redimensionamiento superior ( DragHandler ) en el controlador de redimensionamiento, lo que permite redimensionar la ventana moviendo su borde superior.
El control de redimensionamiento se ocultará y mostrará automáticamente, en función de los indicadores de la ventana y de si esta se encuentra en modo de pantalla completa.
QtShellChrome {
Rectangle {
id: trh
anchors.top: parent.top
anchors.left: parent.left
anchors.right: parent.right
height: 5
color: "white"
}
topResizeHandle: trh
}Nota: A menos que se establezcan márgenes de marco explícitos, la altura del controlador se incluirá en el margen superior del marco de la ventana.
topRightResizeHandle : Item
Esta propiedad contiene el controlador de redimensionamiento predeterminado situado en la esquina superior derecha de la ventana « QtShellChrome ». Si se configura, se instalará un controlador de redimensionamiento « DragHandler » en dicho controlador, que redimensionará la ventana moviendo sus bordes superior y derecho en la misma proporción.
El controlador se ocultará y mostrará automáticamente, dependiendo de los indicadores de la ventana y de si esta se encuentra en modo de pantalla completa.
QtShellChrome {
Rectangle {
id: trrh
anchors.top: parent.top
anchors.right: parent.right
height: 5
width: 5
color: "white"
}
topRightResizeHandle: trrh
}windowFlags : int [read-only]
Esta propiedad contiene los indicadores de ventana del objeto ` QtShellChrome`. Estos coincidirán con la propiedad ` windowFlags ` del objeto ` QtShellSurface` asociado, salvo cuando esta sea igual a `Qt.Window`. En ese caso, se utilizará en su lugar un conjunto de indicadores de ventana predeterminados. Los indicadores de ventana predeterminados son Qt.Window, Qt.WindowMaximizeButtonHint, Qt.WindowMinimizeButtonHint y Qt.WindowCloseButtonHint.
windowState : int [read-only]
Esta propiedad contiene el estado de la ventana de la superficie del shell. Se actualizará inmediatamente cuando se solicite el estado de la ventana desde el compositor, antes de que el cliente haya confirmado dicha solicitud. Por lo tanto, puede diferir durante breves periodos de tiempo de la propiedad « windowState » de la superficie del shell, que se actualizará cuando el cliente haya confirmado la solicitud.
Documentación del método
void activate()
Activa esta ventana manualmente. Esto también hará que la ventana se muestre en primer plano.
Véase también raise().
void deactivate()
Desactiva manualmente esta ventana. Si la ventana estaba activa, esta acción activará en su lugar la siguiente ventana de la pila.
void lower()
Baja esta ventana para que quede apilada debajo de otras ventanas (salvo que los indicadores de la otra ventana lo impidan).
void raise()
Muestra esta ventana de forma que se sitúe encima de las demás (salvo que los ajustes de las otras ventanas lo impidan).
void toggleFullScreen()
Alterna entre los estados de pantalla completa y ventana normal. Este método también borra los estados de ventana minimizada o maximizada, si alguno de ellos está activado.
void toggleMaximized()
Alterna entre los estados maximizado y normal. Este método también borra el estado de ventana minimizada si está activado.
void toggleMinimized()
Alterna entre los estados minimizado y normal. Este método también desactiva el estado de ventana maximizada si está activado.
© 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.