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

Public Types

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

Properties

  • 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()

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.

ConstantValueDescription
QWaylandXdgToplevel::ServerSideDecoration2The compositor should draw window decorations.
QWaylandXdgToplevel::ClientSideDecoration1The client should draw window decorations.

enum QWaylandXdgToplevel::State

Property Documentation

DecorationMode : const enum

activated : const bool

This property holds whether toplevel is drawing itself as having input focus.

Access functions:

bool activated() const

Notifier signal:

void activatedChanged()

appId : const QString

This property holds the app id of the QWaylandXdgToplevel.

Access functions:

QString appId() const

Notifier signal:

void appIdChanged()

fullscreen : const bool

This property holds whether the client has acknowledged that it should be fullscreen.

Access functions:

bool fullscreen() const

Notifier signal:

void fullscreenChanged()

maxSize : const QSize

This property holds the maximum size of the QWaylandXdgToplevel.

The compositor is free to ignore this value and request a larger size.

Access functions:

QSize maxSize() const

Notifier signal:

void maxSizeChanged()

maximized : const bool

This property holds whether the client has acknowledged that it should be maximized.

Access functions:

bool maximized() const

Notifier signal:

void maximizedChanged()

minSize : const QSize

This property holds the minimum size of the QWaylandXdgToplevel.

The compositor is free to ignore this value and request a smaller size.

Access functions:

QSize minSize() const

Notifier signal:

void minSizeChanged()

parentToplevel : QWaylandXdgToplevel* const

This property holds the XdgToplevel parent of this XdgToplevel.

Access functions:

QWaylandXdgToplevel *parentToplevel() const

Notifier signal:

void parentToplevelChanged()

resizing : const bool

This property holds whether the client has acknowledged that it is being resized.

Access functions:

bool resizing() const

Notifier signal:

void resizingChanged()

states : const QList<int>

This property holds the last states the client acknowledged for this QWaylandToplevel.

Notifier signal:

void statesChanged()

title : const QString

This property holds the title of the QWaylandXdgToplevel.

Access functions:

QString title() const

Notifier signal:

void titleChanged()

xdgSurface : QWaylandXdgSurface* const

This property holds the QWaylandXdgSurface for this QWaylandXdgToplevel.

Access functions:

QWaylandXdgSurface *xdgSurface() const

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()

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