Member Function Documentation

QWaylandSurface::QWaylandSurface()

Constructs a an uninitialized QWaylandSurface.

QWaylandSurface::QWaylandSurface(QWaylandCompositor *compositor, QWaylandClient *client, uint id, int version)

Constructs and initializes a QWaylandSurface for the given compositor and client, and with the given id and version.

[override virtual] QWaylandSurface::~QWaylandSurface()

Destroys the QWaylandSurface.

[signal] void QWaylandSurface::childAdded(QWaylandSurface *child)

This signal is emitted when a wl_subsurface, child, has been added to the surface.

QWaylandCompositor *QWaylandSurface::compositor() const

Returns the compositor for this QWaylandSurface.

[signal] void QWaylandSurface::configure(bool hasBuffer)

[signal] void QWaylandSurface::damaged(const QRegion &rect)

void QWaylandSurface::destroy()

Destroys the QWaylandSurface.

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

[signal] void QWaylandSurface::dragStarted(QWaylandDrag *drag)

This signal is emitted when a drag has started from this surface.

void QWaylandSurface::frameStarted()

Prepares all frame callbacks for sending.

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

[static] QWaylandSurface *QWaylandSurface::fromResource(::wl_resource *res)

Returns the QWaylandSurface corresponding to the Wayland resource res.

void QWaylandSurface::initialize(QWaylandCompositor *compositor, QWaylandClient *client, uint id, int version)

Initializes the QWaylandSurface with the given compositor and client, and with the given id and version.

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

QWaylandInputMethodControl *QWaylandSurface::inputMethodControl() const

bool QWaylandSurface::inputRegionContains(const QPoint &p) const

Returns true if the QWaylandSurface's input region contains the point p. Otherwise returns false.

bool QWaylandSurface::isDestroyed() const

Returns true if the QWaylandSurface has been destroyed. Otherwise returns false.

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

bool QWaylandSurface::isInitialized() const

Returns true if the QWaylandSurface has been initialized.

[signal] void QWaylandSurface::offsetForNextFrame(const QPoint &offset)

[signal] void QWaylandSurface::parentChanged(QWaylandSurface *newParent, QWaylandSurface *oldParent)

QWaylandView *QWaylandSurface::primaryView() const

Returns this QWaylandSurface's primary view.

See also QWaylandView::advance() and QWaylandSurface::setPrimaryView().

[signal] void QWaylandSurface::redraw()

struct wl_resource *QWaylandSurface::resource() const

Returns the Wayland resource corresponding to this QWaylandSurface.

QWaylandSurfaceRole *QWaylandSurface::role() const

See also setRole().

void QWaylandSurface::sendFrameCallbacks()

Sends pending frame callbacks.

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

void QWaylandSurface::setPrimaryView(QWaylandView *view)

Sets this QWaylandSurface's primary view to view, in case there are multiple views of this surface. The primary view is the view that governs the client's refresh rate. It takes care of discarding buffer references when QWaylandView::advance() is called. See the documentation for QWaylandView::advance() for more details.

In shell surface integrations, such as QWaylandWlShellIntegration and QWaylandXdgShellV5Integration, maximize and fullscreen requests from the client will only have an effect if the integration has the primary view of the surface.

See also primaryView() and QWaylandView::advance().

bool QWaylandSurface::setRole(QWaylandSurfaceRole *role, wl_resource *errorResource, uint32_t errorCode)

Sets a role on the surface. A role defines how a surface will be mapped on screen, without a role a surface is supposed to be hidden. Only one role at all times can be set on a surface. Although setting the same role many times is allowed, attempting to change the role of a surface will trigger a protocol error to the errorResource and send an errorCode to the client.

See also role().

[signal] void QWaylandSurface::subsurfacePlaceAbove(QWaylandSurface *sibling)

[signal] void QWaylandSurface::subsurfacePlaceBelow(QWaylandSurface *sibling)

[signal] void QWaylandSurface::subsurfacePositionChanged(const QPoint &position)

[signal] void QWaylandSurface::surfaceDestroyed()

This signal is emitted when the corresponing wl_surface is destroyed.

[slot] void QWaylandSurface::updateSelection()

Updates the surface with the compositor's retained clipboard selection. Although this is done automatically when the surface receives keyboard focus, this function is useful for updating clients which do not have keyboard focus.

QList<QWaylandView *> QWaylandSurface::views() const

Returns the views for this QWaylandSurface.

::wl_client *QWaylandSurface::waylandClient() const