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.
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.
- 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 biais du 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 |
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 |
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 |
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 |
Cette propriété contient la surface associée à cette QtShellSurface.
windowFlags : int |
Cette propriété contient les drapeaux de fenêtre de la fenêtre QtShellSurface.
windowGeometry : rect |
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 |
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 |
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.
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.