En esta página

WaylandQuickItem QML Type

Proporciona un elemento Qt Quick que representa un WaylandView. Más...

Import Statement: import QtWayland.Compositor
In C++: QWaylandQuickItem
Inherited By:

ShellSurfaceItem

Propiedades

Señales

Métodos

Descripción detallada

Qt Quick-Los compositores basados en Wayland pueden utilizar este tipo para mostrar el contenido de un cliente en un dispositivo de salida. Pasa la entrada del usuario al cliente.

Documentación de propiedades

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.

compositor : WaylandCompositor [read-only]

Esta propiedad contiene el compositor para la superficie renderizada por este WaylandQuickItem.

focusOnClick : bool

Esta propiedad especifica si WaylandQuickItem debe tomar el foco cuando se pulsa o se toca.

El valor predeterminado es true.

inputEventsEnabled : bool

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

Cuando true, el elemento procesará y manejará eventos de entrada como eventos de teclado y ratón; cuando false, los eventos de entrada son ignorados.

origin : enum [read-only]

Esta propiedad mantiene el origen de la QWaylandQuickItem.

output : WaylandOutput

Esta propiedad contiene la salida en la que se muestra este elemento.

paintEnabled : bool

Devuelve true si el ítem está oculto, aunque la textura se sigue actualizando. A diferencia de ocultar el elemento estableciendo visible a false, establecer esta propiedad a false no impedirá que la entrada del ratón o del teclado llegue al elemento.

subsurfaceHandler : object

Esta propiedad proporciona una forma de anular el comportamiento por defecto de la subsuperficie.

Por defecto, Qt creará un nuevo SurfaceItem como hijo de este ítem, y mantendrá la posición correcta.

Para anular el comportamiento por defecto, asigne un objeto manejador a esta propiedad. El manejador debe implementar una función handleSubsurfaceAdded(WaylandSurface).

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

El valor por defecto de esta propiedad es null.

surface : WaylandSurface

Esta propiedad contiene la superficie renderizada por este WaylandQuickItem.

touchEventsEnabled : bool

Esta propiedad contiene true si los eventos táctiles se reenvían a la superficie del cliente, false en caso contrario.

Documentación sobre señales

void surfaceDestroyed()

Esta señal se emite cuando el cliente ha destruido el wl_surface asociado al WaylandQuickItem. Se espera que el manejador de esta señal destruya el WaylandQuickItem 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.

Nota: El manejador correspondiente es onSurfaceDestroyed.

Ver también bufferLocked.

Documentación del método

point mapFromSurface(point point)

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.

point mapToSurface(point point)

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.

void setPrimary()

Hace que esta WaylandQuickItem sea la vista principal de la superficie.

© 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.