WaylandQuickItem QML Type

Le type WaylandQuickItem fournit un élément « Qt Quick » qui représente la surface d'un client Wayland. En savoir plus...

• Liste de tous les membres, y compris les membres hérités

Propriétés

• bufferLocked : bool
• compositor : WaylandCompositor
• focusOnClick : bool
• inputEventsEnabled : bool
• origin : enum
• output : WaylandOutput
• paintEnabled : bool
• subsurfaceHandler : object
• surface : WaylandSurface
• touchEventsEnabled : bool

Signaux

• void surfaceDestroyed()

Méthodes

• point mapFromSurface(point point)
• point mapToSurface(point point)
• void setPrimary()

Description détaillée

Qt QuickLes compositeurs Wayland basés sur ce type peuvent l'utiliser pour afficher le contenu d'un client sur un périphérique de sortie. Il transmet les entrées de l'utilisateur au client.

Documentation des propriétés

bufferLocked : bool

Cette propriété indique si le tampon de l'élément est actuellement verrouillé. Tant que le tampon est verrouillé, il ne sera pas libéré ni renvoyé au client.

La valeur par défaut est « false ».

compositor : WaylandCompositor [read-only]

Cette propriété contient le compositeur de la surface rendue par cette WaylandQuickItem.

focusOnClick : bool

Cette propriété permet de définir si l'WaylandQuickItem e doit recevoir le focus lorsqu'on clique ou qu'on le touche.

La valeur par défaut est « true ».

inputEventsEnabled : bool

Cette propriété indique si les événements d'entrée sont activés pour cet élément.

Lorsque la propriété est définie sur « true », l'élément traite et gère les événements d'entrée tels que les événements clavier et souris ; lorsqu'elle est définie sur « false », les événements d'entrée sont ignorés.

origin : enum [read-only]

Cette propriété indique l'origine du tampon actuel de la surface, c'est-à-dire quel coin du tampon correspond à la coordonnée (0, 0).

Voir également WaylandSurface::origin.

output : WaylandOutput

Cette propriété contient le flux de sortie sur lequel cet élément s'affiche.

paintEnabled : bool [default: true]

Si vous définissez cette propriété sur « false », l'affichage de l'élément sera interrompu. Contrairement au masquage de l'élément obtenu en définissant la propriété « visible » sur « false », cela n'empêchera pas les entrées de la souris ou du clavier d'atteindre l'élément.

subsurfaceHandler : object

Cette propriété permet de redéfinir le comportement par défaut de la sous-surface.

Par défaut, Qt créera un nouvel élément SurfaceItem en tant qu’enfant de cet élément et conservera la position correcte.

Pour remplacer le comportement par défaut, attribuez un objet gestionnaire à cette propriété. Le gestionnaire doit implémenter une fonction handleSubsurfaceAdded(WaylandSurface).

ShellSurfaceItem {
    subsurfaceHandler: QtObject {
        function handleSubsurfaceAdded(child) {
          // create custom surface item, and connect the subsurfacePositionChanged signal
        }
    }
}

La valeur par défaut de cette propriété est null.

surface : WaylandSurface

Cette propriété contient la surface générée par cette fonction WaylandQuickItem.

touchEventsEnabled : bool

Cette propriété prend la valeur « true » si les événements tactiles sont transmis à la surface client, et « false » dans le cas contraire.

Documentation sur les signaux

void surfaceDestroyed()

Ce signal est émis lorsque le client a détruit l'wl_surface associé à l'WaylandQuickItem. Le gestionnaire de ce signal doit soit détruire immédiatement l'WaylandQuickItem, soit lancer une animation de fermeture, puis détruire l'Item.

Si une animation est lancée, bufferLocked doit être défini afin de garantir que l’élément conserve son contenu jusqu’à la fin de l’animation

Voir également bufferLocked.

Documentation de la méthode

point mapFromSurface(point point)

Mappe l'point e fournie dans le système de coordonnées des surfaces Wayland vers le point équivalent dans le système de coordonnées de cet élément, puis renvoie la coordonnée mappée.

point mapToSurface(point point)

Mappe l'point e donnée dans le système de coordonnées de cet élément vers le point équivalent dans le système de coordonnées de la surface Wayland, puis renvoie la coordonnée mappée.

void setPrimary()

Définit cette WaylandQuickItem comme vue principale de la surface.