QWaylandXdgShell Class
QWaylandXdgShell 类是桌面风格用户界面的扩展。更多
| Header： | #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 是 的角色对象。XdgSurface popup
[signal] void QWaylandXdgShell::toplevelCreated(QWaylandXdgToplevel *toplevel, QWaylandXdgSurface *xdgSurface)
该信号在客户端创建了xdg_toplevel 时发出。常见的使用情况是让该信号的处理程序实例化 QWaylandShellSurfaceItem 或QWaylandQuickItem ，以便在QtQuick 场景中显示toplevel 。
xdgSurface 是 的角色对象。XdgSurface toplevel
[signal] void QWaylandXdgShell::xdgSurfaceCreated(QWaylandXdgSurface *xdgSurface)
该信号在客户端创建了xdg_surface 时发出。请注意，xdgSurface 在收到角色对象之前不会被映射，也就是说，根据xdg-shell 协议，它不应该被显示。
另请参阅 toplevelCreated() 和popupCreated()。
© 2025 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.
