QWaylandQuickItem Class
La classe QWaylandQuickItem fournit un élément Qt Quick représentant un QWaylandView. Plus....
| En-tête : | #include <QWaylandQuickItem> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS WaylandCompositor)target_link_libraries(mytarget PRIVATE Qt6::WaylandCompositor) |
| qmake : | QT += waylandcompositor |
| En QML : | WaylandQuickItem |
| Hérite : | QQuickItem |
| Hérité par : |
Propriétés
|
|
Fonctions publiques
| QWaylandQuickItem(QQuickItem *parent = nullptr) | |
| virtual | ~QWaylandQuickItem() override |
| bool | allowDiscardFrontBuffer() const |
| QWaylandCompositor * | compositor() const |
| bool | focusOnClick() const |
| bool | inputEventsEnabled() const |
| bool | inputRegionContains(const QPointF &localPosition) const |
| bool | isBufferLocked() const |
| bool | isPaintEnabled() const |
| QPointF | mapFromSurface(const QPointF &point) const |
| QPointF | mapToSurface(const QPointF &point) const |
| QWaylandSurface::Origin | origin() const |
| QWaylandOutput * | output() const |
| void | setAllowDiscardFrontBuffer(bool discard) |
| void | setBufferLocked(bool locked) |
| void | setFocusOnClick(bool focus) |
| void | setInputEventsEnabled(bool enabled) |
| void | setOutput(QWaylandOutput *output) |
| void | setPrimary() |
| void | setSubsurfaceHandler(QObject *) |
| void | setSurface(QWaylandSurface *surface) |
| void | setTouchEventsEnabled(bool enabled) |
| QObject * | subsurfaceHandler() const |
| QWaylandSurface * | surface() const |
| bool | touchEventsEnabled() const |
| QWaylandView * | view() const |
Fonctions publiques réimplémentées
| virtual QSGTextureProvider * | textureProvider() const override |
Emplacements publics
| void | setPaintEnabled(bool paintEnabled) |
| virtual void | takeFocus(QWaylandSeat *device = nullptr) |
Signaux
| void | allowDiscardFrontBufferChanged() |
| void | bufferLockedChanged() |
| void | compositorChanged() |
| void | focusOnClickChanged() |
| void | inputEventsEnabledChanged() |
| void | originChanged() |
| void | outputChanged() |
| void | paintEnabledChanged() |
| void | subsurfaceHandlerChanged() |
| void | surfaceChanged() |
| void | surfaceDestroyed() |
| void | touchEventsEnabledChanged() |
Description détaillée
Lors de l'écriture d'un site QWaylandCompositor dans Qt Quick, cette classe peut être utilisée pour afficher le contenu d'un client sur un périphérique de sortie et transmettra les données de l'utilisateur au client.
Documentation sur les propriétés
allowDiscardFrontBuffer : bool
Par défaut, l'élément verrouille le tampon actuel jusqu'à ce qu'un nouveau tampon soit disponible et que updatePaintNode() soit appelé. Définissez cette propriété à true pour permettre à Qt de libérer le tampon immédiatement lorsque la vue d'étranglement ne l'utilise plus. Ceci est utile pour les éléments dont les intervalles de mise à jour sont lents.
Fonctions d'accès :
| bool | allowDiscardFrontBuffer() const |
| void | setAllowDiscardFrontBuffer(bool discard) |
Signal Notifier :
| void | allowDiscardFrontBufferChanged() |
bufferLocked : bool
Cette propriété indique si la mémoire tampon de l'élément est actuellement verrouillée. Tant que la mémoire tampon est verrouillée, elle ne sera pas libérée et renvoyée au client.
La valeur par défaut est false.
Fonctions d'accès :
| bool | isBufferLocked() const |
| void | setBufferLocked(bool locked) |
Signal du notificateur :
| void | bufferLockedChanged() |
[read-only] compositor : QWaylandCompositor*
Cette propriété contient le compositeur de la surface rendue par cette QWaylandQuickItem.
Fonctions d'accès :
| QWaylandCompositor * | compositor() const |
Signal de notification :
| void | compositorChanged() |
focusOnClick : bool
Cette propriété indique si le site QWaylandQuickItem doit être mis en évidence lorsqu'on clique dessus ou qu'on le touche.
La valeur par défaut est true.
Fonctions d'accès :
| bool | focusOnClick() const |
| void | setFocusOnClick(bool focus) |
Signal du notificateur :
| void | focusOnClickChanged() |
inputEventsEnabled : bool
Cette propriété indique si les événements d'entrée sont activés pour cet élément.
Si elle est définie sur true, l'élément traitera et gérera les événements d'entrée tels que les événements du clavier et de la souris ; si elle est définie sur false, les événements d'entrée sont ignorés.
Fonctions d'accès :
| bool | inputEventsEnabled() const |
| void | setInputEventsEnabled(bool enabled) |
Signal du notificateur :
| void | inputEventsEnabledChanged() |
[read-only] origin : QWaylandSurface::Origin
Cette propriété contient l'origine du site QWaylandQuickItem.
Fonctions d'accès :
| QWaylandSurface::Origin | origin() const |
Signal de notification :
| void | originChanged() |
output : QWaylandOutput*
Cette propriété contient la sortie sur laquelle cet élément est affiché.
Fonctions d'accès :
| QWaylandOutput * | output() const |
| void | setOutput(QWaylandOutput *output) |
Signal de notification :
| void | outputChanged() |
paintEnabled : bool
Tient true si l'élément est caché, bien que la texture soit toujours mise à jour. Contrairement à ce qui se passe lorsque l'élément est caché en réglant visible sur false, le fait de régler cette propriété sur false n'empêchera pas la souris ou la saisie au clavier d'atteindre l'élément.
Fonctions d'accès :
| bool | isPaintEnabled() const |
| void | setPaintEnabled(bool paintEnabled) |
Signal de notification :
| void | paintEnabledChanged() |
subsurfaceHandler : QObject*
Cette propriété permet de remplacer le comportement par défaut de la sous-surface.
Par défaut, Qt crée un nouveau QWaylandQuickItem en tant qu'enfant de cet élément et maintient la position correcte.
Pour remplacer le comportement par défaut, affectez un objet de gestion à cette propriété. Le gestionnaire doit implémenter une méthode handleSubsurfaceAdded(QWaylandSurface*).
La valeur par défaut de cette propriété est nullptr.
Fonctions d'accès :
| QObject * | subsurfaceHandler() const |
| void | setSubsurfaceHandler(QObject *) |
Signal du notificateur :
| void | subsurfaceHandlerChanged() |
surface : QWaylandSurface*
Cette propriété contient la surface rendue par cette QWaylandQuickItem.
Fonctions d'accès :
| QWaylandSurface * | surface() const |
| void | setSurface(QWaylandSurface *surface) |
Signal de notification :
| void | surfaceChanged() |
touchEventsEnabled : bool
Cette propriété vaut true si les événements tactiles sont transmis à la surface du client, false dans le cas contraire.
Fonctions d'accès :
| bool | touchEventsEnabled() const |
| void | setTouchEventsEnabled(bool enabled) |
Notifier signal :
| void | touchEventsEnabledChanged() |
Member Function Documentation
QWaylandQuickItem::QWaylandQuickItem(QQuickItem *parent = nullptr)
Construit un QWaylandQuickItem avec l'adresse parent.
[override virtual noexcept] QWaylandQuickItem::~QWaylandQuickItem()
Détruire le site QWaylandQuickItem.
bool QWaylandQuickItem::inputRegionContains(const QPointF &localPosition) const
Renvoie true si la région d'entrée de la surface de cet élément contient la position donnée par localPosition.
[invokable] QPointF QWaylandQuickItem::mapFromSurface(const QPointF &point) const
Met en correspondance le point donné point dans le système de coordonnées des surfaces Wayland avec le point équivalent dans le système de coordonnées de cet élément, et renvoie la coordonnée mise en correspondance.
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] QPointF QWaylandQuickItem::mapToSurface(const QPointF &point) const
Met en correspondance le point point dans le système de coordonnées de cet élément avec le point équivalent dans le système de coordonnées de la surface Wayland, et renvoie la coordonnée mise en correspondance.
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] void QWaylandQuickItem::setPrimary()
Fait de la vue de ce site QWaylandQuickItem la vue principale de la surface.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
Voir également QWaylandSurface::primaryView.
[signal] void QWaylandQuickItem::surfaceDestroyed()
Ce signal est émis lorsque le client a détruit l'élément wl_surface associé à l'élément QWaylandQuickItem. Le gestionnaire de ce signal est censé soit détruire l'élément QWaylandQuickItem immédiatement, soit lancer une animation de fermeture, puis détruire l'élément.
Si une animation est lancée, bufferLocked doit être défini pour garantir que l'élément conserve son contenu jusqu'à la fin de l'animation.
Voir également QWaylandQuickItem::bufferLocked.
[virtual slot] void QWaylandQuickItem::takeFocus(QWaylandSeat *device = nullptr)
L'appel de cette fonction permet à l'élément de prendre le focus de l'entrée device.
[override virtual] QSGTextureProvider *QWaylandQuickItem::textureProvider() const
Réimplémente : QQuickItem::textureProvider() const.
Renvoie le fournisseur de texture de cette QWaylandQuickItem.
QWaylandView *QWaylandQuickItem::view() const
Retourne la vue rendue par cette QWaylandQuickItem.
© 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.
