WaylandQuickItem QML Type
Proporciona un elemento Qt Quick que representa un WaylandView. Más...
| Import Statement: | import QtWayland.Compositor |
| In C++: | QWaylandQuickItem |
| Inherited By: |
Propiedades
- bufferLocked : bool
- compositor : WaylandCompositor
- focusOnClick : bool
- inputEventsEnabled : bool
- origin : enum
- output : WaylandOutput
- paintEnabled : bool
- subsurfaceHandler : object
- surface : WaylandSurface
- touchEventsEnabled : bool
Señales
- void surfaceDestroyed()
Métodos
- point mapFromSurface(point point)
- point mapToSurface(point point)
- void setPrimary()
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.