QWaylandQuickItem 类
QWaylandQuickItem 类提供了一个 Qt Quick 项目,代表一个 QWaylandView。 更多...
头文件 | #include <QWaylandQuickItem> |
CMake | find_package(Qt6 REQUIRED COMPONENTS WaylandCompositor) target_link_libraries(mytarget PRIVATE Qt6::WaylandCompositor) |
qmake | QT += waylandcompositor |
由 | WaylandQuickItem |
继承自 | QQuickItem |
由以下类继承 |
属性
|
|
公共函数
QWaylandQuickItem(QQuickItem *parent = nullptr) | |
virtual | ~QWaylandQuickItem() override |
bool | allowDiscardFrontBuffer() const |
QWaylandCompositor * | compositor() const |
bool | focusOnClick() const |
bool | inputEventsEnabled() const |
bool | inputRegionContains(const QPointF &localPosition) const |
bool | isBufferLocked() const |
bool | isPaintEnabled() const |
QPointF | mapFromSurface(const QPointF &point) const |
QPointF | mapToSurface(const QPointF &point) const |
QWaylandSurface::Origin | origin() const |
QWaylandOutput * | output() const |
void | setAllowDiscardFrontBuffer(bool discard) |
void | setBufferLocked(bool locked) |
void | setFocusOnClick(bool focus) |
void | setInputEventsEnabled(bool enabled) |
void | setOutput(QWaylandOutput *output) |
void | setPrimary() |
void | setSubsurfaceHandler(QObject *) |
void | setSurface(QWaylandSurface *surface) |
void | setTouchEventsEnabled(bool enabled) |
QObject * | subsurfaceHandler() const |
QWaylandSurface * | surface() const |
bool | touchEventsEnabled() const |
QWaylandView * | view() const |
重写的公共函数
虚函数 QSGTextureProvider * | textureProvider() const override |
公共槽
void | setPaintEnabled(bool paintEnabled) |
虚拟 void | takeFocus(QWaylandSeat *device = nullptr) |
信号
void | 允许丢弃前端缓冲区已更改() |
void | 缓冲区锁定已更改() |
void | 合成器已更改() |
void | 单击焦点已更改() |
void | 输入事件已启用已更改() |
void | 原点已更改() |
void | 输出已更改() |
void | 绘图已启用已更改() |
void | 子表面处理程序已更改() |
void | 表面已更改() |
void | 表面已销毁() |
void | 触摸事件启用已更改() |
详细描述
在 Qt Quick 中编写 QWaylandCompositor 时,此类可用于在输出设备上显示客户的 内容,并将用户输入传递给客户。
属性文档
allowDiscardFrontBuffer : bool
默认情况下,项目锁定当前缓冲区,直到有新的缓冲区可用并且调用 updatePaintNode()。将此属性设置为 true 以允许 Qt 在节流视图不再使用时立即释放缓冲区。这对于具有缓慢更新间隔的项目很有用。
访问函数
bool | allowDiscardFrontBuffer() const |
void | setAllowDiscardFrontBuffer(bool discard) |
通知信号
void | 允许丢弃前端缓冲区已更改() |
bufferLocked : bool
此属性表示项的缓冲区是否处于当前锁定状态。只要缓冲区被锁定,它就不会被释放和返回给客户端。
默认值为 false。
访问函数
bool | isBufferLocked() const |
void | setBufferLocked(bool locked) |
通知信号
void | 缓冲区锁定已更改() |
[只读]
compositor : QWaylandCompositor* const
此属性表示由此 QWaylandQuickItem 绘制的表面的合成器。
访问函数
QWaylandCompositor * | compositor() const |
通知信号
void | 合成器已更改() |
focusOnClick : bool
此属性指定当 QWaylandQuickItem 被单击或触摸时,是否应获取焦点。
默认值为 true
。
访问函数
bool | focusOnClick() const |
void | setFocusOnClick(bool focus) |
通知信号
void | 单击焦点已更改() |
[只读]
origin : const QWaylandSurface::Origin
该属性包含QWaylandQuickItem的来源。
访问函数
QWaylandSurface::Origin | origin() const |
通知信号
void | 原点已更改() |
output : QWaylandOutput*
该属性包含显示该项的输出。
访问函数
QWaylandOutput * | output() const |
void | setOutput(QWaylandOutput *output) |
通知信号
void | 输出已更改() |
paintEnabled : bool
如果该项被隐藏(尽管纹理仍然更新),则保持true
。与将visible
设置为false
来隐藏该项不同,将此属性设置为false
不会阻止鼠标或键盘输入到达该项。
访问函数
bool | isPaintEnabled() const |
void | setPaintEnabled(bool paintEnabled) |
通知信号
void | 绘图已启用已更改() |
surface : QWaylandSurface*
该属性包含由QWaylandQuickItem渲染的表面。
访问函数
QWaylandSurface * | surface() const |
void | setSurface(QWaylandSurface *surface) |
通知信号
void | 表面已更改() |
touchEventsEnabled : bool
如果将触摸事件转发到客户端表面,则此属性包含true
,否则为false
。
访问函数
bool | touchEventsEnabled() const |
void | setTouchEventsEnabled(bool enabled) |
通知信号
void | 触摸事件启用已更改() |
成员函数文档
QWaylandQuickItem::QWaylandQuickItem(QQuickItem *parent = nullptr)
使用给定的parent构造一个QWaylandQuickItem。
[override virtual noexcept]
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公司的商标。所有其他商标均为其所有者的财产。