QtShellSurface QML Type

Fournit un moyen simple d'identifier et de redimensionner une surface. Plus d'informations...

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

Propriétés

Signaux

Méthodes

Description détaillée

Ce type fait partie de l'extension QtShell et permet d'étendre la fonctionnalité d'un WaylandSurface existant avec une fonctionnalité de gestion des fenêtres.

Le type QtShellSurface contient les fonctionnalités de base nécessaires à la création d'un compositeur prenant en charge l'extension QtShell. Il peut être utilisé directement ou via le type QtShellChrome, en fonction des besoins du compositeur. Le type QtShellChrome a des comportements par défaut et des API de commodité pour travailler avec des objets QtShellSurface.

Propriété Documentation

active : bool

Cette propriété indique si la surface est actuellement considérée comme active.

Remarque : il n'existe aucune restriction dans QtShellSurface qui empêche plusieurs surfaces d'être actives simultanément. Une telle logique doit être mise en œuvre soit par le compositeur lui-même, soit en utilisant le type QtShellChrome, qui gérera automatiquement l'état d'activation des surfaces.


capabilities : enum

Cette propriété contient les capacités du compositeur. Par défaut, aucune capacité spéciale n'est activée.


frameMarginBottom : int

Ceci maintient la marge du cadre de la fenêtre sous la surface.


frameMarginLeft : int

Ceci maintient la marge du cadre de la fenêtre à gauche de la surface.


frameMarginRight : int

Ceci maintient la marge du cadre de la fenêtre à droite de la surface.


frameMarginTop : int

La marge du cadre de la fenêtre au-dessus de la surface.


maximumSize : size [read-only]

Taille maximale de la fenêtre si le client en a spécifié une. Sinon, il s'agit d'une taille non valide.


minimumSize : size [read-only]

La taille minimale de la fenêtre si le client en a spécifié une. Sinon, il s'agit d'une taille non valide.


surface : WaylandSurface [read-only]

Cette propriété contient la surface associée à cette QtShellSurface.


windowFlags : int [read-only]

Cette propriété contient les drapeaux de fenêtre de la fenêtre QtShellSurface.


windowGeometry : rect [read-only]

Cette propriété indique la géométrie de la fenêtre de la surface de la coquille.


windowPosition : point

Cette propriété indique la position de la surface de la coquille par rapport à sa sortie.


windowState : int [read-only]

Cette propriété indique l'état de la fenêtre de QtShellSurface.

Remarque : lorsque requestWindowGeometry() est appelé pour mettre à jour l'état de la surface, la propriété windowState n'est pas mise à jour tant que le client n'a pas accusé réception du changement d'état.


windowTitle : string [read-only]

Cette propriété contient le titre de la fenêtre de QtShellSurface.


Documentation du signal

void startMove()

Le client a demandé une opération de déplacement interactive dans le compositeur en appelant QWindow::startSystemMove().

Remarque : le gestionnaire correspondant est onStartMove.

Voir également capabilities.


void startResize(enum edges)

Le client a demandé une opération interactive de redimensionnement dans le compositeur en appelant QWindow::startSystemResize().

Le edges fournit des informations sur le bord de la fenêtre qui doit être déplacé pendant le redimensionnement. Il s'agit d'un masque des valeurs suivantes :

  • Qt.TopEdge
  • Qt.LeftEdge
  • Qt.RightEdge
  • Qt.BottomEdge

Remarque : le gestionnaire correspondant est onStartResize.

Voir aussi capabilities.


Documentation de la méthode

void initialize(QtShell qtShell, WaylandSurface surface, WaylandResource resource)

Initialise le site QtShellSurface, en l'associant aux sites qtShell, surface, et resource.


void requestWindowGeometry(int windowState, rect windowGeometry)

Demande un nouveau windowState et windowGeometry pour le QtShellSurface. L'état et la géométrie sont mis à jour lorsque le client a accusé réception de la demande (à ce moment-là, on peut supposer que le tampon de la surface a été redimensionné si nécessaire).


void sendClose()

Demande que l'application cliente se ferme.


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