- Qt 6.8
- Qt Wayland Compositor
- QML Types
- QtWayland.Compositor.QtShell
- QtShellSurface
- Qt Wayland Compositor | Commercial or GPLv3

# QtShellSurface QML Type

Provides a simple way to identify and resize a surface. More...

Import Statement: | import QtWayland.Compositor.QtShell
Since: | Qt 6.3

- List of all members, including inherited members

## Properties

- 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

## Signals

- void startMove()
- void startResize(enum edges)

## Methods

- void initialize(QtShell qtShell, WaylandSurface surface, WaylandResource resource)
- void requestWindowGeometry(int windowState, rect windowGeometry)
- void sendClose()

## Detailed Description

This type is part of the QtShell extension and provides a way to extend the functionality of an existing WaylandSurface with window management functionality.

The QtShellSurface type holds the core functionality needed to create a compositor that supports the QtShell extension. It can be used directly, or via the QtShellChrome type, depending on what the needs of the compositor are. The QtShellChrome type has default behaviors and convenience APIs for working with QtShellSurface objects.

## Property Documentation

active : bool

This property holds whether the surface is currently considered active.

Note: There are no restrictions in QtShellSurface that prevents multiple surfaces from being active simultaneously. Such logic must either be implemented by the compositor itself, or by using the QtShellChrome type, which will automatically manage the activation state of surfaces.

capabilities : enum

This property holds the capabilities of the compositor. By default, no special capabilities are enabled.

- QtShellSurface.InteractiveMove The client can trigger a server-side interactive move operation using QWindow::startSystemMove(). The compositor will be notified of this through the startMove() signal.
- QtShellSurface.InteractiveResize The client can trigger a server-side interactive resize operation using QWindow::startSystemResize(). The compositor will be notified of this through the startResize() signal.

frameMarginBottom : int

This holds the window frame margin below the surface.

frameMarginLeft : int

This holds the window frame margin to the left of the surface.

frameMarginRight : int

This holds the window frame margin to the right of the surface.

frameMarginTop : int

This holds the window frame margin above the surface.

maximumSize : size `[read-only]`

The maximum size of the window if the client has specified one. Otherwise an invalid size.

minimumSize : size `[read-only]`

The minimum size of the window if the client has specified one. Otherwise an invalid size.

surface : WaylandSurface `[read-only]`

This property holds the surface associated with this QtShellSurface.

windowFlags : int `[read-only]`

This property holds the window flags of the QtShellSurface.

windowGeometry : rect `[read-only]`

This property holds the window geometry of the shell surface.

windowPosition : point

This property holds the position of the shell surface relative to its output.

windowState : int `[read-only]`

This property holds the window state of the QtShellSurface.

Note: When requestWindowGeometry() is called to update state of the surface, the `windowState` property will not be updated until the client has acknowledged the state change.

windowTitle : string `[read-only]`

This property holds the window title of the QtShellSurface.

## Signal Documentation

void startMove()

The client has requested an interactive move operation in the compositor by calling QWindow::startSystemMove().

Note: The corresponding handler is `onStartMove`.

See also capabilities.

void startResize(enum edges)

The client has requested an interactive resize operation in the compositor by calling QWindow::startSystemResize().

The edges provides information about which edge of the window should be moved during the resize. It is a mask of the following values:

- Qt.TopEdge
- Qt.LeftEdge
- Qt.RightEdge
- Qt.BottomEdge

Note: The corresponding handler is `onStartResize`.

See also capabilities.

## Method Documentation

void initialize(QtShell qtShell, WaylandSurface surface, WaylandResource resource)

Initializes the QtShellSurface, associating it with the given qtShell, surface, and resource.

void requestWindowGeometry(int windowState, rect windowGeometry)

Requests a new windowState and windowGeometry for the QtShellSurface. The state and geometry is updated when the client has acknowledged the request (at which point it is safe to assume that the surface's buffer has been resized if necessary).

void sendClose()

Requests that the client application closes itself.