百度最新泛站群程序深圳画册制作

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