QtShellSurface QML Type
Ofrece una forma sencilla de identificar y cambiar el tamaño de una superficie. Más...
| Import Statement: | import QtWayland.Compositor.QtShell |
| Since: | Qt 6.3 |
Propiedades
- active : bool
- capabilities : enum
- frameMarginBottom : int
- frameMarginLeft : int
- frameMarginRight : int
- frameMarginTop : int
- maximumSize : size
- minimumSize : size
- surface : WaylandSurface
- windowFlags : int
- windowGeometry : rect
- windowPosition : point
- windowState : int
- windowTitle : string
Señales
- void startMove()
- void startResize(enum edges)
Métodos
- void initialize(QtShell qtShell, WaylandSurface surface, WaylandResource resource)
- void requestWindowGeometry(int windowState, rect windowGeometry)
- void sendClose()
Descripción detallada
Este tipo forma parte de la extensión « QtShell » y ofrece una forma de ampliar la funcionalidad de un « WaylandSurface » existente con capacidades de gestión de ventanas.
El tipo QtShellSurface contiene la funcionalidad básica necesaria para crear un compositor compatible con la extensión « QtShell ». Se puede utilizar directamente o a través del tipo « QtShellChrome », dependiendo de las necesidades del compositor. El tipo « QtShellChrome » cuenta con comportamientos predeterminados y API de conveniencia para trabajar con objetos QtShellSurface.
Documentación de propiedades
active : bool
Esta propiedad indica si la superficie se considera activa en ese momento.
Nota: En QtShellSurface nohay restricciones que impidan que varias superficies estén activas al mismo tiempo. Dicha lógica debe implementarse bien por el propio compositor, bien mediante el uso del tipo « QtShellChrome », que gestionará automáticamente el estado de activación de las superficies.
capabilities : enum
Esta propiedad contiene las capacidades del compositor. Por defecto, no hay ninguna capacidad especial activada.
- QtShellSurface.InteractiveMove El cliente puede iniciar una operación de desplazamiento interactivo del lado del servidor mediante QWindow::startSystemMove(). Se notificará al compositor esta acción a través de la señal startMove().
- QtShellSurface.InteractiveResize El cliente puede iniciar una operación de redimensionamiento interactivo del lado del servidor mediante QWindow::startSystemResize(). Se notificará esto al compositor a través de la señal startResize().
frameMarginBottom : int
Esto mantiene el margen del marco de la ventana por debajo de la superficie.
frameMarginLeft : int
Esto mantiene el margen del marco de la ventana a la izquierda de la superficie.
frameMarginRight : int
Esto mantiene el margen del marco de la ventana a la derecha de la superficie.
frameMarginTop : int
Esto mantiene el margen del marco de la ventana por encima de la superficie.
maximumSize : size [read-only]
El tamaño máximo de la ventana, si el cliente lo ha especificado. De lo contrario, un tamaño no válido.
minimumSize : size [read-only]
El tamaño mínimo de la ventana, si el cliente lo ha especificado. De lo contrario, un tamaño no válido.
surface : WaylandSurface [read-only]
Esta propiedad contiene la superficie asociada a este QtShellSurface.
windowFlags : int [read-only]
Esta propiedad contiene los indicadores de ventana del objeto ` QtShellSurface`.
windowGeometry : rect [read-only]
Esta propiedad contiene la geometría de la ventana de la superficie de la carcasa.
windowPosition : point
Esta propiedad indica la posición de la superficie del shell con respecto a su salida.
windowState : int [read-only]
Esta propiedad contiene el estado de la ventana del objeto ` QtShellSurface`.
Nota: Cuando se llama a ` requestWindowGeometry()` para actualizar el estado de la superficie, la propiedad ` windowState ` no se actualizará hasta que el cliente haya confirmado el cambio de estado.
windowTitle : string [read-only]
Esta propiedad contiene el título de la ventana de QtShellSurface.
Documentación de Signal
void startMove()
El cliente ha solicitado una operación de desplazamiento interactiva en el compositor mediante la llamada a QWindow::startSystemMove().
Nota: El controlador correspondiente es onStartMove.
Véase también capabilities.
void startResize(enum edges)
El cliente ha solicitado una operación de redimensionamiento interactiva en el compositor mediante la llamada a ` QWindow::startSystemResize()`.
edges proporciona información sobre qué borde de la ventana debe moverse durante el cambio de tamaño. Se trata de una máscara compuesta por los siguientes valores:
- Qt.TopEdge
- Qt.LeftEdge
- Qt.RightEdge
- Qt.BottomEdge
Nota: El controlador correspondiente es ` onStartResize`.
Véase también capabilities.
Documentación del método
void initialize(QtShell qtShell, WaylandSurface surface, WaylandResource resource)
Inicializa el objeto ` QtShellSurface` y lo asocia con los valores ` qtShell`, ` surface` y ` resource` indicados.
void requestWindowGeometry(int windowState, rect windowGeometry)
Solicita un nuevo ` windowState ` y un ` windowGeometry ` para el ` QtShellSurface`. El estado y la geometría se actualizan cuando el cliente ha confirmado la solicitud (momento en el que se puede dar por hecho que el tamaño del búfer de la superficie se ha ajustado si era necesario).
void sendClose()
Solicita que la aplicación cliente se cierre automáticamente.
© 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.