En esta página

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

Señales

Métodos

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.

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.