Descripción general de Compositor
La vista general de Compositor muestra cómo cambiar de cliente en una cuadrícula.
Introducción
La vista general de Compositor muestra cómo seleccionar y activar una aplicación desde una cuadrícula de clientes conectados actualmente.

Para una introducción a los principios básicos de la creación de un Qt Wayland Compositor con Qt, consulta el ejemplo «Minimal Qml».
Cuadrícula de aplicaciones
En este ejemplo, el compositor admite dos modos de funcionamiento diferentes:
- Un modo de pantalla completa, en el que una única ventana de aplicación ocupa toda la ventana del compositor y permite la interacción.
- Un modo de vista general, en el que todas las ventanas de las aplicaciones son visibles en una cuadrícula. Al hacer clic en una ventana de la cuadrícula, esta queda seleccionada. El compositor pasa al modo de pantalla completa, mostrando la ventana de la aplicación seleccionada.
Cuando un cliente se conecta al compositor y crea una superficie de nivel superior, dicha superficie se conectará a una extensión de shell. El ejemplo solo admite la extensión XdgShell, por lo que el cliente se conectará a esta.
XdgShell {
onToplevelCreated: (toplevel, xdgSurface) => {
toplevels.append({xdgSurface});
toplevel.sendFullscreen(Qt.size(win.pixelWidth, win.pixelHeight));
}
}Para cada superficie, indicamos al cliente que la configure en modo de pantalla completa. Además, las superficies se añaden a un ListModel para facilitar el acceso.
Este modelo lo utiliza una extensión « Repeater » para crear una « ShellSurfaceItems » dentro de una « Grid ». El componente « Grid » coloca los elementos en una cuadrícula.
Repeater {
model: toplevels
Item {
width: win.width
height: win.height
ShellSurfaceItem {
anchors.fill: parent
shellSurface: xdgSurface
onSurfaceDestroyed: toplevels.remove(index)
}
MouseArea {
enabled: grid.overview
anchors.fill: parent
onClicked: {
grid.selected = index;
grid.overview = false;
}
}
}
}Para cada uno de los elementos, creamos un MouseArea que cubre el elemento e intercepta todas las entradas del ratón y táctiles. Esto solo está activo cuando el compositor está en modo de vista general, y activa la aplicación en la que se ha hecho clic.
Cuando el compositor pasa al modo de pantalla completa, se utiliza el mismo componente « Grid », pero se escala y se traslada a una posición en la que la única celda seleccionada ocupa toda la ventana del compositor. La idea es «ampliar» la celda seleccionada, lo que permite al usuario interactuar con la aplicación que contiene.
transform: [
Scale {
xScale: grid.overview ? (1.0/grid.columns) : 1
yScale: grid.overview ? (1.0/grid.columns) : 1
Behavior on xScale { PropertyAnimation { easing.type: Easing.InOutQuad; duration: 200 } }
Behavior on yScale { PropertyAnimation { easing.type: Easing.InOutQuad; duration: 200 } }
},
Translate {
x: grid.overview ? 0 : win.width * -grid.selectedColumn
y: grid.overview ? 0 : win.height * -grid.selectedRow
Behavior on x { PropertyAnimation { easing.type: Easing.InOutQuad; duration: 200 } }
Behavior on y { PropertyAnimation { easing.type: Easing.InOutQuad; duration: 200 } }
}
]En la parte inferior de la ventana hay un botón que permite alternar entre los modos. Se puede utilizar para recuperar la cuadrícula de aplicaciones mientras el compositor está en modo de pantalla completa.
Este ejemplo muestra una forma de hacer que el compositor visualice los clientes en diferentes modos. Otra forma de conseguir efectos similares es crear varios elementos « Qt Quick » que hagan referencia a la misma superficie. Consulta el ejemplo «Multi Output» para ver una demostración.
© 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.