QtShellSurface QML Type
Proporciona una forma sencilla de identificar y redimensionar 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 es parte de la extensión QtShell y proporciona una forma de extender la funcionalidad de un WaylandSurface existente con funcionalidad de gestión de ventanas.
El tipo QtShellSurface contiene la funcionalidad básica necesaria para crear un compositor que soporte la extensión QtShell. Puede usarse directamente, o a través del tipo QtShellChrome, dependiendo de cuáles sean las necesidades del compositor. El tipo QtShellChrome tiene comportamientos predeterminados y APIs convenientes para trabajar con objetos QtShellSurface.
Documentación de propiedades
active : bool
Esta propiedad indica si la superficie se considera activa en ese momento.
Nota: No hay restricciones en QtShellSurface que impidan que varias superficies estén activas simultáneamente. Dicha lógica debe ser implementada por el propio compositor, o utilizando el 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 capacidades especiales habilitadas.
- QtShellSurfaceInteractiveMove El cliente puede activar una operación de movimiento interactivo en el servidor utilizando QWindow::startSystemMove(). El compositor será notificado de esto a través de la señal startMove().
- QtShellSurface.InteractiveResize El cliente puede lanzar una operación de redimensionamiento interactivo del lado del servidor utilizando QWindow::startSystemResize(). El compositor será notificado de ello 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
Mantiene el margen del marco de la ventana a la izquierda de la superficie.
frameMarginRight : int
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 ha especificado uno. En caso contrario, un tamaño no válido.
minimumSize : size [read-only]
El tamaño mínimo de la ventana si el cliente ha especificado uno. En caso contrario, un tamaño no válido.
surface : WaylandSurface [read-only]
Esta propiedad mantiene la superficie asociada a este QtShellSurface.
windowFlags : int [read-only]
Esta propiedad contiene las banderas de ventana de QtShellSurface.
windowGeometry : rect [read-only]
Esta propiedad contiene la geometría de la ventana de la superficie de la cáscara.
windowPosition : point
Esta propiedad mantiene la posición de la superficie de la cáscara con respecto a su salida.
windowState : int [read-only]
Esta propiedad contiene el estado de la ventana 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 reconocido el cambio de estado.
windowTitle : string [read-only]
Esta propiedad contiene el título de la ventana de QtShellSurface.
Documentación de señales
void startMove()
El cliente ha solicitado una operación de movimiento interactivo en el compositor llamando a QWindow::startSystemMove().
Nota: El manejador correspondiente es onStartMove.
Véase también capabilities.
void startResize(enum edges)
El cliente ha solicitado una operación de redimensionamiento interactivo en el compositor llamando a QWindow::startSystemResize().
edges proporciona información sobre qué borde de la ventana debe moverse durante el redimensionamiento. Es una máscara de los siguientes valores:
- Qt.TopEdge
- Qt.BordeIzquierdo
- Qt.BordeDerecho
- Qt.BottomEdge
Nota: El manejador correspondiente es onStartResize.
Véase también capabilities.
Documentación de métodos
void initialize(QtShell qtShell, WaylandSurface surface, WaylandResource resource)
Inicializa el QtShellSurface, asociándolo a los qtShell, surface y resource dados.
void requestWindowGeometry(int windowState, rect windowGeometry)
Solicita un nuevo windowState y windowGeometry para el QtShellSurface. El estado y la geometría se actualizan cuando el cliente ha acusado recibo de la solicitud (momento en el que es seguro asumir que el búfer de la superficie se ha redimensionado si es necesario).
void sendClose()
Solicita que la aplicación cliente se cierre sola.
© 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.
