Back to Qt.io
Contact Us Blog Download Qt

XdgShell QML Type

Bietet eine Erweiterung für Benutzeroberflächen im Desktop-Stil. Mehr...

Import Statement: import QtWayland.Compositor.XdgShell
In C++: QWaylandXdgShell

Signale

Methoden

  • void ping(WaylandClient client)

Detaillierte Beschreibung

Die XdgShell-Erweiterung bietet eine Möglichkeit, eine XdgToplevel oder XdgPopup mit einer regulären Wayland-Oberfläche zu verknüpfen. Über die Schnittstelle XdgToplevel kann der Client anfordern, dass die Oberfläche in der Größe verändert, verschoben usw. wird.

XdgShell entspricht der Wayland-Schnittstelle xdg_shell.

Um die Funktionalität der Shell-Erweiterung in einem Compositor bereitzustellen, erstellen Sie eine Instanz der XdgShell-Komponente und fügen Sie sie der Liste der vom Compositor unterstützten Erweiterungen hinzu:

import QtWayland.Compositor.XdgShell

WaylandCompositor {
    XdgShell {
        // ...
    }
}

Signal Dokumentation

pong(int serial)

Dieses Signal wird ausgegeben, wenn der Client auf ein Ping-Ereignis mit serial, serial geantwortet hat.

Hinweis: Der entsprechende Handler ist onPong.

Siehe auch ping().


popupCreated(XdgPopup popup, XdgSurface xdgSurface)

Dieses Signal wird ausgegeben, wenn der Client ein xdg_popup erstellt hat. Ein üblicher Anwendungsfall ist es, den Handler dieses Signals ein ShellSurfaceItem oder WaylandQuickItem instanziieren zu lassen, um popup in einer QtQuick Szene anzuzeigen.

xdgSurface ist das XdgSurface popup ist das Rollenobjekt für.

Hinweis: Der entsprechende Handler ist onPopupCreated.


toplevelCreated(XdgToplevel toplevel, XdgSurface xdgSurface)

Dieses Signal wird ausgegeben, wenn der Client ein xdg_toplevel erstellt hat. Ein üblicher Anwendungsfall ist es, den Handler dieses Signals ein ShellSurfaceItem oder WaylandQuickItem instanziieren zu lassen, um toplevel in einer QtQuick -Szene anzuzeigen.

xdgSurface ist das XdgSurface toplevel ist das Rollenobjekt für.

Hinweis: Der entsprechende Handler ist onToplevelCreated.


xdgSurfaceCreated(XdgSurface xdgSurface)

Dieses Signal wird ausgegeben, wenn der Client ein xdg_surface erstellt hat. Beachten Sie, dass xdgSurface nicht gemappt ist, d.h. nach dem xdg-shell Protokoll nicht angezeigt werden soll, bis es ein Rollenobjekt erhalten hat.

Hinweis: Der entsprechende Handler ist onXdgSurfaceCreated.

Siehe auch toplevelCreated() und popupCreated().


Dokumentation der Methode

void ping(WaylandClient client)

Sendet ein Ping-Ereignis an client. Wenn der Client auf das Ereignis antwortet, wird das Signal pong ausgegeben.


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