本页内容

QWaylandQuickShellSurfaceItem Class

QWaylandQuickShellSurfaceItem 类提供了一个Qt Quick 项,该项表示一个QWaylandShellSurface 。更多内容...

头文件: #include <QWaylandQuickShellSurfaceItem>
CMake: find_package(Qt6 REQUIRED COMPONENTS WaylandCompositor)
target_link_libraries(mytarget PRIVATE Qt6::WaylandCompositor)
qmake: QT += waylandcompositor
在 QML 中: ShellSurfaceItem
继承自: QWaylandQuickItem

属性

公共函数

QWaylandQuickShellSurfaceItem(QQuickItem *parent = nullptr)
bool autoCreatePopupItems()
QQuickItem *moveItem() const
void setAutoCreatePopupItems(bool enabled)
void setMoveItem(QQuickItem *moveItem)
void setShellSurface(QWaylandShellSurface *shellSurface)
void setStaysOnBottom(bool on)
void setStaysOnTop(bool on)
QWaylandShellSurface *shellSurface() const
bool staysOnBottom() const
bool staysOnTop() const

信号

详细说明

该类型用于在Qt Quick 场景中渲染xdg_shell 、ivi_application 、wl_shell 或qt_shell 表面。

另请参阅 QWaylandQuickItem 、QWaylandXdgSurface 、QWaylandIviSurface 和QWaylandWlShellSurface 。

属性文档

autoCreatePopupItems : bool

该属性控制是否应自动创建属于由该项管理的 shell 表面所包含的弹出窗口的 QWaylandQuickShellSurfaceItems。

访问函数:

bool autoCreatePopupItems()
void setAutoCreatePopupItems(bool enabled)

通知器信号:

void autoCreatePopupItemsChanged()

moveItem : QQuickItem*

该属性存储了此QWaylandQuickShellSurfaceItem 的移动项。当客户端请求移动、最大化或调整QWaylandShellSurface 大小时,将被移动的正是该项。在实现服务器端装饰时,此属性非常有用。

访问函数:

QQuickItem *moveItem() const
void setMoveItem(QQuickItem *moveItem)

通知器信号:

void moveItemChanged()

shellSurface : QWaylandShellSurface*

该属性存储由此QWaylandQuickShellSurfaceItem 渲染的QWaylandShellSurface 。根据所使用的 shell 协议不同,它可能是 QWaylandXdgSurfaceV5、QWaylandWlShellSurface 或QWaylandIviSurface 。

访问函数:

QWaylandShellSurface *shellSurface() const
void setShellSurface(QWaylandShellSurface *shellSurface)

通知器信号:

void shellSurfaceChanged()

staysOnBottom : bool

将此项目置于其他 Wayland 工作区之上

访问函数:

bool staysOnBottom() const
void setStaysOnBottom(bool on)

通知器信号:

void staysOnBottomChanged()

staysOnTop : bool

将此项目置于其他 Wayland 工作区之上

访问函数:

bool staysOnTop() const
void setStaysOnTop(bool on)

通知器信号:

void staysOnTopChanged()

成员函数文档

QWaylandQuickShellSurfaceItem::QWaylandQuickShellSurfaceItem(QQuickItem *parent = nullptr)

使用给定的parent 创建一个QWaylandQuickWlShellSurfaceItem。

© 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.