QWaylandXdgShell Class
QWaylandXdgShell 类是一个用于桌面风格用户界面的扩展。更多内容...
| 头文件： | #include <QWaylandXdgShell> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS WaylandCompositor) target_link_libraries(mytarget PRIVATE Qt6::WaylandCompositor) |
| qmake： | QT += waylandcompositor |
| 在 QML 中： | XdgShell |
| 继承自： | QWaylandShellTemplate |
公共函数
| QWaylandXdgShell() | |
| QWaylandXdgShell(QWaylandCompositor *compositor) |
重新实现的公共函数
| virtual void | initialize() override |
公共插槽
| uint | ping(QWaylandClient *client) |
信号
| void | pong(uint serial) |
| void | popupCreated(QWaylandXdgPopup *popup, QWaylandXdgSurface *xdgSurface) |
| void | toplevelCreated(QWaylandXdgToplevel *toplevel, QWaylandXdgSurface *xdgSurface) |
| void | xdgSurfaceCreated(QWaylandXdgSurface *xdgSurface) |
静态公共成员
| const struct wl_interface * | interface() |
详细说明
QWaylandXdgShell 扩展提供了一种将QWaylandXdgToplevel 或QWaylandXdgPopup 与常规 Wayland 表面关联的方法。通过QWaylandXdgToplevel 接口，客户端可以请求调整该表面的大小、移动位置等操作。
QWaylandXdgShell 对应于 Wayland 接口xdg_shell 。
成员函数文档
[explicit] QWaylandXdgShell::QWaylandXdgShell()
创建一个 QWaylandXdgShell 对象。
[explicit] QWaylandXdgShell::QWaylandXdgShell(QWaylandCompositor *compositor)
根据提供的compositor ，创建一个QWaylandXdgShell对象。
[override virtual] void QWaylandXdgShell::initialize()
重写了：QWaylandCompositorExtension::initialize()。
初始化 Shell 扩展。
[static] const struct wl_interface *QWaylandXdgShell::interface()
返回QWaylandXdgShell 的Wayland接口。
[slot] uint QWaylandXdgShell::ping(QWaylandClient *client)
向client 发送一个ping事件。如果客户端对该事件作出响应，则会触发pong 信号。
[signal] void QWaylandXdgShell::pong(uint serial)
当客户端对 ping 事件以串行数据serial 进行响应时，会发出此信号。
另请参阅 QWaylandXdgShell::ping()。
[signal] void QWaylandXdgShell::popupCreated(QWaylandXdgPopup *popup, QWaylandXdgSurface *xdgSurface)
当客户端创建了xdg_popup 时，会发出此信号。一个常见的用例是让该信号的处理程序实例化一个QWaylandShellSurfaceItem或QWaylandQuickItem ，以便在QtQuick 场景中显示popup 。
xdgSurface 是popup 所对应的XdgSurface 。 是其角色对象。
[signal] void QWaylandXdgShell::toplevelCreated(QWaylandXdgToplevel *toplevel, QWaylandXdgSurface *xdgSurface)
当客户端创建了xdg_toplevel 时，会发出此信号。一个常见的用例是让该信号的处理程序实例化一个QWaylandShellSurfaceItem或QWaylandQuickItem ，以便在QtQuick 场景中显示toplevel 。
xdgSurface 是toplevel 所对应的XdgSurface 。 是该 的角色对象。
[signal] void QWaylandXdgShell::xdgSurfaceCreated(QWaylandXdgSurface *xdgSurface)
当客户端创建了xdg_surface 时，会发出此信号。请注意，xdgSurface 未被映射，即根据xdg-shell 协议，在收到角色对象之前，它不应被显示。
另请参阅 toplevelCreated() 和popupCreated()。
© 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.
