QWaylandSurface Class

Documentation des fonctions membres

QWaylandSurface::QWaylandSurface()

Construit une QWaylandSurface non initialisée.

QWaylandSurface::QWaylandSurface(QWaylandCompositor *compositor, QWaylandClient *client, uint id, int version)

Construit et initialise une QWaylandSurface pour les données compositor et client, et avec les données id et version.

[override virtual noexcept] QWaylandSurface::~QWaylandSurface()

Détruit le site QWaylandSurface.

[signal] void QWaylandSurface::childAdded(QWaylandSurface *child)

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

QWaylandCompositor *QWaylandSurface::compositor() const

Renvoie le compositeur pour cette QWaylandSurface.

[invokable] void QWaylandSurface::destroy()

Détruit le site QWaylandSurface.

[signal] void QWaylandSurface::dragStarted(QWaylandDrag *drag)

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

[invokable] void QWaylandSurface::frameStarted()

Prépare tous les rappels de trame pour l'envoi.

[static] QWaylandSurface *QWaylandSurface::fromResource(wl_resource *resource)

Renvoie la ressource QWaylandSurface correspondant à la ressource Wayland resource.

[invokable] void QWaylandSurface::initialize(QWaylandCompositor *compositor, QWaylandClient *client, uint id, int version)

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

bool QWaylandSurface::inputRegionContains(const QPoint &p) const

Renvoie true si la région d'entrée de QWaylandSurface contient le point p. Sinon, il renvoie false.

bool QWaylandSurface::inputRegionContains(const QPointF &position) const

Renvoie true si la région d'entrée de QWaylandSurface contient le point position. Sinon, il renvoie false.

[invokable] bool QWaylandSurface::isDestroyed() const

Retourne vrai si le site QWaylandSurface a été détruit. Dans le cas contraire, elle renvoie false.

bool QWaylandSurface::isInitialized() const

Retourne vrai si le site QWaylandSurface a été initialisé.

QWaylandView *QWaylandSurface::primaryView() const

Renvoie la vue principale de ce site QWaylandSurface.

Voir aussi QWaylandView::advance() et QWaylandSurface::setPrimaryView().

struct wl_resource *QWaylandSurface::resource() const

Retourne la ressource Wayland correspondant à cette QWaylandSurface.

[invokable] void QWaylandSurface::sendFrameCallbacks()

Envoie les rappels de trame en attente.

void QWaylandSurface::setPrimaryView(QWaylandView *view)

Définit la vue principale de ce site QWaylandSurface à view, au cas où il y aurait plusieurs vues de cette surface. La vue primaire est la vue qui régit le taux de rafraîchissement du client. Elle se charge d'éliminer les références au tampon lorsque QWaylandView::advance() est appelé. Voir la documentation de QWaylandView::advance() pour plus de détails.

Dans les intégrations de surface shell, telles que QWaylandWlShellIntegration et QWaylandXdgShellV5Integration, les demandes de maximisation et de plein écran du client n'auront un effet que si l'intégration a la vue principale de la surface.

Voir également primaryView() et QWaylandView::advance().

bool QWaylandSurface::setRole(QWaylandSurfaceRole *role, wl_resource *errorResource, uint32_t errorCode)

Définit un role sur la surface. Un rôle définit la manière dont une surface sera représentée à l'écran ; sans rôle, une surface est censée être cachée. Une fois qu'un rôle est attribué à une surface, il devient son rôle permanent. Tout appel ultérieur à setRole() avec un rôle différent déclenchera une erreur de protocole à errorResource et enverra un errorCode au client. L'objectif principal du rôle de la surface est de faire respecter cette exigence.

L'adresse role est comparée en fonction de la valeur du pointeur. Deux objets de QWaylandSurfaceRole seront considérés comme des rôles différents, quel que soit leur nom.

Le rôle de surface est défini en interne par les implémentations de protocole lorsqu'une surface est adoptée dans un but spécifique, par exemple dans une extension shell. À moins que vous ne développiez des extensions qui utilisent les surfaces de cette manière, vous ne devriez pas appeler cette fonction.

Retourne true si un rôle peut être attribué, false sinon.

[signal] void QWaylandSurface::surfaceDestroyed()

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

[slot] void QWaylandSurface::updateSelection()

Met à jour la surface avec la sélection du presse-papiers conservée par le compositeur. Bien que cela se fasse automatiquement lorsque la surface reçoit le focus clavier, cette fonction est utile pour mettre à jour les clients qui n'ont pas le focus clavier.

QList<QWaylandView *> QWaylandSurface::views() const

Retourne les vues pour cette QWaylandSurface.

wl_client *QWaylandSurface::waylandClient() const

Maintient le site wl_client en utilisant ce site QWaylandSurface.