【CXX-Qt】2.2 生成的 QObject

CXX-Qt 的一个关键特性是能够从 Rust 创建你自己的 QObject。这就是 #[qobject] 宏的用途。本篇旨在记录生成的 QObject 的详细信息以及如何从 Rust 与生成的 QObject 进行交互。

#[qobject] 宏为 Rust 结构体的类型别名生成一个 QObject。虽然这个 QObject 是一个 C++ 类型,但 CXX-Qt 会自动将其包装为 CXX 不透明类型。

复制代码
如果桥接模块命名为 qobject,则可以通过 qobject::T 访问 C++ 类型。

结构解析

任何由 CXX-Qt 生成的 QObject 都只是一个 C++ QObject 子类,它拥有一个 Rust 结构体的实例。

默认情况下,Rust 结构体的实例是使用 Default trait 构造的。如果 Rust 结构体无法实现 Default,则需要使用 Constructor trait 提供自定义构造函数。

C++ 对象会将任何状态委托给 Rust 结构体,因此它只是一个薄包装。

复制代码
📝 注意:QObject 内部的 Rust 结构体由该 QObject 拥有。因此,当 C++ 对象被销毁时,内部的 Rust 结构体也会被丢弃。

有关实现属性、可调用方法和信号的详细信息,请参阅 extern "RustQt"。

有关引用另一个 QObject 的信息,请参阅嵌套对象。

C++ 上下文

在 C++ 上下文中实现方法时(例如,对于可调用方法),这些方法需要在桥接模块中定义的类型上实现。

例如,如果桥接模块名为 qobject,类型名为 T,则实现块应写为 impl qobject::T { ... }。

复制代码
来自 trait 的方法(例如 Threading)在 C++ 上下文中可用。

在 C++ 上下文中,可以通过使用 CxxQtType trait 上的方法访问 Rust 上下文。

Rust 上下文

Rust 结构体的唯一要求是它必须具有 Default 实现,或者 QObject 实现了 cxx_qt::Constructor。

除此之外,Rust 结构体可以像任何普通的 Rust 结构体一样使用。

相关推荐
lqjun08277 小时前
Qt程序单独运行报错问题
开发语言·qt
ftpeak7 小时前
从零开始使用 axum-server 构建 HTTP/HTTPS 服务
网络·http·https·rust·web·web app
咸甜适中8 小时前
rust语言 (1.88) 学习笔记:客户端和服务器端同在一个项目中
笔记·学习·rust
风中的微尘9 小时前
39.网络流入门
开发语言·网络·c++·算法
混分巨兽龙某某10 小时前
基于Qt Creator的Serial Port串口调试助手项目(代码开源)
c++·qt creator·串口助手·serial port
小冯记录编程10 小时前
C++指针陷阱:高效背后的致命危险
开发语言·c++·visual studio
C_Liu_11 小时前
C++:类和对象(下)
开发语言·c++
coderxiaohan11 小时前
【C++】类和对象1
java·开发语言·c++
阿昭L11 小时前
MFC仿真
c++·mfc
咸甜适中12 小时前
rust语言 (1.88) egui (0.32.2) 学习笔记(逐行注释)(二十八)使用图片控件显示图片
笔记·学习·rust·egui