Auf dieser Seite

QtShell QML Type

Bietet eine Shell-Erweiterung für Qt-Anwendungen, die auf einem „ Qt Wayland Compositor “ laufen. Mehr...

Import Statement: import QtWayland.Compositor.QtShell
Since: Qt 6.3

Signale

Ausführliche Beschreibung

Die QtShell-Erweiterung bietet die Möglichkeit, eine „ QtShellSurface “ mit einer regulären Wayland-Oberfläche zu verknüpfen. Die QtShell-Erweiterung wurde entwickelt, um die von Qt unterstützten Funktionen zur Fensterverwaltung zu nutzen. Sie eignet sich möglicherweise für Plattformen, auf denen sowohl der Compositor als auch die Client-Anwendungen mit Qt geschrieben sind und bei denen davon ausgegangen werden kann, dass Anwendungen Funktionen wie die manuelle Fensterpositionierung und „Bring-to-Front“ nicht missbrauchen.

Für andere Anwendungsfälle sollten Sie stattdessen die Verwendung von „ IviApplication “ oder „ XdgShell “ in Betracht ziehen.

import QtWayland.Compositor.QtShell

WaylandCompositor {
    property ListModel shellSurfaces: ListModel {}
    QtShell {
        onQtShellSurfaceCreated: {
             shellSurfaces.append({shellSurface: qtShellSurface})
        }
    }
}

Signal-Dokumentation

void qtShellSurfaceCreated(QtShellSurface *qtShellSurface)

Dieses Signal wird ausgelöst, wenn ein ` QtShellSurface ` erstellt wurde. Das übergebene ` qtShellSurface ` wird meist zur Instanziierung eines ` ShellSurfaceItem` verwendet.

Hinweis: Der entsprechende Handler ist „ onQtShellSurfaceCreated “.

void qtShellSurfaceRequested(WaylandSurface surface, WaylandResource resource)

Dieses Signal wird ausgelöst, wenn der Client angefordert hat, dass ein „ QtShellSurface “ mit „ surface “ verknüpft wird. Der Handler für dieses Signal soll den „ QtShellSurface “ für „ resource “ erstellen und ihn im Rahmen der Signalauslösung initialisieren. Wird kein „ QtShellSurface “ erstellt, wird stattdessen ein Standardobjekt erstellt.

Hinweis: Der entsprechende Handler lautet „ onQtShellSurfaceRequested “.

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