Sur cette page

WaylandSurface QML Type

Représente une zone rectangulaire sur un périphérique de sortie. Plus d'informations...

Import Statement: import QtWayland.Compositor
In C++: QWaylandSurface

Propriétés

Signaux

Méthodes

Description détaillée

Ce type encapsule une zone rectangulaire de pixels qui est affichée sur un périphérique de sortie. Il correspond à l'interface wl_surface du protocole Wayland.

Propriété Documentation

bufferScale : size [read-only]

Cette propriété définit l'échelle de la mémoire tampon du site WaylandSurface. L'échelle de la mémoire tampon permet à un client de fournir des données de mémoire tampon à plus haute résolution pour les utiliser sur des sorties à haute résolution.

bufferSize : size [read-only]

Cette propriété indique la taille de la mémoire tampon actuelle de ce site WaylandSurface en pixels, et non en coordonnées de surface.

Pour obtenir la taille en coordonnées de surface, utilisez plutôt destinationSize.

Voir également destinationSize et bufferScale.

client : WaylandClient [read-only]

Cette propriété retient le client qui utilise ce site WaylandSurface.

contentOrientation : enum [read-only]

Cette propriété indique l'orientation du contenu du site WaylandSurface.

Voir aussi WaylandOutput.transform.

cursorSurface : bool

Cette propriété indique si le site WaylandSurface est une surface de curseur.

destinationSize : size [read-only]

Cette propriété indique la taille de ce site WaylandSurface en coordonnées de surface.

Voir également bufferScale et bufferSize.

hasContent : bool [read-only]

Cette propriété indique si le site WaylandSurface a un contenu.

inhibitsIdle : bool [read-only]

Cette propriété indique si cette surface est destinée à inhiber le comportement d'inactivité du compositeur, tel que la suppression, le verrouillage et l'enregistrement de l'écran.

Voir également IdleInhibitManagerV1.

isOpaque : bool [read-only, since 6.4]

Cette propriété indique si la surface est totalement opaque, comme le signale le client à travers la requête set_opaque_region.

Cette propriété a été introduite dans Qt 6.4.

origin : enum [read-only]

Cette propriété indique l'origine du tampon de WaylandSurface ou WaylandSurface.OriginTopLeft si la surface n'a pas de tampon.

Elle peut prendre les valeurs suivantes :

  • WaylandSurface.OriginTopLeft L'origine est le coin supérieur gauche de la mémoire tampon.
  • WaylandSurface.OriginBottomLeft L'origine est le coin inférieur gauche de la mémoire tampon.

sourceGeometry : rect [read-only]

Cette propriété décrit la partie du tampon Wayland attaché qui doit être dessinée à l'écran. Les coordonnées partent du coin du tampon et sont mises à l'échelle par bufferScale.

Voir également bufferScale, bufferSize, et destinationSize.

useTextureAlpha : bool

Cette propriété indique si la surface doit utiliser la texture alpha.

Documentation sur les signaux

childAdded(WaylandSurface child)

Ce signal est émis lorsqu'une wl_subsurface, child, a été ajoutée à la surface.

Remarque : le gestionnaire correspondant est onChildAdded.

void dragStarted(WaylandDrag drag)

Ce signal est émis lorsqu'un site drag a démarré à partir de cette surface.

Remarque : le gestionnaire correspondant est onDragStarted.

surfaceDestroyed()

Ce signal est émis lorsque la surface wl_surface correspondante est détruite.

Note : Le gestionnaire correspondant est onSurfaceDestroyed.

Documentation de la méthode

void destroy()

Détruit le site WaylandSurface.

void initialize(WaylandCompositor compositor, WaylandClient client, int id, int version)

Initialise le site WaylandSurface avec les données compositor et client, et avec les données id et version.

bool isDestroyed()

Renvoie true si le site WaylandSurface a été détruit. Sinon, il renvoie false.

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