Sur cette page

QtShell QML Type

Fournit une extension de shell pour les applications Qt s'exécutant sur Qt Wayland Compositor. En savoir plus…

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

Signaux

Description détaillée

L'extension QtShell permet d'associer une application « QtShellSurface » à une surface Wayland standard. L'extension QtShell a été conçue pour prendre en charge les fonctionnalités de gestion des fenêtres offertes par Qt. Elle peut s'avérer adaptée sur une plateforme où le compositeur et les applications clientes sont tous deux développés avec Qt, et où l'on peut être sûr que les applications n'abuseront pas de fonctionnalités telles que le positionnement manuel des fenêtres et la fonction « amener au premier plan ».

Pour d’autres cas d’utilisation, envisagez plutôt d’utiliser IviApplication ou XdgShell.

import QtWayland.Compositor.QtShell

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

Documentation sur les signaux

void qtShellSurfaceCreated(QtShellSurface *qtShellSurface)

Ce signal est émis lorsqu'une instance de type ` QtShellSurface ` a été créée. L'qtShellSurface fournie est le plus souvent utilisée pour instancier un objet de type ` ShellSurfaceItem`.

Remarque : le gestionnaire correspondant est onQtShellSurfaceCreated.

void qtShellSurfaceRequested(WaylandSurface surface, WaylandResource resource)

Ce signal est émis lorsque le client a demandé qu’un QtShellSurface soit associé à surface. Le gestionnaire de ce signal doit créer l’ QtShellSurface pour resource et l’initialiser dans le cadre de l’émission du signal. Si aucun QtShellSurface n’est créé, un par défaut sera créé à la place.

Remarque : le gestionnaire correspondant est 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.