QWaylandWlShell Class

The QWaylandWlShell class is an extension for desktop-style user interfaces. More...

Header: #include <QWaylandWlShell>
qmake: QT += waylandcompositor
Since: Qt 5.8

Public Functions

QWaylandWlShell(QWaylandCompositor *compositor)
void initialize()
QList<QWaylandWlShellSurface *> mappedPopups() const
QWaylandClient *popupClient() const
QList<QWaylandWlShellSurface *> shellSurfaces() const
QList<QWaylandWlShellSurface *> shellSurfacesForClient(QWaylandClient *client) const

Public Slots


void wlShellSurfaceCreated(QWaylandWlShellSurface *shellSurface)
void wlShellSurfaceRequested(QWaylandSurface *surface, const QWaylandResource &resource)

Static Public Members

const struct wl_interface *interface()

Detailed Description

The QWaylandWlShell class is an extension for desktop-style user interfaces.

The QWaylandWlShell extension provides a way to associate a QWaylandWlShellSurface 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.

Member Function Documentation


Constructs a QWaylandWlShell object.

QWaylandWlShell::QWaylandWlShell(QWaylandCompositor *compositor)

Constructs a QWaylandWlShell object for the provided compositor.

[slot] void QWaylandWlShell::closeAllPopups()

void QWaylandWlShell::initialize()

Initializes the WlShell extension.

[static] const struct wl_interface *QWaylandWlShell::interface()

Returns the Wayland interface for the QWaylandWlShell.

QList<QWaylandWlShellSurface *> QWaylandWlShell::mappedPopups() const

QWaylandClient *QWaylandWlShell::popupClient() const

QList<QWaylandWlShellSurface *> QWaylandWlShell::shellSurfaces() const

QList<QWaylandWlShellSurface *> QWaylandWlShell::shellSurfacesForClient(QWaylandClient *client) const

[signal] void QWaylandWlShell::wlShellSurfaceCreated(QWaylandWlShellSurface *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 QWaylandShellSurfaceItem or QWaylandQuickItem for displaying shellSurface in a QtQuick scene.

[signal] void QWaylandWlShell::wlShellSurfaceRequested(QWaylandSurface *surface, const QWaylandResource &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 QWaylandWlShellSurface will be created automatically.

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