QWaylandXdgToplevel Class

Die Klasse „QWaylandXdgToplevel“ repräsentiert die für das oberste Fenster spezifischen Teile einer XDG-Oberfläche. Mehr...

Header:	`#include <QWaylandXdgToplevel>`

CMake:	`find_package(Qt6 REQUIRED COMPONENTS WaylandCompositor)` `target_link_libraries(mytarget PRIVATE Qt6::WaylandCompositor)`
qmake:	`QT += waylandcompositor`
In QML:	XdgToplevel
Erbt von:	QObject

Liste aller Mitglieder, einschließlich geerbter Mitglieder

Öffentliche Typen

enum	DecorationMode { ServerSideDecoration, ClientSideDecoration }

Eigenschaften

activated : bool
appId : QString
decorationMode : enum DecorationMode
fullscreen : bool
maxSize : QSize
maximized : bool
minSize : QSize

(since 6.8) modal : bool
parentToplevel : QWaylandXdgToplevel*
resizing : bool
states : QList<int>
title : QString
xdgSurface : QWaylandXdgSurface* const

Öffentliche Funktionen

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

Signale

void	activatedChanged()
void	appIdChanged()
void	decorationModeChanged()
void	fullscreenChanged()
void	maxSizeChanged()
void	maximizedChanged()
void	minSizeChanged()
void	modalChanged()
void	parentToplevelChanged()
void	resizingChanged()
void	statesChanged()
void	titleChanged()

Statische öffentliche Mitglieder

QWaylandXdgToplevel *	fromResource(wl_resource *resource)
QWaylandSurfaceRole *	role()

Ausführliche Beschreibung

Diese Klasse ist Teil der Erweiterung „ QWaylandXdgShell “ und bietet die Möglichkeit, die Funktionalität eines „ QWaylandXdgSurface “ um Funktionen zu erweitern, die für Fenster im Desktop-Stil spezifisch sind.

Sie entspricht der Wayland-Schnittstelle „ xdg_toplevel “.

Dokumentation zum Mitgliedstyp

enum QWaylandXdgToplevel::DecorationMode

Dieser Enum-Typ dient zur Festlegung des Fensterdekorationsmodus für Fenster der obersten Ebene.

Konstante	Wert	Beschreibung
`QWaylandXdgToplevel::ServerSideDecoration`	`2`	Der Compositor sollte Fensterdekorationen zeichnen.
`QWaylandXdgToplevel::ClientSideDecoration`	`1`	Der Client sollte Fensterdekorationen zeichnen.

Eigenschaftsdokumentation

`[read-only]` activated : bool

Diese Eigenschaft gibt an, ob „toplevel“ sich selbst so darstellt, als hätte es den Eingabefokus.

Zugriffsfunktionen:

bool	activated() const

Notifier-Signal:

void	activatedChanged()

`[read-only]` appId : QString

Diese Eigenschaft enthält die App-ID des „ QWaylandXdgToplevel “. Sie entspricht dem „ desktopFileName “ in Qt.

Zugriffsfunktionen:

QString appId() const

Notifier-Signal:

void	appIdChanged()

`[read-only]` decorationMode : enum DecorationMode

Diese Eigenschaft enthält den aktuellen Modus der Fensterdekoration für dieses oberste Fenster.

Zugriffsfunktionen:

QWaylandXdgToplevel::DecorationMode decorationMode() const

Notifier-Signal:

void	decorationModeChanged()

Siehe auch „ QWaylandXdgDecorationManagerV1 “.

`[read-only]` fullscreen : bool

Diese Eigenschaft gibt an, ob der Client bestätigt hat, dass der Vollbildmodus aktiviert werden soll.

Zugriffsfunktionen:

bool	fullscreen() const

Notifier-Signal:

void	fullscreenChanged()

`[read-only]` maxSize : QSize

Diese Eigenschaft gibt die maximale Größe des „ QWaylandXdgToplevel “ an.

Dem Compositor steht es frei, diesen Wert zu ignorieren und eine größere Größe anzufordern.

Zugriffsfunktionen:

QSize maxSize() const

Notifier-Signal:

void	maxSizeChanged()

`[read-only]` maximized : bool

Diese Eigenschaft gibt an, ob der Client bestätigt hat, dass sie maximiert werden soll.

Zugriffsfunktionen:

bool	maximized() const

Notifier-Signal:

void	maximizedChanged()

`[read-only]` minSize : QSize

Diese Eigenschaft gibt die Mindestgröße des „ QWaylandXdgToplevel “ an.

Dem Compositor steht es frei, diesen Wert zu ignorieren und eine kleinere Größe anzufordern.

Zugriffsfunktionen:

QSize minSize() const

Notifier-Signal:

void	minSizeChanged()

`[read-only, since 6.8]` modal : bool

Diese Eigenschaft legt fest, ob „toplevel“ verhindert, dass andere Fenster Eingaben empfangen.

Diese Aufzählung wurde in Qt 6.8 eingeführt.

Zugriffsfunktionen:

bool	isModal() const

Notifier-Signal:

void	modalChanged()

`[read-only]` parentToplevel : QWaylandXdgToplevel*

Diese Eigenschaft enthält den übergeordneten „ XdgToplevel “ dieses „ XdgToplevel “.

Zugriffsfunktionen:

QWaylandXdgToplevel * parentToplevel() const

Benachrichtigungssignal:

void	parentToplevelChanged()

`[read-only]` resizing : bool

Diese Eigenschaft gibt an, ob der Client bestätigt hat, dass seine Größe angepasst wird.

Zugriffsfunktionen:

bool	resizing() const

Notifier-Signal:

void	resizingChanged()

`[read-only]` states : QList<int>

Diese Eigenschaft enthält die letzten Zustände, die der Client für dieses „QWaylandToplevel“ bestätigt hat.

Notifier-Signal:

void	statesChanged()

`[read-only]` title : QString

Diese Immobilie trägt den Titel „ QWaylandXdgToplevel “.

Zugriffsfunktionen:

QString title() const

Benachrichtigungssignal:

void	titleChanged()

`[read-only]` xdgSurface : QWaylandXdgSurface* const

Diese Eigenschaft enthält den „ QWaylandXdgSurface “ für diese „ QWaylandXdgToplevel “.

Zugriffsfunktionen:

QWaylandXdgSurface * xdgSurface() const

Dokumentation der Member-Funktionen

`[explicit]` QWaylandXdgToplevel::QWaylandXdgToplevel(QWaylandXdgSurface **xdgSurface, QWaylandResource &resource*)

Erstellt ein `QWaylandXdgToplevel` für die angegebenen ` xdgSurface ` und ` resource`.

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

Gibt das „ QWaylandXdgToplevel “ zurück, das dem „ resource “ entspricht.

`[static]` QWaylandSurfaceRole *QWaylandXdgToplevel::role()

Gibt die Oberflächenrolle für das QWaylandToplevel zurück.

`[invokable]` void QWaylandXdgToplevel::sendClose()

Sendet ein Schließereignis an den Client. Der Client kann das Ereignis ignorieren.

Hinweis: Diese Funktion kann über das Metaobjekt-System und aus QML aufgerufen werden. Siehe Q_INVOKABLE.

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

Sendet ein Konfigurationsereignis an den Client. Der Parameter „ size “ enthält die Pixelgröße der Oberfläche. Der Wert Null bedeutet, dass der Client die Größe frei festlegen kann. Bekannte „ states “ sind in QWaylandXdgToplevel::State aufgeführt.

`[invokable]` uint QWaylandXdgToplevel::sendFullscreen(const QSize &size)

Eine bequeme Möglichkeit, ein „configure“-Ereignis zu senden, bei dem der Vollbildmodus gesetzt ist und die Funktionen zum Maximieren und zur Größenänderung deaktiviert sind. Der Aktivierungsstatus bleibt unverändert.

size ist die neue Größe des Fensters.