【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 结构体一样使用。

相关推荐
码匠许师傅2 小时前
【C++ 面试真题】聊聊 C++ 的序列容器
java·c++·面试
C++ 老炮儿的技术栈3 小时前
Qt5.9.1 Windows 完整开发环境搭建流程
开发语言·c++·windows·qt·编辑器·代码化
键盘会跳舞3 小时前
C++:std::tuple 源码级深度拆解——变参模板、SFINAE与模板元编程核心技巧
开发语言·c++·sfinae·变参模板
bkspiderx4 小时前
从零开始:VS Code搭建C/C++开发环境全指南(Windows/macOS/Linux)
c语言·c++·windows·vs code·c/c++开发环境
东华万里4 小时前
第40篇C++核心基础与工程实践:从底层逻辑到避坑指南
开发语言·c++·面试·大学生专区
luj_17684 小时前
元设计的诱惑与现实
c语言·开发语言·c++·经验分享·算法
小星星闪亮登场4 小时前
ST表--倍增思想
开发语言·数据结构·c++·算法·思维
东华万里4 小时前
第40篇 C++核心基础与工程实践:从底层逻辑到避坑指南
开发语言·c++·大学生专区
AC赳赳老秦4 小时前
OpenClaw 多源采集公开行业数据:从原始信息到研究报告初稿的自动化实践
java·c语言·c++·python·php·deepseek·openclaw
玩三国杀玩的4 小时前
Pytorch-c++-CUDA
c++·pytorch·python·深度学习