En esta página

WaylandQuickItem QML Type

El tipo WaylandQuickItem proporciona un elemento « Qt Quick » que representa la superficie de un cliente Wayland. Más información...

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

ShellSurfaceItem

Propiedades

Señales

Métodos

Descripción detallada

Qt QuickLos compositores Wayland basados en `-based` pueden utilizar este tipo para mostrar el contenido de un cliente en un dispositivo de salida. Transmite la entrada del usuario al cliente.

Documentación de la propiedad

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 por defecto es «false».

compositor : WaylandCompositor [read-only]

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

focusOnClick : bool

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

El valor predeterminado es « true ».

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á los eventos de entrada, como los del teclado y el ratón; cuando se establece en « false », los eventos de entrada se ignoran.

origin : enum [read-only]

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

Véase también WaylandSurface::origin.

output : WaylandOutput

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

paintEnabled : bool [default: true]

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.

subsurfaceHandler : object

Esta propiedad permite anular el comportamiento predeterminado de la subsuperficie.

Por defecto, Qt creará un nuevo `SurfaceItem` como elemento secundario de este elemento y mantendrá la posición correcta.

Para anular el valor por defecto, asigna un objeto de controlador a esta propiedad. El controlador debe implementar la 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 generada por este WaylandQuickItem.

touchEventsEnabled : bool

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

Documentación de señales

void surfaceDestroyed()

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

Nota: El controlador correspondiente es onSurfaceDestroyed.

Véase también bufferLocked.

Documentación del método

point mapFromSurface(point point)

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

point mapToSurface(point point)

Asigna el « point » proporcionado 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.

void setPrimary()

Establece este WaylandQuickItem como 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.