QtShellSurface QML Type
Permet d'identifier et de redimensionner facilement une surface. En savoir plus...
| Import Statement: | import QtWayland.Compositor.QtShell |
| Since: | Qt 6.3 |
Propriétés
- active : bool
- capabilities : enum
- frameMarginBottom : int
- frameMarginLeft : int
- frameMarginRight : int
- frameMarginTop : int
- maximumSize : size
- minimumSize : size
- surface : WaylandSurface
- windowFlags : int
- windowGeometry : rect
- windowPosition : point
- windowState : int
- windowTitle : string
Signaux
- void startMove()
- void startResize(enum edges)
Méthodes
- void initialize(QtShell qtShell, WaylandSurface surface, WaylandResource resource)
- void requestWindowGeometry(int windowState, rect windowGeometry)
- void sendClose()
Description détaillée
Ce type fait partie de l'extension QtShell et permet d'étendre les fonctionnalités d'un compositeur existant ( WaylandSurface ) avec des fonctionnalités de gestion des fenêtres.
Le type QtShellSurface contient les fonctionnalités essentielles nécessaires à la création d’un compositeur prenant en charge l’extension QtShell. Il peut être utilisé directement ou via le type QtShellChrome, selon les besoins du compositeur. Le type QtShellChrome dispose de comportements par défaut et d’API pratiques pour travailler avec des objets QtShellSurface.
Documentation des propriétés
active : bool
Cette propriété s'applique, que la surface soit ou non considérée comme active à ce moment-là.
Remarque : il n'existe aucune restriction dans QtShellSurface empêchant plusieurs surfaces d'être actives simultanément. Une telle logique doit soit être implémentée 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é définit les capacités du compositeur. Par défaut, aucune capacité particulière n’est activée.
- QtShellSurface.InteractiveMove Le client peut déclencher une opération de déplacement interactive côté serveur à l’aide de la fonction ` QWindow::startSystemMove()`. Le compositeur en sera informé via le signal ` startMove()`.
- QtShellSurface.InteractiveResize Le client peut déclencher une opération de redimensionnement interactive côté serveur à l’aide de la fonction ` QWindow::startSystemResize()`. Le compositeur en sera informé via le signal ` startResize()`.
frameMarginBottom : int
Cela permet de maintenir la marge du cadre de la fenêtre en dessous de la surface.
frameMarginLeft : int
Cela permet de maintenir la marge du cadre de la fenêtre à gauche de la surface.
frameMarginRight : int
Cela permet de maintenir la marge du cadre de la fenêtre à droite de la surface.
frameMarginTop : int
Cela permet de maintenir la marge du cadre de la fenêtre au-dessus de la surface.
maximumSize : size [read-only]
La taille maximale de la fenêtre si le client en a spécifié une. Sinon, 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 indicateurs de fenêtre de l'QtShellSurface.
windowGeometry : rect [read-only]
Cette propriété contient la géométrie de la fenêtre correspondant à la surface de la coque.
windowPosition : point
Cette propriété indique la position de la surface du shell par rapport à sa sortie.
windowState : int [read-only]
Cette propriété contient l'état de la fenêtre de l'QtShellSurface.
Remarque : lorsque la méthode ` requestWindowGeometry()` est appelée pour mettre à jour l'état de la surface, la propriété ` windowState ` ne sera pas mise à jour tant que le client n'aura pas validé le changement d'état.
windowTitle : string [read-only]
Cette propriété contient le titre de la fenêtre de l'QtShellSurface.
Documentation Signal
void startMove()
Le client a demandé une opération de déplacement interactive dans le compositeur en appelant la fonction ` QWindow::startSystemMove()`.
Remarque : le gestionnaire correspondant est onStartMove.
Voir également capabilities.
void startResize(enum edges)
Le client a demandé une opération de redimensionnement interactive dans le compositeur en appelant la fonction ` QWindow::startSystemResize()`.
La fonction ` edges ` fournit des informations sur le bord de la fenêtre qui doit être déplacé lors du redimensionnement. Il s'agit d'un masque composé des valeurs suivantes :
- Qt.TopEdge
- Qt.LeftEdge
- Qt.RightEdge
- Qt.BottomEdge
Remarque : le gestionnaire correspondant est onStartResize.
Voir également capabilities.
Documentation de la méthode
void initialize(QtShell qtShell, WaylandSurface surface, WaylandResource resource)
Initialise l'objet ` QtShellSurface` en l'associant aux éléments ` qtShell`, ` surface` et ` resource` indiqués.
void requestWindowGeometry(int windowState, rect windowGeometry)
Demande une nouvelle instance de ` windowState ` et une nouvelle instance de ` windowGeometry ` pour la ` QtShellSurface`. L'état et la géométrie sont mis à jour une fois que le client a accusé réception de la requête (on peut alors supposer sans risque que la taille du tampon de la surface a été redimensionnée si nécessaire).
void sendClose()
Demande à l'application cliente de se fermer.
© 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.
