Sur cette page

XdgShell QML Type

Fournit une extension pour les interfaces utilisateur de type bureau. En savoir plus...

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

Signaux

Méthodes

  • void ping(WaylandClient client)

Description détaillée

L'extension XdgShell permet d'associer une surface XdgToplevel ou XdgPopup à une surface Wayland standard. À l'aide de l'interface XdgToplevel, le client peut demander le redimensionnement, le déplacement, etc. de la surface.

XdgShell correspond à l'interface Wayland xdg_shell.

Pour fournir les fonctionnalités de l'extension de shell dans un compositeur, créez une instance du composant XdgShell et ajoutez-la à la liste des extensions prises en charge par le compositeur :

import QtWayland.Compositor.XdgShell

WaylandCompositor {
    XdgShell {
        // ...
    }
}

Documentation sur les signaux

pong(int serial)

Ce signal est émis lorsque le client a répondu à un événement « ping » avec la chaîne « serial ».

Remarque : le gestionnaire correspondant est onPong.

Voir également ping().

popupCreated(XdgPopup popup, XdgSurface xdgSurface)

Ce signal est émis lorsque le client a créé un objet ` xdg_popup`. Un cas d'utilisation courant consiste à laisser le gestionnaire de ce signal instancier un objet ` ShellSurfaceItem ` ou ` WaylandQuickItem ` afin d'afficher ` popup ` dans une scène ` QtQuick `.

xdgSurface est l’ XdgSurface, dont popup est l’objet de rôle.

Remarque : le gestionnaire correspondant est onPopupCreated.

toplevelCreated(XdgToplevel toplevel, XdgSurface xdgSurface)

Ce signal est émis lorsque le client a créé un objet ` xdg_toplevel`. Un cas d'utilisation courant consiste à laisser le gestionnaire de ce signal instancier un objet ` ShellSurfaceItem ` ou ` WaylandQuickItem ` afin d'afficher ` toplevel ` dans une scène ` QtQuick `.

xdgSurface est l’ XdgSurface, dont toplevel est l’objet de rôle.

Remarque : le gestionnaire correspondant est onToplevelCreated.

xdgSurfaceCreated(XdgSurface xdgSurface)

Ce signal est émis lorsque le client a créé un objet ` xdg_surface`. Notez que ` xdgSurface ` n'est pas mappé, c'est-à-dire que, conformément au protocole xdg-shell, il ne doit pas être affiché tant que le client n'a pas reçu d'objet de rôle.

Remarque : le gestionnaire correspondant est onXdgSurfaceCreated.

Voir également toplevelCreated() et popupCreated().

Documentation de la méthode

void ping(WaylandClient client)

Envoie un événement « ping » à client. Si le client répond à cet événement, le signal « pong » sera émis.

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