QWaylandQuickItem 类

QWaylandQuickItem 类提供了一个 Qt Quick 项目,代表一个 QWaylandView更多...

头文件 #include <QWaylandQuickItem>
CMakefind_package(Qt6 REQUIRED COMPONENTS WaylandCompositor)
target_link_libraries(mytarget PRIVATE Qt6::WaylandCompositor)
qmakeQT += waylandcompositor
WaylandQuickItem
继承自 QQuickItem
由以下类继承

QWaylandQuickShellSurfaceItem

属性

公共函数

QWaylandQuickItem(QQuickItem *parent = nullptr)
virtual~QWaylandQuickItem() override
boolallowDiscardFrontBuffer() const
QWaylandCompositor *compositor() const
boolfocusOnClick() const
boolinputEventsEnabled() const
boolinputRegionContains(const QPointF &localPosition) const
boolisBufferLocked() const
boolisPaintEnabled() const
QPointFmapFromSurface(const QPointF &point) const
QPointFmapToSurface(const QPointF &point) const
QWaylandSurface::Originorigin() const
QWaylandOutput *output() const
voidsetAllowDiscardFrontBuffer(bool discard)
voidsetBufferLocked(bool locked)
voidsetFocusOnClick(bool focus)
voidsetInputEventsEnabled(bool enabled)
voidsetOutput(QWaylandOutput *output)
voidsetPrimary()
voidsetSubsurfaceHandler(QObject *)
voidsetSurface(QWaylandSurface *surface)
voidsetTouchEventsEnabled(bool enabled)
QObject *subsurfaceHandler() const
QWaylandSurface *surface() const
booltouchEventsEnabled() const
QWaylandView *view() const

重写的公共函数

虚函数 QSGTextureProvider *textureProvider() const override

公共槽

voidsetPaintEnabled(bool paintEnabled)
虚拟 voidtakeFocus(QWaylandSeat *device = nullptr)

信号

详细描述

在 Qt Quick 中编写 QWaylandCompositor 时,此类可用于在输出设备上显示客户的 内容,并将用户输入传递给客户。

属性文档

allowDiscardFrontBuffer : bool

默认情况下,项目锁定当前缓冲区,直到有新的缓冲区可用并且调用 updatePaintNode()。将此属性设置为 true 以允许 Qt 在节流视图不再使用时立即释放缓冲区。这对于具有缓慢更新间隔的项目很有用。

访问函数

boolallowDiscardFrontBuffer() const
voidsetAllowDiscardFrontBuffer(bool discard)

通知信号

void允许丢弃前端缓冲区已更改()

bufferLocked : bool

此属性表示项的缓冲区是否处于当前锁定状态。只要缓冲区被锁定,它就不会被释放和返回给客户端。

默认值为 false。

访问函数

boolisBufferLocked() const
voidsetBufferLocked(bool locked)

通知信号

void缓冲区锁定已更改()

[只读] compositor : QWaylandCompositor* const

此属性表示由此 QWaylandQuickItem 绘制的表面的合成器。

访问函数

QWaylandCompositor *compositor() const

通知信号

void合成器已更改()

focusOnClick : bool

此属性指定当 QWaylandQuickItem 被单击或触摸时,是否应获取焦点。

默认值为 true

访问函数

boolfocusOnClick() const
voidsetFocusOnClick(bool focus)

通知信号

void单击焦点已更改()

[只读] origin : const QWaylandSurface::Origin

该属性包含QWaylandQuickItem的来源。

访问函数

QWaylandSurface::Originorigin() const

通知信号

void原点已更改()

output : QWaylandOutput*

该属性包含显示该项的输出。

访问函数

QWaylandOutput *output() const
voidsetOutput(QWaylandOutput *output)

通知信号

void输出已更改()

paintEnabled : bool

如果该项被隐藏(尽管纹理仍然更新),则保持true。与将visible设置为false来隐藏该项不同,将此属性设置为false不会阻止鼠标或键盘输入到达该项。

访问函数

boolisPaintEnabled() const
voidsetPaintEnabled(bool paintEnabled)

通知信号

void绘图已启用已更改()

surface : QWaylandSurface*

该属性包含由QWaylandQuickItem渲染的表面。

访问函数

QWaylandSurface *surface() const
voidsetSurface(QWaylandSurface *surface)

通知信号

void表面已更改()

touchEventsEnabled : bool

如果将触摸事件转发到客户端表面,则此属性包含true,否则为false

访问函数

booltouchEventsEnabled() const
voidsetTouchEventsEnabled(bool enabled)

通知信号

void触摸事件启用已更改()

成员函数文档

QWaylandQuickItem::QWaylandQuickItem(QQuickItem *parent = nullptr)

使用给定的parent构造一个QWaylandQuickItem。

[override virtual noexcept] QWaylandQuickItem::~QWaylandQuickItem()

销毁QWaylandQuickItem

bool QWaylandQuickItem::inputRegionContains(const QPointF &localPosition) const

如果该项表面的输入区域包含由localPosition给定的位置,则返回true

[invokable] QPointF QWaylandQuickItem::mapFromSurface(const QPointF &point) const

将给定的point在Wayland表面坐标系统中映射到该项坐标系统中的等效点,并返回映射后的坐标。

注意:该函数可以通过元对象系统从QML调用。请参阅Q_INVOKABLE

[invokable] QPointF QWaylandQuickItem::mapToSurface(const QPointF &point) const

将给定的point在项坐标系统中映射到Wayland表面坐标系统中的等效点,并返回映射后的坐标。

注意:该函数可以通过元对象系统从QML调用。请参阅Q_INVOKABLE

[invokable] void QWaylandQuickItem::setPrimary()

使此QWaylandQuickItem的视图成为表面的主视图。

注意:该函数可以通过元对象系统从QML调用。请参阅Q_INVOKABLE

另请参阅 QWaylandSurface::primaryView.

[信号] void QWaylandQuickItem::surfaceDestroyed()

当客户端销毁与QWaylandQuickItem关联的wl_surface时,会发出此信号。此信号的处理器应立即销毁QWaylandQuickItem,或启动关闭动画然后销毁该项。

如果启动了动画,应设置bufferLocked以确保该项内容在动画完成前保持不变

另请参阅 QWaylandQuickItem::bufferLocked.

[虚槽] void QWaylandQuickItem::takeFocus(QWaylandSeat *device = nullptr)

调用此函数使该项获取输入device的焦点。

[覆盖虚函数] QSGTextureProvider *QWaylandQuickItem::textureProvider() const

重实现了:QQuickItem::textureProvider() const.

返回此QWaylandQuickItem的纹理提供者。

QWaylandView *QWaylandQuickItem::view() const

返回此QWaylandQuickItem渲染的视图。

© 2024 Qt公司有限公司。本文件中包含的文档贡献的版权归其所有者所有。本文件提供的文档是根据自由软件基金会发布的GNU自由文档许可证版本1.3的条款许可的。Qt及其相关标志是芬兰和/或全世界Qt公司的商标。所有其他商标均为其所有者的财产。