WaylandSurface QML Type (Uncreatable)
Representa un área rectangular en un dispositivo de salida. Más...
| Import Statement: | import QtWayland.Compositor |
| In C++: | QWaylandSurface |
Nota: Se trata de un tipo no creable. No se puede instanciar en QML.
Propiedades
- bufferScale : size
- bufferSize : size
- client : WaylandClient
- contentOrientation : enum
- cursorSurface : bool
- destinationSize : size
- hasContent : bool
- inhibitsIdle : bool
- isOpaque : bool
(since 6.4) - origin : enum
- sourceGeometry : rect
- useTextureAlpha : bool
Señales
- childAdded(WaylandSurface child)
- void dragStarted(WaylandDrag drag)
- surfaceDestroyed()
Métodos
- void destroy()
- void initialize(WaylandCompositor compositor, WaylandClient client, int id, int version)
- bool isDestroyed()
Descripción detallada
Este tipo encapsula un área rectangular de píxeles que se muestra en un dispositivo de salida. Se corresponde con la interfaz wl_surface del protocolo Wayland.
Documentación de propiedades
bufferScale : size [read-only]
Esta propiedad contiene la escala del buffer de « WaylandSurface ». La escala del buffer permite al cliente proporcionar datos del buffer con mayor resolución para su uso en resultados 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 obtener el tamaño en coordenadas de superficie, utiliza en su lugar destinationSize.
Véase también « destinationSize » y « bufferScale ».
client : WaylandClient [read-only]
Esta propiedad almacena el cliente que utiliza este WaylandSurface.
contentOrientation : enum [read-only]
Esta propiedad indica la orientación del contenido de WaylandSurface.
Véase también WaylandOutput.transform.
cursorSurface : bool
Esta propiedad se cumple independientemente de si la superficie de cursor « 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 la superficie tiene actualmente un búfer asignado que no sea nulo.
Véase también WaylandSurface::bufferSize.
inhibitsIdle : bool [read-only]
Esta propiedad determina si esta superficie está pensada para impedir el comportamiento en modo de inactividad del compositor, como el apagado de la pantalla, el bloqueo y el salvapantallas.
Véase también IdleInhibitManagerV1.
isOpaque : bool [read-only, since 6.4]
Esta propiedad se mantiene independientemente de si la superficie es totalmente opaca, tal y como indica el cliente mediante la solicitud set_opaque_region.
Esta propiedad se introdujo en Qt 6.4.
origin : enum [read-only]
Esta propiedad contiene el origen del búfer de la « 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 búfer.
- WaylandSurface.OriginBottomLeft: el origen es la esquina inferior izquierda del búfer.
sourceGeometry : rect [read-only]
Esta propiedad describe la parte del búfer Wayland adjunto que debe dibujarse en la pantalla. Las coordenadas se miden desde la esquina del búfer y se escalan mediante bufferScale.
Véase también bufferScale, bufferSize y destinationSize.
useTextureAlpha : bool [default: true]
Esta propiedad especifica si la superficie debe utilizar el canal alfa de la textura para la mezcla.
Cuando se establece en « true », se utilizará el canal alfa de la superficie para la mezcla; cuando se establece en « false », la superficie se tratará como opaca.
Documentación de Signal
childAdded(WaylandSurface child)
Esta señal se emite cuando se ha añadido un wl_subsurface, child, a la superficie.
Nota: El controlador correspondiente es onChildAdded.
void dragStarted(WaylandDrag drag)
Esta señal se emite cuando un « drag » ha partido desde esta superficie.
Nota: El controlador 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 el objeto ` WaylandSurface ` con los valores ` compositor ` y ` client` proporcionados, así como con los valores ` id ` y ` version` proporcionados.
bool isDestroyed()
Devuelve ` true ` si el objeto ` 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.