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公司的商标。所有其他商标均为其所有者的财产。