QWaylandSurface Class

Documentation des fonctions membres

QWaylandSurface::QWaylandSurface()

Crée un objet `QWaylandSurface` non initialisé.

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

Crée et initialise un objet `QWaylandSurface` pour les paramètres ` compositor ` et ` client` fournis, ainsi que pour les paramètres ` id ` et ` version` fournis.

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

Supprime l'QWaylandSurface.

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

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

QWaylandCompositor *QWaylandSurface::compositor() const

Renvoie le compositeur associé à cette QWaylandSurface.

[invokable] void QWaylandSurface::destroy()

Supprime l'QWaylandSurface.

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

Ce signal est émis lorsqu'un « drag » a été lancé depuis cette surface.

[invokable] void QWaylandSurface::frameStarted()

Prépare tous les callbacks de trame en vue de leur envoi.

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

Renvoie l’ QWaylandSurface e correspondant à la ressource Wayland resource.

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

Initialise l’ QWaylandSurface avec les paramètres compositor et client fournis, ainsi qu’avec les paramètres id et version fournis.

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

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

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

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

[invokable] bool QWaylandSurface::isDestroyed() const

Renvoie « true » si l’ QWaylandSurface a été détruite. Sinon, renvoie « false ».

bool QWaylandSurface::isInitialized() const

Renvoie « true » si l'QWaylandSurface e a été initialisé.

QWaylandView *QWaylandSurface::primaryView() const

Renvoie la vue principale de cet objet QWaylandSurface.

Voir également QWaylandView::advance() et QWaylandSurface::setPrimaryView().

struct wl_resource *QWaylandSurface::resource() const

Renvoie la ressource Wayland correspondant à cette adresse QWaylandSurface.

[invokable] void QWaylandSurface::sendFrameCallbacks()

Envoie les callbacks des trames en attente.

void QWaylandSurface::setPrimaryView(QWaylandView *view)

Définit la vue principale de cette surface ( QWaylandSurface) sur view, dans le cas où il existerait plusieurs vues de cette surface. La vue principale est celle qui détermine la fréquence de rafraîchissement du client. Elle se charge de supprimer les références au tampon lorsque la fonction QWaylandView::advance() est appelée. Pour plus de détails, consultez la documentation relative à la fonction QWaylandView::advance().

Dans les intégrations de surface de shell, telles que `QWaylandWlShellIntegration` et `QWaylandXdgShellV5Integration`, les requêtes d'agrandissement et de passage en plein écran provenant du client n'auront d'effet que si l'intégration dispose de 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 affichée à l'écran ; sans rôle, une surface est censée être masquée. Une fois qu'un rôle est attribué à une surface, celui-ci devient son rôle permanent. Tout appel ultérieur à ` setRole() ` avec un rôle différent déclenchera une erreur de protocole vers l'errorResource et enverra un message ` errorCode ` au client. L'application de cette contrainte est l'objectif principal du rôle de surface.

La fonction ` role ` effectue une comparaison par valeur de pointeur. Deux objets de type ` QWaylandSurfaceRole `, quels que soient leurs noms, seront considérés comme des rôles différents.

Le rôle de surface est défini en interne par les implémentations de protocole lorsqu’une surface est adoptée à des fins spécifiques, par exemple dans une extension de shell. À moins que vous ne développiez des extensions utilisant les surfaces de cette manière, vous ne devez pas appeler cette fonction.

Renvoie « true » si un rôle peut être attribué ; « false » dans le cas contraire.

[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 cette opération soit effectuée automatiquement lorsque la surface reçoit le focus clavier, cette fonction est utile pour mettre à jour les clients qui ne disposent pas du focus clavier.

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

Renvoie les vues associées à cette QWaylandSurface.

wl_client *QWaylandSurface::waylandClient() const

Contient l’ wl_client s à l’aide de ce lien : QWaylandSurface.