【CXX-Qt】2 CXX-Qt #[cxx_qt::bridge] 宏指南

#[cxx_qt::bridge] 宏是用于在 Rust 中创建一个模块，该模块能够桥接 Rust 和 Qt（通过 C++）之间的交互。它允许你将 Rust 类型暴露给 Qt 作为 QObject、Q_SIGNAL、Q_PROPERTY 等，同时也能够将 Qt 的特性和类型绑定到 Rust 中，比如 QObject 和 Q_SIGNAL。下面是这个宏及其属性的详细解释：

一、extern “RustQt”

• 这部分用于将 Rust 的类型暴露给 Qt。通过这种方式，Rust 中的结构体、枚举等可以被 Qt 使用，仿佛它们是 Qt 自己的类一样。这包括将它们作为 QObject 的子类、定义信号和属性等。

二、extern “C++Qt”

这部分负责将 Qt 的特性和类型绑定到 Rust 中。这意味着你可以在 Rust 代码中直接使用 Qt 的类和接口，而无需直接编写 C++ 代码。

三、共享类型

• 共享类型是指那些在 Rust 和 Qt 之间共享的枚举或其他类型。通过 Q_ENUM、Q_ENUM_NS 等宏，这些类型可以在两个语言环境中保持一致。

四、属性

• 在使用 #[cxx_qt::bridge] 时，你可以通过属性来处理命名空间，或者为函数提供不同的名称。这对于解决名称冲突或为了符合特定命名约定非常有用。

五、Traits

• Traits 是 Rust 中与 CXX-Qt 的 QObject 相关的特性。它们提供了一组方法，这些方法可以被 Rust 类型实现，以便与 Qt 的对象系统更好地集成。

六、其它说明

1、#[cxx_qt::bridge] 宏属性中的选项

• namespace：这允许你指定一个命名空间，用于将生成的 C++ 代码封装在其中。这对于组织代码和避免命名冲突非常有用。

2、使用注意事项

• 要使用 #[cxx_qt::bridge] 宏，你需要确保在 build.rs 脚本中配置了 CxxQtBuilder。这样可以确保在构建过程中生成必要的桥接代码。
• 参考 CXX 的文档来了解如何描述语言边界的详细信息，这对于正确使用 #[cxx_qt::bridge] 宏至关重要。
  通过 #[cxx_qt::bridge] 宏，Rust 开发者可以更加便捷地在他们的项目中集成 Qt，利用 Qt 提供的丰富的 GUI 和其他功能，同时保持 Rust 的类型安全和性能优势。