QWaylandXdgToplevel Class
La classe QWaylandXdgToplevel représente les parties spécifiques à la fenêtre de niveau supérieur d'une surface xdg. Plus d'informations...
| 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éritages : | 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 &maxSize) |
| 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 fournit un moyen d'étendre les fonctionnalités d'une QWaylandXdgSurface avec des caractéristiques spécifiques aux fenêtres de type bureau.
Elle correspond à l'interface Wayland xdg_toplevel.
Type de membre Documentation
enum QWaylandXdgToplevel::DecorationMode
Ce type d'énumération est utilisé pour spécifier le mode de décoration de la fenêtre pour les fenêtres de niveau supérieur.
| Constante | Valeur | Description |
|---|---|---|
QWaylandXdgToplevel::ServerSideDecoration | 2 | Le compositeur doit dessiner les décorations de la fenêtre. |
QWaylandXdgToplevel::ClientSideDecoration | 1 | Le client doit dessiner les décorations des fenêtres. |
Propriété Documentation
[read-only] activated : bool
Cette propriété indique si toplevel se dessine comme ayant le focus d'entrée.
Fonctions d'accès :
| bool | activated() const |
Signal du notificateur :
| void | activatedChanged() |
[read-only] appId : QString
Cette propriété contient l'identifiant de l'application QWaylandXdgToplevel.
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 actuel de la fenêtre pour cet étage.
Fonctions d'accès :
| QWaylandXdgToplevel::DecorationMode | decorationMode() const |
Signal du notificateur :
| void | decorationModeChanged() |
Voir aussi QWaylandXdgDecorationManagerV1.
[read-only] fullscreen : bool
Cette propriété indique si le client a reconnu qu'il devait être en plein écran.
Fonctions d'accès :
| bool | fullscreen() const |
Signal du notificateur :
| void | fullscreenChanged() |
[read-only] maxSize : QSize
Cette propriété indique la taille maximale du site QWaylandXdgToplevel.
Le compositeur est libre d'ignorer cette valeur et de demander une taille plus grande.
Fonctions d'accès :
| QSize | maxSize() const |
Signal de notification :
| void | maxSizeChanged() |
[read-only] maximized : bool
Cette propriété indique si le client a reconnu qu'elle devait être maximisée.
Fonctions d'accès :
| bool | maximized() const |
Signal du notificateur :
| void | maximizedChanged() |
[read-only] minSize : QSize
Cette propriété indique la taille minimale du site QWaylandXdgToplevel.
Le compositeur est libre d'ignorer cette valeur et de demander une taille plus petite.
Fonctions d'accès :
| QSize | minSize() const |
Signal de notification :
| void | minSizeChanged() |
[read-only, since 6.8] modal : bool
Cette propriété indique si toplevel empêche les autres fenêtres de recevoir des données.
Cette propriété a été introduite dans Qt 6.8.
Fonctions d'accès :
| bool | isModal() const |
Signal Notifier :
| void | modalChanged() |
[read-only] parentToplevel : QWaylandXdgToplevel*
Cette propriété contient le XdgToplevel parent de ce 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 reconnu qu'il était en train d'être redimensionné.
Fonctions d'accès :
| bool | resizing() const |
Signal du notificateur :
| void | resizingChanged() |
[read-only] states : QList<int>
Cette propriété contient les derniers états reconnus par le client pour ce QWaylandToplevel.
Notifier :
| void | statesChanged() |
[read-only] title : QString
Cette propriété détient le titre de propriété du QWaylandXdgToplevel.
Fonctions d'accès :
| QString | title() const |
Signal de notification :
| void | titleChanged() |
[read-only] xdgSurface : QWaylandXdgSurface* const
Cette propriété contient le site QWaylandXdgSurface pour ce site QWaylandXdgToplevel.
Fonctions d'accès :
| QWaylandXdgSurface * | xdgSurface() const |
Documentation des fonctions membres
[explicit] QWaylandXdgToplevel::QWaylandXdgToplevel(QWaylandXdgSurface *xdgSurface, QWaylandResource &resource)
Construit un QWaylandXdgToplevel pour xdgSurface et resource.
[static] QWaylandXdgToplevel *QWaylandXdgToplevel::fromResource(wl_resource *resource)
Retourne le QWaylandXdgToplevel correspondant au resource.
[static] QWaylandSurfaceRole *QWaylandXdgToplevel::role()
Renvoie le rôle de la surface pour le 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 invoquée via le système de méta-objets et à partir de 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 taille de zéro signifie que le client est libre de décider de la taille. Les adresses states connues sont énumérées dans QWaylandXdgToplevel::State.
[invokable] uint QWaylandXdgToplevel::sendFullscreen(const QSize &size)
Pratique pour envoyer un événement de configuration avec l'état plein écran défini, et maximisé et redimensionné supprimé. L'état activé est laissé dans son état actuel.
size est la nouvelle taille de la fenêtre.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
Voir également sendUnmaximized.
[invokable] uint QWaylandXdgToplevel::sendMaximized(const QSize &size)
Pratique pour envoyer un événement de configuration avec l'état maximisé défini, et le plein écran et le redimensionnement supprimés. L'état activé est laissé dans son état actuel.
size est la nouvelle taille de la fenêtre.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] uint QWaylandXdgToplevel::sendResizing(const QSize &maxSize)
Pratique pour envoyer un événement de configuration avec l'état de redimensionnement défini, et les états maximisé et plein écran supprimés. L'état activé est laissé dans son état actuel.
maxSize est la nouvelle taille de la fenêtre.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] uint QWaylandXdgToplevel::sendUnmaximized(const QSize &size = QSize(0, 0))
Pratique pour envoyer un événement de configuration avec les états maximisé, plein écran et redimensionné supprimés, et plein écran et redimensionné supprimés. L'état activé est laissé dans son état actuel.
size est la nouvelle taille de la fenêtre. Si size est égal à zéro, c'est le client qui décide de la taille.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] QSize QWaylandXdgToplevel::sizeForResize(const QSizeF &size, const QPointF &delta, Qt::Edges edges) const
Pratique pour calculer la nouvelle taille en fonction de l'adresse actuelle size, d'une adresse delta et de l'adresse edges active dans la zone de déplacement.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de 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.
