【CXX-Qt】2.3 类型

CXX-Qt 支持大多数 CXX 支持的类型。这些类型可以用于属性、可调用方法和信号中。

cxx-qt-lib 类型

cxx-qt-lib crate 提供了常见 Qt 类型的 CXX 绑定。

使用 cxx-qt-lib 文档 来探索可用的类型。

容器类型

cxx-qt-lib crate 提供了容器类型,例如 QSet。

要使用这些类型,请在 CXX 桥接中定义一个模板化类型,但请注意,类型名称必须为 QSet_T,因为这需要与 C++ 代码中的名称匹配。

例如,对于 QSet,类型名称应为 QSet_i32。

rust 复制代码
unsafe extern "C++" {
    include!("cxx-qt-lib/qset.h");
    type QSet_i32 = cxx_qt_lib::QSet<i32>;
}

对于基于键值的容器类型(如 QHash<K, V>),需要在 Rust 端定义一个中间类型,以便为键值组合实现 trait。

与其他容器类型一样,类型名称必须为 QHash_K_V,因为这需要与 C++ 代码中的名称匹配。

例如,对于 QHash<QString, QVariant>,定义一个名为 QHashPair_QString_QVariant 的中间类型。然后使用类型名称 QHash_QString_QVariant 来匹配 C++ 端。

rust 复制代码
unsafe extern "C++" {
    include!("cxx-qt-lib/qhash.h");
    type QHash_QString_QVariant = cxx_qt_lib::QHash<cxx_qt_lib::QHashPair_QString_QVariant>;
}

请注意,可以通过在 Rust 中使用匹配的类型(例如 QMap<QString, QVariant>)来使用类型别名(如 QVariantMap)。

定义自定义类型

任何有效的 CXX 类型都应该可以与 CXX-Qt 一起使用。

请注意,适用与 CXX 相同的规则,因此类型必须是可平凡传递的。如果它们是不透明类型,则必须使用引用或指针。

有关如何包装 Qt 对象的示例,请参阅 cxx-qt-lib 源代码。

在容器或 QVariant 中使用自定义类型

要在容器中使用自定义类型,请找到容器使用的 trait。例如,对于 QSet,有一个 QSetElement trait;对于 QHash<K, V>,有一个 QHashPair trait。

为你的自定义类型实现相应的 trait,然后就可以像上面描述的那样使用容器。

要在 QVariant 中使用自定义类型,请为你的自定义类型实现 QVariantValue trait,如下所示,然后就可以正常使用了。

rust 复制代码
impl cxx_qt_lib::QVariantValue for ffi::CustomStruct {
    fn can_convert(variant: &cxx_qt_lib::QVariant) -> bool {
        ffi::qvariant_can_convert_custom_type(variant)
    }

    fn construct(value: &Self) -> cxx_qt_lib::QVariant {
        ffi::qvariant_construct_custom_type(value)
    }

    fn value_or_default(variant: &cxx_qt_lib::QVariant) -> Self {
        ffi::qvariant_value_or_default_custom_type(variant)
    }
}

在 qml_features 类型示例 中展示了如何使用 QVariant 实现自定义结构体的完整示例。

此外,任何 C++ 中的自定义类型或别名都应使用 qRegisterMetaType("TYPE") 在 Qt 中注册,以确保它们可以与 QML 一起使用。

相关推荐
ShineWinsu7 分钟前
对于Qt:QMessageBox的解析
开发语言·c++·qt·面试·客户端·qmessagebox·消息对话框
小灰灰搞电子3 小时前
C++ initializer_list 详解
c++·list
Rabitebla5 小时前
【Linux】文件篇(六):Shell 实战——从系统调用到命令行重定向
linux·服务器·c++·笔记·学习
无忧.芙桃20 小时前
C++语言原理与实践(二十三):哈希表的实现
c++·链表·哈希算法·散列表·哈希表
xjz184221 小时前
Rust 用 `&&`、`||`、`!` 把条件组合起来
rust
AvocadoZeroOneOI1 天前
B4500 [GESP202603 三级] 凯撒密码 详细解题报告
c++·算法
宏笋1 天前
Qt开发了一款绘图和制作信笺的软件
qt
whitelbwwww1 天前
cuBLAS--CUDA高性能线性代数计算库--第一部分
c++·线性代数·gpu算力·cuda c++
不积跬步无以至千里mmbb261 天前
Rust三大核心:Trait Crate Mod详解
linux·rust
半杯咖啡半行码1 天前
Qt 隐式共享(Implicit Sharing)深度解析:机制、陷阱与 Qt6迁移
开发语言·数据库·qt