QtShell QML Type

Bietet eine Shell-Erweiterung für Qt-Anwendungen, die auf einer Qt Wayland Compositor laufen .

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

Signale

Detaillierte Beschreibung

Die QtShell-Erweiterung bietet eine Möglichkeit, eine QtShellSurface mit einer regulären Wayland-Oberfläche zu verknüpfen. Die QtShell-Erweiterung wurde geschrieben, um die Fensterverwaltungsfunktionen zu unterstützen, die von Qt unterstützt werden. Sie eignet sich für Plattformen, auf denen sowohl der Compositor als auch die Client-Applikationen mit Qt geschrieben sind und bei denen man sich darauf verlassen kann, dass die Applikationen Funktionen wie manuelle Fensterpositionierung und "Bring-to-Front" nicht missbrauchen.

Für andere Anwendungsfälle sollten Sie stattdessen IviApplication oder XdgShell verwenden.

import QtWayland.Compositor.QtShell

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

Signal Dokumentation

void qtShellSurfaceCreated(QtShellSurface *qtShellSurface)

Dieses Signal wird ausgegeben, wenn ein QtShellSurface erstellt wurde. Das mitgelieferte qtShellSurface wird am häufigsten verwendet, um ein ShellSurfaceItem zu instanziieren.

Hinweis: Der entsprechende Handler ist onQtShellSurfaceCreated.


void qtShellSurfaceRequested(WaylandSurface surface, WaylandResource resource)

Dieses Signal wird ausgegeben, wenn der Client ein QtShellSurface angefordert hat, das mit surface verknüpft werden soll. Es wird erwartet, dass der Handler für dieses Signal die QtShellSurface für resource erstellt und sie im Rahmen der Signalausgabe initialisiert. Wenn kein QtShellSurface erstellt wird, wird stattdessen ein Standard erstellt.

Hinweis: Der entsprechende Handler ist onQtShellSurfaceRequested.


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