QWaylandWlShellSurface Class

The QWaylandWlShellSurface class provides desktop-style compositor-specific features to a surface. More...

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

• List of all members, including inherited members

Public Types

enum	FullScreenMethod { DefaultFullScreen, ScaleFullScreen, DriverFullScreen, FillFullScreen }
enum	ResizeEdge { NoneEdge, TopEdge, BottomEdge, LeftEdge, ..., BottomRightEdge }

Properties

• className : const QString
• shell : QWaylandWlShell* const
• surface : QWaylandSurface* const
• title : const QString

Public Functions

	QWaylandWlShellSurface()
	QWaylandWlShellSurface(QWaylandWlShell *shell, QWaylandSurface *surface, const QWaylandResource &res)
	~QWaylandWlShellSurface()
QString	className() const
void	initialize(QWaylandWlShell *shell, QWaylandSurface *surface, const QWaylandResource &resource)
void	sendConfigure(const QSize &size, QWaylandWlShellSurface::ResizeEdge edges)
void	sendPopupDone()
QWaylandWlShell *	shell() const
QSize	sizeForResize(const QSizeF &size, const QPointF &delta, QWaylandWlShellSurface::ResizeEdge edges)
QWaylandSurface *	surface() const
QString	title() const
Qt::WindowType	windowType() const

Public Slots

void

ping()

Signals

void	classNameChanged()
void	pong()
void	setDefaultToplevel()
void	setFullScreen(QWaylandWlShellSurface::FullScreenMethod method, uint framerate, QWaylandOutput *output)
void	setMaximized(QWaylandOutput *output)
void	setPopup(QWaylandSeat *seat, QWaylandSurface *parentSurface, const QPoint &relativeToParent)
void	setTransient(QWaylandSurface *parentSurface, const QPoint &relativeToParent, bool inactive)
void	shellChanged()
void	startMove(QWaylandSeat *seat)
void	startResize(QWaylandSeat *seat, QWaylandWlShellSurface::ResizeEdge edges)
void	surfaceChanged()
void	titleChanged()

Static Public Members

QWaylandWlShellSurface *	fromResource(wl_resource *resource)
const struct wl_interface *	interface()
QWaylandSurfaceRole *	role()
const QMetaObject	staticMetaObject

Detailed Description

The QWaylandWlShellSurface class provides desktop-style compositor-specific features to a surface.

This class is part of the QWaylandWlShell extension and provides a way to extend the functionality of an existing QWaylandSurface with features specific to desktop-style compositors, such as resizing and moving the surface.

It corresponds to the Wayland interface wl_shell_surface.

Member Type Documentation

enum QWaylandWlShellSurface::FullScreenMethod

enum QWaylandWlShellSurface::ResizeEdge

This enum type provides a way to specify an edge or corner of the surface.

Constant	Value	Description
QWaylandWlShellSurface::NoneEdge	0	No edge.
QWaylandWlShellSurface::TopEdge	1	The top edge.
QWaylandWlShellSurface::BottomEdge	2	The bottom edge.
QWaylandWlShellSurface::LeftEdge	4	The left edge.
QWaylandWlShellSurface::TopLeftEdge	5	The top left corner.
QWaylandWlShellSurface::BottomLeftEdge	6	The bottom left corner.
QWaylandWlShellSurface::RightEdge	8	The right edge.
QWaylandWlShellSurface::TopRightEdge	9	The top right corner.
QWaylandWlShellSurface::BottomRightEdge	10	The bottom right corner.

Member Function Documentation

QWaylandWlShellSurface::QWaylandWlShellSurface()

Constructs a QWaylandWlShellSurface.

QWaylandWlShellSurface::QWaylandWlShellSurface(QWaylandWlShell *shell, QWaylandSurface *surface, const QWaylandResource &res)

Constructs a QWaylandWlShellSurface for surface and initializes it with the given shell and resource res.

QWaylandWlShellSurface::~QWaylandWlShellSurface()

Destroys the instance of QWaylandWlShellSurface.

[static] QWaylandWlShellSurface *QWaylandWlShellSurface::fromResource(wl_resource *resource)

Returns the QWaylandWlShellSurface object associated with the given resource, or null if no such object exists.

void QWaylandWlShellSurface::initialize(QWaylandWlShell *shell, QWaylandSurface *surface, const QWaylandResource &resource)

Initializes the QWaylandWlShellSurface and associates it with the given shell, surface, and resource.

Note: This function can be invoked via the meta-object system and from QML. See Q_INVOKABLE.

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

[slot] void QWaylandWlShellSurface::ping()

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

[signal] void QWaylandWlShellSurface::pong()

[static] QWaylandSurfaceRole *QWaylandWlShellSurface::role()

void QWaylandWlShellSurface::sendConfigure(const QSize &size, QWaylandWlShellSurface::ResizeEdge edges)

Sends a configure event to the client, suggesting that it resize its surface to the provided size. The edges provide a hint about how the surface was resized.

Note: This function can be invoked via the meta-object system and from QML. See Q_INVOKABLE.

void QWaylandWlShellSurface::sendPopupDone()

Sends a popup_done event to the client to indicate that the user has clicked somewhere outside the client's surfaces.

Note: This function can be invoked via the meta-object system and from QML. See Q_INVOKABLE.

[signal] void QWaylandWlShellSurface::setDefaultToplevel()

[signal] void QWaylandWlShellSurface::setFullScreen(QWaylandWlShellSurface::FullScreenMethod method, uint framerate, QWaylandOutput *output)

[signal] void QWaylandWlShellSurface::setMaximized(QWaylandOutput *output)

[signal] void QWaylandWlShellSurface::setPopup(QWaylandSeat *seat, QWaylandSurface *parentSurface, const QPoint &relativeToParent)

[signal] void QWaylandWlShellSurface::setTransient(QWaylandSurface *parentSurface, const QPoint &relativeToParent, bool inactive)

QSize QWaylandWlShellSurface::sizeForResize(const QSizeF &size, const QPointF &delta, QWaylandWlShellSurface::ResizeEdge edges)

Note: This function can be invoked via the meta-object system and from QML. See Q_INVOKABLE.

[signal] void QWaylandWlShellSurface::startMove(QWaylandSeat *seat)

[signal] void QWaylandWlShellSurface::startResize(QWaylandSeat *seat, QWaylandWlShellSurface::ResizeEdge edges)

Qt::WindowType QWaylandWlShellSurface::windowType() const