QWaylandQuickItem Class
La clase QWaylandQuickItem proporciona un elemento Qt Quick que representa un QWaylandView. Más...
| Cabecera: | #include <QWaylandQuickItem> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS WaylandCompositor)target_link_libraries(mytarget PRIVATE Qt6::WaylandCompositor) |
| qmake: | QT += waylandcompositor |
| En QML: | WaylandQuickItem |
| Hereda 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 pasará 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(). Establezca esta propiedad a true para permitir que Qt libere el búfer inmediatamente cuando la vista de aceleración ya no lo utilice. Esto es útil para elementos que tienen intervalos de actualización lentos.
Funciones de acceso:
| bool | allowDiscardFrontBuffer() const |
| void | setAllowDiscardFrontBuffer(bool discard) |
Señal de notificador:
| void | allowDiscardFrontBufferChanged() |
bufferLocked : bool
Esta propiedad indica si el búfer del elemento está bloqueado. Mientras el buffer esté bloqueado, no será liberado y devuelto al cliente.
Por defecto es false.
Funciones de acceso:
| bool | isBufferLocked() const |
| void | setBufferLocked(bool locked) |
Señal de notificador:
| void | bufferLockedChanged() |
[read-only] compositor : QWaylandCompositor*
Esta propiedad contiene el compositor para la superficie renderizada por este QWaylandQuickItem.
Funciones de acceso:
| QWaylandCompositor * | compositor() const |
Señal del notificador:
| void | compositorChanged() |
focusOnClick : bool
Esta propiedad especifica si QWaylandQuickItem debe tomar el foco cuando se pulsa o se toca.
Por defecto es true.
Funciones de acceso:
| bool | focusOnClick() const |
| void | setFocusOnClick(bool focus) |
Señal del notificador:
| void | focusOnClickChanged() |
inputEventsEnabled : bool
Esta propiedad indica si los eventos de entrada están habilitados para este elemento.
Cuando true, el ítem procesará y manejará eventos de entrada tales como eventos de teclado y ratón; cuando false, los eventos de entrada son ignorados.
Funciones de acceso:
| bool | inputEventsEnabled() const |
| void | setInputEventsEnabled(bool enabled) |
Señal del notificador:
| void | inputEventsEnabledChanged() |
[read-only] origin : QWaylandSurface::Origin
Esta propiedad mantiene el origen de la QWaylandQuickItem.
Funciones de acceso:
| QWaylandSurface::Origin | origin() const |
Señal del notificador:
| void | originChanged() |
output : QWaylandOutput*
Esta propiedad contiene la salida en la que se muestra este elemento.
Funciones de acceso:
| QWaylandOutput * | output() const |
| void | setOutput(QWaylandOutput *output) |
Señal del notificador:
| void | outputChanged() |
paintEnabled : bool
Mantiene true si el ítem está oculto, aunque la textura sigue siendo actualizada. A diferencia de ocultar el ítem estableciendo visible a false, establecer esta propiedad a false no impedirá que la entrada del ratón o del teclado llegue al ítem.
Funciones de acceso:
| bool | isPaintEnabled() const |
| void | setPaintEnabled(bool paintEnabled) |
Señal del notificador:
| void | paintEnabledChanged() |
subsurfaceHandler : QObject*
Esta propiedad proporciona una forma de anular el comportamiento predeterminado de la subsuperficie.
Por defecto, Qt creará un nuevo QWaylandQuickItem como hijo de este elemento y mantendrá la posición correcta.
Para anular el comportamiento por defecto, asigne un objeto manejador a esta propiedad. El manejador 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 del notificador:
| void | surfaceChanged() |
touchEventsEnabled : bool
Esta propiedad contiene true si los eventos táctiles se reenvían a la superficie del cliente, false en caso contrario.
Funciones de acceso:
| bool | touchEventsEnabled() const |
| void | setTouchEventsEnabled(bool enabled) |
Señal del notificador:
| void | touchEventsEnabledChanged() |
Documentación de la función miembro
QWaylandQuickItem::QWaylandQuickItem(QQuickItem *parent = nullptr)
Construye un QWaylandQuickItem con la dirección parent.
[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 dada por localPosition.
[invokable] QPointF QWaylandQuickItem::mapFromSurface(const QPointF &point) const
Mapea el point dado en el sistema de coordenadas de las superficies Wayland al punto equivalente dentro del sistema de coordenadas de este elemento, y devuelve la coordenada mapeada.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] QPointF QWaylandQuickItem::mapToSurface(const QPointF &point) const
Mapea el point dado en el sistema de coordenadas de este elemento al punto equivalente dentro del sistema de coordenadas de la superficie Wayland, y devuelve la coordenada mapeada.
Nota: Esta función puede invocarse a través del sistema de meta-objetos y desde QML. Véase Q_INVOKABLE.
[invokable] void QWaylandQuickItem::setPrimary()
Hace que la vista de este QWaylandQuickItem sea la vista principal de la superficie.
Nota: Esta función puede invocarse 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 wl_surface asociado al QWaylandQuickItem. Se espera que el manejador de esta señal destruya el QWaylandQuickItem inmediatamente o inicie una animación de cierre y luego destruya el Item.
Si se inicia una animación, debe establecerse bufferLocked para garantizar que el elemento mantenga su contenido hasta que finalice la animación.
Véase también QWaylandQuickItem::bufferLocked.
[virtual slot] void QWaylandQuickItem::takeFocus(QWaylandSeat *device = nullptr)
La llamada a esta función hace que el elemento tome el foco de la entrada device.
[override virtual] QSGTextureProvider *QWaylandQuickItem::textureProvider() const
Reimplementa: QQuickItem::textureProvider() const.
Devuelve el proveedor de textura de este QWaylandQuickItem.
QWaylandView *QWaylandQuickItem::view() const
Devuelve la vista renderizada 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.
