WlShell QML Type

Provides an extension for desktop-style user interfaces. More...

Import Statement: import QtWayland.Compositor.WlShell
In C++: QWaylandWlShell


Detailed Description

The WlShell extension provides a way to associate a ShellSurface with a regular Wayland surface. Using the shell surface interface, the client can request that the surface is resized, moved, and so on.

WlShell corresponds to the Wayland interface wl_shell.

To provide the functionality of the shell extension in a compositor, create an instance of the WlShell component and add it to the list of extensions supported by the compositor:

import QtWayland.Compositor.WlShell

WaylandCompositor {
    WlShell {
        // ...

Signal Documentation

void wlShellSurfaceCreated(WlShellSurface shellSurface)

This signal is emitted when the client has created a wl_shell_surface. A common use case is to let the handler of this signal instantiate a ShellSurfaceItem or WaylandQuickItem for displaying shellSurface in a QtQuick scene.

Note: The corresponding handler is onWlShellSurfaceCreated.

void wlShellSurfaceRequested(WaylandSurface surface, WaylandResource resource)

This signal is emitted when the client has requested a wl_shell_surface to be associated with surface. The handler for this signal may create a shell surface for resource and initialize it within the scope of the signal emission. Otherwise a WlShellSurface will be created automatically.

Note: The corresponding handler is onWlShellSurfaceRequested.

© 2024 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.