QWaylandXdgToplevel Class
La classe QWaylandXdgToplevel représente les éléments spécifiques à la fenêtre de niveau supérieur d'une surface xdg. En savoir plus...
| En-tête : | #include <QWaylandXdgToplevel> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS WaylandCompositor) target_link_libraries(mytarget PRIVATE Qt6::WaylandCompositor) |
| qmake : | QT += waylandcompositor |
| En QML : | XdgToplevel |
| Hérite de : | QObject |
Types publics
| enum | DecorationMode { ServerSideDecoration, ClientSideDecoration } |
Propriétés
|
|
Fonctions publiques
| QWaylandXdgToplevel(QWaylandXdgSurface *xdgSurface, QWaylandResource &resource) | |
| bool | activated() const |
| QString | appId() const |
| QWaylandXdgToplevel::DecorationMode | decorationMode() const |
| bool | fullscreen() const |
| bool | isModal() const |
| QSize | maxSize() const |
| bool | maximized() const |
| QSize | minSize() const |
| QWaylandXdgToplevel * | parentToplevel() const |
| bool | resizing() const |
| void | sendClose() |
| uint | sendConfigure(const QSize &size, const QList<QWaylandXdgToplevel::State> &states) |
| uint | sendFullscreen(const QSize &size) |
| uint | sendMaximized(const QSize &size) |
| uint | sendResizing(const QSize &size) |
| uint | sendUnmaximized(const QSize &size = QSize(0, 0)) |
| QSize | sizeForResize(const QSizeF &size, const QPointF &delta, Qt::Edges edges) const |
| QString | title() const |
| QWaylandXdgSurface * | xdgSurface() const |
Signaux
| void | activatedChanged() |
| void | appIdChanged() |
| void | decorationModeChanged() |
| void | fullscreenChanged() |
| void | maxSizeChanged() |
| void | maximizedChanged() |
| void | minSizeChanged() |
| void | modalChanged() |
| void | parentToplevelChanged() |
| void | resizingChanged() |
| void | statesChanged() |
| void | titleChanged() |
Membres publics statiques
| QWaylandXdgToplevel * | fromResource(wl_resource *resource) |
| QWaylandSurfaceRole * | role() |
Description détaillée
Cette classe fait partie de l'extension QWaylandXdgShell et permet d'étendre les fonctionnalités d'un QWaylandXdgSurface avec des fonctionnalités spécifiques aux fenêtres de type bureau.
Elle correspond à l’interface Wayland xdg_toplevel.
Documentation sur les types de membres
enum QWaylandXdgToplevel::DecorationMode
Ce type d'énumération sert à spécifier le mode de décoration des fenêtres de premier niveau.
| Constante | Valeur | Description |
|---|---|---|
QWaylandXdgToplevel::ServerSideDecoration | 2 | Le compositeur doit dessiner les décorations de fenêtre. |
QWaylandXdgToplevel::ClientSideDecoration | 1 | Le client doit dessiner les décorations de fenêtre. |
Documentation de la propriété
[read-only] activated : bool
Cette propriété indique si l'élément de niveau supérieur s'affiche comme ayant le focus.
Fonctions d'accès :
| bool | activated() const |
Signal de notification :
| void | activatedChanged() |
[read-only] appId : QString
Cette propriété contient l'identifiant de l'application de l'QWaylandXdgToplevel. Elle correspond à la propriété desktopFileName dans Qt.
Fonctions d'accès :
| QString | appId() const |
Signal de notification :
| void | appIdChanged() |
[read-only] decorationMode : enum DecorationMode
Cette propriété contient le mode de décoration de fenêtre actuel pour cet élément de niveau supérieur.
Fonctions d'accès :
| QWaylandXdgToplevel::DecorationMode | decorationMode() const |
Signal de notification :
| void | decorationModeChanged() |
Voir aussi QWaylandXdgDecorationManagerV1.
[read-only] fullscreen : bool
Cette propriété indique si le client a pris en compte le fait qu'il doit passer en mode plein écran.
Fonctions d'accès :
| bool | fullscreen() const |
Signal de notification :
| void | fullscreenChanged() |
[read-only] maxSize : QSize
Cette propriété définit la taille maximale de l'QWaylandXdgToplevel.
Le compositeur est libre d'ignorer cette valeur et de demander une taille supérieure.
Fonctions d'accès :
| QSize | maxSize() const |
Signal de notification :
| void | maxSizeChanged() |
[read-only] maximized : bool
Cette propriété indique si le client a confirmé qu’elle devait être affichée en plein écran.
Fonctions d'accès :
| bool | maximized() const |
Signal de notification :
| void | maximizedChanged() |
[read-only] minSize : QSize
Cette propriété définit la taille minimale de l'QWaylandXdgToplevel.
Le compositeur est libre d’ignorer cette valeur et de demander une taille inférieure.
Fonctions d'accès :
| QSize | minSize() const |
Signal de notification :
| void | minSizeChanged() |
[read-only, since 6.8] modal : bool
Cette propriété détermine si le bloc de niveau supérieur empêche les autres fenêtres de recevoir des entrées.
Cette énumération a été introduite dans Qt 6.8.
Fonctions d'accès :
| bool | isModal() const |
Signal de notification :
| void | modalChanged() |
[read-only] parentToplevel : QWaylandXdgToplevel*
Cette propriété contient l'objet parent de type « XdgToplevel » de cet objet de type « XdgToplevel ».
Fonctions d'accès :
| QWaylandXdgToplevel * | parentToplevel() const |
Signal de notification :
| void | parentToplevelChanged() |
[read-only] resizing : bool
Cette propriété indique si le client a pris connaissance du fait qu’il est en cours de redimensionnement.
Fonctions d'accès :
| bool | resizing() const |
Signal de notification :
| void | resizingChanged() |
[read-only] states : QList<int>
Cette propriété contient les derniers états que le client a confirmés pour ce QWaylandToplevel.
Signal du notificateur :
| void | statesChanged() |
[read-only] title : QString
Cette propriété détient le titre de « QWaylandXdgToplevel ».
Fonctions d'accès :
| QString | title() const |
Signal de notification :
| void | titleChanged() |
[read-only] xdgSurface : QWaylandXdgSurface* const
Cette propriété contient l'QWaylandXdgSurface s relatives à cette QWaylandXdgToplevel.
Fonctions d'accès :
| QWaylandXdgSurface * | xdgSurface() const |
Documentation des fonctions membres
[explicit] QWaylandXdgToplevel::QWaylandXdgToplevel(QWaylandXdgSurface *xdgSurface, QWaylandResource &resource)
Crée un objet `QWaylandXdgToplevel` pour les paramètres ` xdgSurface ` et ` resource` fournis.
[static] QWaylandXdgToplevel *QWaylandXdgToplevel::fromResource(wl_resource *resource)
Renvoie l'QWaylandXdgToplevel correspondant à l'resource.
[static] QWaylandSurfaceRole *QWaylandXdgToplevel::role()
Renvoie le rôle de surface associé à l'objet `QWaylandToplevel`.
[invokable] void QWaylandXdgToplevel::sendClose()
Envoie un événement de fermeture au client. Le client peut choisir d'ignorer cet événement.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
uint QWaylandXdgToplevel::sendConfigure(const QSize &size, const QList<QWaylandXdgToplevel::State> &states)
Envoie un événement de configuration au client. Le paramètre « size » contient la taille en pixels de la surface. Une valeur égale à zéro signifie que le client est libre de choisir la taille. Les « states » connues sont répertoriées dans QWaylandXdgToplevel::State.
[invokable] uint QWaylandXdgToplevel::sendFullscreen(const QSize &size)
Fonctionnalité permettant d'envoyer un événement « configure » avec l'état « plein écran » défini, et les options « agrandissement » et « redimensionnement » désactivées. L'état « activé » conserve sa valeur actuelle.
size est la nouvelle taille de la fenêtre.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
Voir également sendUnmaximized.
[invokable] uint QWaylandXdgToplevel::sendMaximized(const QSize &size)
Fonctionnalité permettant d'envoyer un événement « configure » avec l'état « maximisé » défini, et les options « plein écran » et « redimensionnement » désactivées. L'état « activé » conserve sa valeur actuelle.
size est la nouvelle taille de la fenêtre.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable] uint QWaylandXdgToplevel::sendResizing(const QSize &size)
Fonctionnalité permettant d'envoyer un événement « configure » avec l'état de redimensionnement défini, et les états « maximisé » et « plein écran » supprimés. L'état « activé » reste inchangé.
size est la nouvelle taille de la fenêtre.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable] uint QWaylandXdgToplevel::sendUnmaximized(const QSize &size = QSize(0, 0))
Fonctionnalité permettant d'envoyer un événement de configuration en supprimant les états « maximisé », « plein écran » et « redimensionnement », ainsi que les états « plein écran » et « redimensionnement ». L'état « activé » conserve sa valeur actuelle.
size est la nouvelle taille de la fenêtre. Si « size » est égal à zéro, c'est le client qui détermine la taille.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable] QSize QWaylandXdgToplevel::sizeForResize(const QSizeF &size, const QPointF &delta, Qt::Edges edges) const
Fonction pratique permettant de calculer la nouvelle taille à partir de l'size, d'un delta et de l'edges actifs lors du glisser-déposer.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
© 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.
