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: |
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
| void | allowDiscardFrontBufferChanged() |
| void | bufferLockedChanged() |
| void | compositorChanged() |
| void | focusOnClickChanged() |
| void | inputEventsEnabledChanged() |
| void | originChanged() |
| void | outputChanged() |
| void | paintEnabledChanged() |
| void | subsurfaceHandlerChanged() |
| void | surfaceChanged() |
| void | surfaceDestroyed() |
| void | touchEventsEnabledChanged() |
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.