QWaylandXdgToplevel Class

The QWaylandXdgToplevel class represents the toplevel window specific parts of an xdg surface. More...

Header:	#include <QWaylandXdgToplevel>
qmake:	QT += waylandcompositor
Since:	Qt 5.12
Inherits:	QObject

• List of all members, including inherited members
• Obsolete members

Public Types

enum	DecorationMode { ServerSideDecoration, ClientSideDecoration }
enum	State { MaximizedState, FullscreenState, ResizingState, ActivatedState }

Properties

DecorationMode : const enum activated : const bool appId : const QString fullscreen : const bool maxSize : const QSize maximized : const bool

minSize : const QSize parentToplevel : QWaylandXdgToplevel* const resizing : const bool states : const QList<int> title : const QString xdgSurface : QWaylandXdgSurface* const

• 1 property inherited from QObject

Public Functions

	QWaylandXdgToplevel(QWaylandXdgSurface *xdgSurface, QWaylandResource &resource)
virtual	~QWaylandXdgToplevel() override
bool	activated() const
QString	appId() const
QWaylandXdgToplevel::DecorationMode	decorationMode() const
bool	fullscreen() const
QSize	maxSize() const
bool	maximized() const
QSize	minSize() const
QWaylandXdgToplevel *	parentToplevel() const
bool	resizing() const
void	sendClose()
uint	sendConfigure(const QSize &size, const QVector<QWaylandXdgToplevel::State> &states)
uint	sendConfigure(const QSize &size, const QVector<int> &states)
uint	sendFullscreen(const QSize &size)
uint	sendMaximized(const QSize &size)
uint	sendResizing(const QSize &maxSize)
uint	sendUnmaximized(const QSize &size = QSize(0, 0))
QSize	sizeForResize(const QSizeF &size, const QPointF &delta, Qt::Edges edges) const
QVector<QWaylandXdgToplevel::State>	states() const
QString	title() const
QWaylandXdgSurface *	xdgSurface() const

• 31 public functions inherited from QObject

Signals

void	activatedChanged()
void	appIdChanged()
void	decorationModeChanged()
void	fullscreenChanged()
void	maxSizeChanged()
void	maximizedChanged()
void	minSizeChanged()
void	parentToplevelChanged()
void	resizingChanged()
void	setFullscreen(QWaylandOutput *output)
void	setMaximized()
void	setMinimized()
void	showWindowMenu(QWaylandSeat *seat, const QPoint &localSurfacePosition)
void	startMove(QWaylandSeat *seat)
void	startResize(QWaylandSeat *seat, Qt::Edges edges)
void	statesChanged()
void	titleChanged()
void	unsetFullscreen()
void	unsetMaximized()

• 2 signals inherited from QObject

Static Public Members

QWaylandXdgToplevel *	fromResource(::wl_resource *resource)
QWaylandSurfaceRole *	role()
const QMetaObject	staticMetaObject

• 9 static public members inherited from QObject

Additional Inherited Members

• 1 public slot inherited from QObject
• 9 protected functions inherited from QObject

Detailed Description

The QWaylandXdgToplevel class represents the toplevel window specific parts of an xdg surface.

This class is part of the QWaylandXdgShell extension and provides a way to extend the functionality of an QWaylandXdgSurface with features specific to desktop-style windows.

It corresponds to the Wayland interface xdg_toplevel.

Member Type Documentation

enum QWaylandXdgToplevel::DecorationMode

This enum type is used to specify the window decoration mode for toplevel windows.

Constant	Value	Description
QWaylandXdgToplevel::ServerSideDecoration	2	The compositor should draw window decorations.
QWaylandXdgToplevel::ClientSideDecoration	1	The client should draw window decorations.

enum QWaylandXdgToplevel::State

Member Function Documentation

QWaylandXdgToplevel::QWaylandXdgToplevel(QWaylandXdgSurface *xdgSurface, QWaylandResource &resource)

Constructs a QWaylandXdgToplevel for the given xdgSurface and resource.

[override virtual] QWaylandXdgToplevel::~QWaylandXdgToplevel()

Destroys the instance of QWaylandXdgToplevel. The destructor is virtual.

QWaylandXdgToplevel::DecorationMode QWaylandXdgToplevel::decorationMode() const

[signal] void QWaylandXdgToplevel::decorationModeChanged()

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

Returns the QWaylandXdgToplevel corresponding to the resource.

[static] QWaylandSurfaceRole *QWaylandXdgToplevel::role()

Returns the surface role for the QWaylandToplevel.

void QWaylandXdgToplevel::sendClose()

Sends a close event to the client. The client may choose to ignore the event.

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

uint QWaylandXdgToplevel::sendConfigure(const QSize &size, const QVector<QWaylandXdgToplevel::State> &states)

Sends a configure event to the client. Parameter size contains the pixel size of the surface. A size of zero means the client is free to decide the size. Known states are enumerated in QWaylandXdgToplevel::State.

uint QWaylandXdgToplevel::sendConfigure(const QSize &size, const QVector<int> &states)

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

uint QWaylandXdgToplevel::sendFullscreen(const QSize &size)

Convenience for sending a configure event with the fullscreen state set, and maximized and resizing removed. The activated state is left in its current state.

size is the new size of the window.

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

See also sendUnmaximized.

uint QWaylandXdgToplevel::sendMaximized(const QSize &size)

Convenience for sending a configure event with the maximized state set, and fullscreen and resizing removed. The activated state is left in its current state.

size is the new size of the window.

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

uint QWaylandXdgToplevel::sendResizing(const QSize &maxSize)

Convenience for sending a configure event with the resizing state set, and maximized and fullscreen removed. The activated state is left in its current state.

maxSize is the new size of the window.

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

uint QWaylandXdgToplevel::sendUnmaximized(const QSize &size = QSize(0, 0))

Convenience for sending a configure event with the maximized, fullscreen and resizing states removed, and fullscreen and resizing removed. The activated state is left in its current state.

size is the new size of the window. If size is zero, the client decides the size.

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

[signal] void QWaylandXdgToplevel::setFullscreen(QWaylandOutput *output)

See also fullscreen().

[signal] void QWaylandXdgToplevel::setMaximized()

See also maximized().

[signal] void QWaylandXdgToplevel::setMinimized()

[signal] void QWaylandXdgToplevel::showWindowMenu(QWaylandSeat *seat, const QPoint &localSurfacePosition)

QSize QWaylandXdgToplevel::sizeForResize(const QSizeF &size, const QPointF &delta, Qt::Edges edges) const

Convenience for computing the new size given the current size, a delta, and the edges active in the drag.

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

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

[signal] void QWaylandXdgToplevel::startResize(QWaylandSeat *seat, Qt::Edges edges)

QVector<QWaylandXdgToplevel::State> QWaylandXdgToplevel::states() const

[signal] void QWaylandXdgToplevel::unsetFullscreen()

[signal] void QWaylandXdgToplevel::unsetMaximized()