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
- 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 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.
Documentation sur les propriétés
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.
- QtShellSurface.InteractiveMove Le client peut déclencher une opération de déplacement interactive côté serveur en utilisant QWindow::startSystemMove(). Le compositeur en sera informé par le signal startMove().
- QtShellSurface.InteractiveResize Le client peut déclencher une opération de redimensionnement interactive côté serveur en utilisant QWindow::startSystemResize(). Le compositeur en sera informé par le signal startResize().
frameMarginBottom : int
Cela permet de maintenir la marge du cadre de la fenêtre sous la surface.
frameMarginLeft : int
Il s'agit de la marge du cadre de la fenêtre à gauche de la surface.
frameMarginRight : int
Elle maintient la marge du cadre de la fenêtre à droite de la surface.
frameMarginTop : int
Cela permet de maintenir le bord 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, 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 à ce site QtShellSurface.
windowFlags : int [read-only]
Cette propriété contient les drapeaux de fenêtre du site QtShellSurface.
windowGeometry : rect [read-only]
Cette propriété contient 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é contient l'état de la fenêtre de la surface 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 du site QtShellSurface.
Documentation sur le 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 aussi capabilities.
void startResize(enum edges)
Le client a demandé une opération de redimensionnement interactive dans le compositeur en appelant QWindow::startSystemResize().
L'adresse 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 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 (on peut alors supposer que le tampon de la surface a été redimensionné si nécessaire).
void sendClose()
Demande que l'application client se ferme elle-même.
© 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.
