XdgShell QML Type
Ofrece una extensión para interfaces de usuario de tipo escritorio. Más...
| Import Statement: | import QtWayland.Compositor.XdgShell |
| In C++: | QWaylandXdgShell |
Señales
- pong(int serial)
- popupCreated(XdgPopup popup, XdgSurface xdgSurface)
- toplevelCreated(XdgToplevel toplevel, XdgSurface xdgSurface)
- xdgSurfaceCreated(XdgSurface xdgSurface)
Métodos
- void ping(WaylandClient client)
Descripción detallada
La extensión XdgShell permite asociar una superficie de « XdgToplevel » o « XdgPopup » a una superficie Wayland normal. Mediante la interfaz XdgToplevel, el cliente puede solicitar que se cambie el tamaño de la superficie, se mueva, etc.
XdgShell se corresponde con la interfaz de Wayland xdg_shell.
Para proporcionar la funcionalidad de la extensión del shell en un compositor, crea una instancia del componente XdgShell y añádela a la lista de extensiones compatibles con el compositor:
import QtWayland.Compositor.XdgShell
WaylandCompositor {
XdgShell {
// ...
}
}Documentación de Signal
pong(int serial)
Esta señal se emite cuando el cliente ha respondido a un evento «ping» con el valor en serie « serial ».
Nota: El controlador correspondiente es onPong.
Véase también ping().
popupCreated(XdgPopup popup, XdgSurface xdgSurface)
Esta señal se emite cuando el cliente ha creado un ` xdg_popup`. Un caso de uso habitual es permitir que el controlador de esta señal instancie un ` ShellSurfaceItem ` o un ` WaylandQuickItem ` para mostrar ` popup ` en una escena ` QtQuick `.
xdgSurface es el XdgSurface para el que popup es el objeto de rol.
Nota: El controlador correspondiente es onPopupCreated.
toplevelCreated(XdgToplevel toplevel, XdgSurface xdgSurface)
Esta señal se emite cuando el cliente ha creado un ` xdg_toplevel`. Un caso de uso habitual es permitir que el controlador de esta señal instancie un ` ShellSurfaceItem ` o un ` WaylandQuickItem ` para mostrar un ` toplevel ` en una escena ` QtQuick `.
xdgSurface es el XdgSurface del que toplevel es el objeto de rol.
Nota: El controlador correspondiente es onToplevelCreated.
xdgSurfaceCreated(XdgSurface xdgSurface)
Esta señal se emite cuando el cliente ha creado un ` xdg_surface`. Ten en cuenta que ` xdgSurface ` no está mapeado; es decir, según el protocolo ` xdg-shell `, no debería mostrarse hasta que haya recibido un objeto de rol.
Nota: El controlador correspondiente es onXdgSurfaceCreated.
Véase también toplevelCreated() y popupCreated().
Documentación del método
void ping(WaylandClient client)
Envía un evento «ping» a client. Si el cliente responde al evento, se emitirá la señal « pong ».
© 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.