Qt Documentation

Contents

XdgShellV5 QML Type

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

Import Statement: import QtWayland.Compositor 1.14
Since: Qt 5.8

Signals

Methods

Detailed Description

The XdgShellV5 extension provides a way to associate an XdgSurfaceV5 with a regular Wayland surface. Using the xdg_surface interface, the client can request that the surface is resized, moved, and so on.

XdgShellV5 corresponds to the Wayland interface xdg_shell.

To provide the functionality of the shell extension in a compositor, create an instance of the XdgShellV5 component and add it as a child of the compositor:

import QtWayland.Compositor 1.14

WaylandCompositor {
    XdgShellV5 {
        // ...
    }
}

Signal Documentation

void pong(serial)

This signal is emitted when the client has responded to a ping event with serial serial.

See also QtWaylandCompositor::XdgShellV5::ping().


void xdgPopupCreated(xdgPopup)

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


void xdgPopupRequested(surface, WaylandSurface parent, WaylandSeat seat, point position, WaylandResource resource)

This signal is emitted when the client has requested an xdg_popup to be associated with surface. The handler for this signal may create the xdg popup for resource and initialize it within the scope of the signal emission. Otherwise an XdgPopupV5 will be created automatically.

The seat is the wl_seat that caused the popup to be opened.

position is the desired position of the popup, relative to the parent.


void xdgSurfaceCreated(xdgSurface)

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


void xdgSurfaceRequested(surface, WaylandResource resource)

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


Method Documentation

void ping(client)

Sends a ping event to the client. If the client replies to the event, the pong signal will be emitted.


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