QWaylandSurface Class

Dokumentation der Mitgliedsfunktionen

QWaylandSurface::QWaylandSurface()

Erstellt eine nicht initialisierte `QWaylandSurface`.

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

Erstellt und initialisiert eine `QWaylandSurface` für die angegebenen ` compositor ` und ` client` sowie mit den angegebenen ` id ` und ` version`.

[override virtual noexcept] QWaylandSurface::~QWaylandSurface()

Zerstört die „ QWaylandSurface “.

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

Dieses Signal wird ausgelöst, wenn ein „wl_subsurface“ ( child) zur Oberfläche hinzugefügt wurde.

QWaylandCompositor *QWaylandSurface::compositor() const

Gibt den Compositor für diese „ QWaylandSurface “ zurück.

[invokable] void QWaylandSurface::destroy()

Löscht das „ QWaylandSurface “.

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

Dieses Signal wird ausgesendet, wenn ein „ drag “ von dieser Fläche gestartet ist.

[invokable] void QWaylandSurface::frameStarted()

Bereitet alle Frame-Callbacks für den Versand vor.

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

Gibt das „ QWaylandSurface “ zurück, das der Wayland-Ressource „ resource “ entspricht.

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

Initialisiert das „ QWaylandSurface “ mit den angegebenen Werten „ compositor “ und „ client “ sowie mit den angegebenen Werten „ id “ und „ version “.

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

Gibt „ true “ zurück, wenn der Eingabebereich von „ QWaylandSurface “ den Punkt „ p “ enthält. Andernfalls wird „ false “ zurückgegeben.

bool QWaylandSurface::inputRegionContains(const QPointF &position) const

Gibt „ true “ zurück, wenn der Eingabebereich von „ QWaylandSurface “ den Punkt „ position “ enthält. Andernfalls wird „ false “ zurückgegeben.

[invokable] bool QWaylandSurface::isDestroyed() const

Gibt „true“ zurück, wenn das „ QWaylandSurface “ zerstört wurde. Andernfalls wird „false“ zurückgegeben.

bool QWaylandSurface::isInitialized() const

Gibt „true“ zurück, wenn die „ QWaylandSurface “ initialisiert wurde.

QWaylandView *QWaylandSurface::primaryView() const

Gibt die Hauptansicht von „ QWaylandSurface “ zurück.

Siehe auch „ QWaylandView::advance()“ und „ QWaylandSurface::setPrimaryView()“.

struct wl_resource *QWaylandSurface::resource() const

Gibt die Wayland-Ressource zurück, die diesem „ QWaylandSurface “ entspricht.

[invokable] void QWaylandSurface::sendFrameCallbacks()

Sendet Callbacks für ausstehende Frames.

void QWaylandSurface::setPrimaryView(QWaylandView *view)

Legt die primäre Ansicht dieser „ QWaylandSurface “ auf „ view “ fest, falls mehrere Ansichten dieser Oberfläche vorhanden sind. Die primäre Ansicht ist die Ansicht, die die Bildwiederholfrequenz des Clients bestimmt. Sie sorgt dafür, dass Pufferverweise verworfen werden, wenn „ QWaylandView::advance()“ aufgerufen wird. Weitere Details finden Sie in der Dokumentation zu „ QWaylandView::advance()“.

Bei Shell-Surface-Integrationen wie QWaylandWlShellIntegration und QWaylandXdgShellV5Integration wirken sich Maximierungs- und Vollbildanforderungen des Clients nur dann aus, wenn die Integration die primäre Ansicht der Oberfläche besitzt.

Siehe auch ` primaryView()` und ` QWaylandView::advance()`.

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

Legt eine „ role “ für die Oberfläche fest. Eine Rolle definiert, wie eine Oberfläche auf dem Bildschirm dargestellt wird; ohne Rolle wird eine Oberfläche als ausgeblendet betrachtet. Sobald einer Oberfläche eine Rolle zugewiesen wurde, wird diese zu ihrer permanenten Rolle. Jeder nachfolgende Aufruf von ` setRole() ` mit einer anderen Rolle löst einen Protokollfehler beim ` errorResource ` aus und sendet eine ` errorCode ` an den Client. Die Durchsetzung dieser Anforderung ist der Hauptzweck der Oberflächenrolle.

Die „ role “ wird anhand des Zeigerwerts verglichen. Zwei beliebige Objekte von „ QWaylandSurfaceRole “ gelten als unterschiedliche Rollen, unabhängig von ihren Namen.

Die Oberflächenrolle wird intern von Protokollimplementierungen festgelegt, wenn eine Oberfläche für einen bestimmten Zweck übernommen wird, beispielsweise in einer Shell-Erweiterung. Sofern Sie keine Erweiterungen entwickeln, die Oberflächen auf diese Weise nutzen, sollten Sie diese Funktion nicht aufrufen.

Gibt „true“ zurück, wenn eine Rolle zugewiesen werden kann; andernfalls „false“.

[signal] void QWaylandSurface::surfaceDestroyed()

Dieses Signal wird ausgelöst, wenn die entsprechende wl_surface zerstört wird.

[slot] void QWaylandSurface::updateSelection()

Aktualisiert die Oberfläche mit der vom Compositor gespeicherten Auswahl aus der Zwischenablage. Obwohl dies automatisch geschieht, sobald die Oberfläche den Tastaturfokus erhält, ist diese Funktion nützlich, um Clients zu aktualisieren, die keinen Tastaturfokus haben.

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

Gibt die Ansichten für diese QWaylandSurface zurück.

wl_client *QWaylandSurface::waylandClient() const

Verwaltet die „ wl_client “ mithilfe dieses Links: QWaylandSurface.