En esta página

WaylandSurface QML Type

Representa un área rectangular en un dispositivo de salida. Más...

Import Statement: import QtWayland.Compositor
In C++: QWaylandSurface

Propiedades

Señales

Métodos

Descripción detallada

Este tipo encapsula un área rectangular de píxeles que se muestra en un dispositivo de salida. Corresponde a la interfaz wl_surface del protocolo Wayland.

Documentación de propiedades

bufferScale : size [read-only]

Esta propiedad contiene la escala del búfer de WaylandSurface. La escala del búfer permite a un cliente suministrar datos de búfer de mayor resolución para su uso en salidas de alta resolución.

bufferSize : size [read-only]

Esta propiedad contiene el tamaño del búfer actual de este WaylandSurface en píxeles, no en coordenadas de superficie.

Para el tamaño en coordenadas de superficie, utilice destinationSize en su lugar.

Véase también destinationSize y bufferScale.

client : WaylandClient [read-only]

Esta propiedad contiene el cliente que utiliza este WaylandSurface.

contentOrientation : enum [read-only]

Esta propiedad contiene la orientación del contenido de WaylandSurface.

Véase también WaylandOutput.transform.

cursorSurface : bool

Esta propiedad indica si WaylandSurface es una superficie de cursor.

destinationSize : size [read-only]

Esta propiedad contiene el tamaño de este WaylandSurface en coordenadas de superficie.

Véase también bufferScale y bufferSize.

hasContent : bool [read-only]

Esta propiedad indica si WaylandSurface tiene contenido.

inhibitsIdle : bool [read-only]

Esta propiedad mantiene si esta superficie está destinada a inhibir el comportamiento de inactividad del compositor, como el borrado de pantalla, el bloqueo y el guardado de pantalla.

Véase también IdleInhibitManagerV1.

isOpaque : bool [read-only, since 6.4]

Esta propiedad indica si la superficie es totalmente opaca, tal y como informa el cliente a través de la petición set_opaque_region.

Esta propiedad se introdujo en Qt 6.4.

origin : enum [read-only]

Esta propiedad contiene el origen del búfer de WaylandSurface, o WaylandSurface.OriginTopLeft si la superficie no tiene búfer.

Puede tener los siguientes valores:

  • WaylandSurface.OriginTopLeft El origen es la esquina superior izquierda del buffer.
  • WaylandSurface.OriginBottomLeft El origen es la esquina inferior izquierda del buffer.

sourceGeometry : rect [read-only]

Esta propiedad describe la porción del búfer Wayland adjunto que debe dibujarse en la pantalla. Las coordenadas son desde la esquina del buffer y son escaladas por bufferScale.

Véase también bufferScale, bufferSize, y destinationSize.

useTextureAlpha : bool

Esta propiedad especifica si la superficie debe utilizar la textura alfa.

Documentación de señales

childAdded(WaylandSurface child)

Esta señal se emite cuando se ha añadido una wl_subsuperficie, child, a la superficie.

Nota: El manejador correspondiente es onChildAdded.

void dragStarted(WaylandDrag drag)

Esta señal se emite cuando un drag se ha iniciado desde esta superficie.

Nota: El manejador correspondiente es onDragStarted.

surfaceDestroyed()

Esta señal se emite cuando se destruye la wl_surface correspondiente.

Nota: El manejador correspondiente es onSurfaceDestroyed.

Documentación del método

void destroy()

Destruye el WaylandSurface.

void initialize(WaylandCompositor compositor, WaylandClient client, int id, int version)

Inicializa WaylandSurface con los datos compositor y client, y con los datos id y version.

bool isDestroyed()

Devuelve true si el WaylandSurface ha sido destruido. En caso contrario devuelve false.

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