En esta página

QWaylandQuickItem Class

La clase `QWaylandQuickItem` proporciona un elemento « Qt Quick » que representa la superficie de un cliente Wayland. Más información...

Encabezado: #include <QWaylandQuickItem>
CMake: find_package(Qt6 REQUIRED COMPONENTS WaylandCompositor)
target_link_libraries(mytarget PRIVATE Qt6::WaylandCompositor)
qmake: QT += waylandcompositor
En QML: WaylandQuickItem
Heredado de: QQuickItem
Heredado por:

QWaylandQuickShellSurfaceItem

Propiedades

Funciones públicas

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

Funciones públicas reimplementadas

virtual QSGTextureProvider *textureProvider() const override

Ranuras públicas

void setPaintEnabled(bool paintEnabled)
virtual void takeFocus(QWaylandSeat *device = nullptr)

Señales

Descripción detallada

Al escribir un « QWaylandCompositor » en Qt Quick, esta clase se puede utilizar para mostrar el contenido de un cliente en un dispositivo de salida y transmitirá la entrada del usuario al cliente.

Documentación de propiedades

allowDiscardFrontBuffer : bool

Por defecto, el elemento bloquea el búfer actual hasta que haya un nuevo búfer disponible y se llame a ` updatePaintNode()`. Establece esta propiedad en «true» para permitir que Qt libere el búfer inmediatamente cuando la vista de limitación ya no lo esté utilizando. Esto resulta útil para elementos que tienen intervalos de actualización lentos.

Funciones de acceso:

bool allowDiscardFrontBuffer() const
void setAllowDiscardFrontBuffer(bool discard)

Señal del notificador:

void allowDiscardFrontBufferChanged()

bufferLocked : bool

Esta propiedad indica si el búfer del elemento está bloqueado en ese momento. Mientras el búfer esté bloqueado, no se liberará ni se devolverá al cliente.

El valor predeterminado es «false».

Funciones de acceso:

bool isBufferLocked() const
void setBufferLocked(bool locked)

Señal del notificador:

void bufferLockedChanged()

[read-only] compositor : QWaylandCompositor*

Esta propiedad contiene el compositor de la superficie renderizada por este ` QWaylandQuickItem`.

Funciones de acceso:

QWaylandCompositor *compositor() const

Señal del notificador:

void compositorChanged()

focusOnClick : bool

Esta propiedad especifica si el elemento « QWaylandQuickItem » debe recibir el foco al hacer clic o tocarlo.

El valor predeterminado es « true ».

Funciones de acceso:

bool focusOnClick() const
void setFocusOnClick(bool focus)

Señal de notificador:

void focusOnClickChanged()

inputEventsEnabled : bool

Esta propiedad indica si los eventos de entrada están habilitados para este elemento.

Cuando se establece en « true », el elemento procesará y gestionará eventos de entrada, como los del teclado y el ratón; cuando se establece en « false », los eventos de entrada se ignoran.

Funciones de acceso:

bool inputEventsEnabled() const
void setInputEventsEnabled(bool enabled)

Señal de notificación:

void inputEventsEnabledChanged()

[read-only] origin : QWaylandSurface::Origin

Esta propiedad indica el origen del búfer actual de la superficie, es decir, qué esquina del búfer se corresponde con la coordenada (0, 0).

Funciones de acceso:

QWaylandSurface::Origin origin() const

Señal de notificación:

void originChanged()

Véase también « QWaylandSurface::origin ».

output : QWaylandOutput*

Esta propiedad contiene el campo de salida en el que se muestra este elemento.

Funciones de acceso:

QWaylandOutput *output() const
void setOutput(QWaylandOutput *output)

Señal de notificación:

void outputChanged()

paintEnabled : bool

Si se establece esta propiedad en « false », se dejará de mostrar el elemento. A diferencia de lo que ocurre al ocultar el elemento estableciendo « visible » en « false », esto no impedirá que las entradas del ratón o del teclado lleguen al elemento.

Funciones de acceso:

bool isPaintEnabled() const
void setPaintEnabled(bool paintEnabled)

Señal de notificador:

void paintEnabledChanged()

subsurfaceHandler : QObject*

Esta propiedad permite anular el comportamiento predeterminado de la subsuperficie.

De forma predeterminada, Qt creará un nuevo objeto ` QWaylandQuickItem ` como elemento secundario de este elemento y mantendrá la posición correcta.

Para anular el comportamiento predeterminado, asigne un objeto controlador a esta propiedad. El controlador debe implementar un método ` handleSubsurfaceAdded(QWaylandSurface*) `.

El valor por defecto de esta propiedad es ` nullptr`.

Funciones de acceso:

QObject *subsurfaceHandler() const
void setSubsurfaceHandler(QObject *)

Señal del notificador:

void subsurfaceHandlerChanged()

surface : QWaylandSurface*

Esta propiedad contiene la superficie renderizada por este QWaylandQuickItem.

Funciones de acceso:

QWaylandSurface *surface() const
void setSurface(QWaylandSurface *surface)

Señal de notificación:

void surfaceChanged()

touchEventsEnabled : bool

Esta propiedad toma el valor « true » si los eventos táctiles se reenvían a la superficie del cliente; en caso contrario, toma el valor « false ».

Funciones de acceso:

bool touchEventsEnabled() const
void setTouchEventsEnabled(bool enabled)

Señal del notificador:

void touchEventsEnabledChanged()

Documentación de las funciones de miembro

QWaylandQuickItem::QWaylandQuickItem(QQuickItem *parent = nullptr)

Crea un objeto `QWaylandQuickItem` con el ` parent` especificado.

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

Destruye el « QWaylandQuickItem ».

bool QWaylandQuickItem::inputRegionContains(const QPointF &localPosition) const

Devuelve ` true ` si la región de entrada de la superficie de este elemento contiene la posición indicada por ` localPosition`.

[invokable] QPointF QWaylandQuickItem::mapFromSurface(const QPointF &point) const

Asigna el valor dado ` point ` del sistema de coordenadas de la superficie de Wayland al punto equivalente dentro del sistema de coordenadas de este elemento, y devuelve la coordenada asignada.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] QPointF QWaylandQuickItem::mapToSurface(const QPointF &point) const

Asigna el « point » dado en el sistema de coordenadas de este elemento al punto equivalente dentro del sistema de coordenadas de la superficie de Wayland, y devuelve la coordenada asignada.

Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] void QWaylandQuickItem::setPrimary()

Establece la vista de este QWaylandQuickItem como vista principal de la superficie.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

Véase también QWaylandSurface::primaryView.

[signal] void QWaylandQuickItem::surfaceDestroyed()

Esta señal se emite cuando el cliente ha destruido el objeto « wl_surface » asociado al « QWaylandQuickItem ». Se espera que el controlador de esta señal destruya el « QWaylandQuickItem » inmediatamente o que inicie una animación de cierre y, a continuación, destruya el «Item».

Si se inicia una animación, se debe establecer bufferLocked para garantizar que el elemento conserve su contenido hasta que finalice la animación

Véase también QWaylandQuickItem::bufferLocked.

[virtual slot] void QWaylandQuickItem::takeFocus(QWaylandSeat *device = nullptr)

Al llamar a esta función, el elemento pasa a tener el foco del campo de entrada device.

[override virtual] QSGTextureProvider *QWaylandQuickItem::textureProvider() const

Reimplementa: ` QQuickItem::textureProvider()` const.

Devuelve el proveedor de texturas de este ` QWaylandQuickItem`.

QWaylandView *QWaylandQuickItem::view() const

Devuelve la vista generada por este ` 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.