【QT Quick】C++交互：QML对象操作

本节课程将详细讲解如何通过 C++ 代码访问并操作 QML 对象。通常来说，我们的需求是访问 QML 的属性和信号，而避免直接修改 QML，因为这样做会改变业务逻辑。

查找 QML 对象

在 Qt Quick 中，我们可以通过 C++ 代码与 QML 对象进行交互，访问它们的属性和调用它们的方法。为了实现这种交互，我们需要先通过 QML 的上下文对象找到我们要操作的 QML 对象。然后，使用 QObject 提供的接口来遍历节点或操作对象的属性。

1. 首先获取 QML 的根节点。
2. 使用 findChild<T>() 方法查找特定子节点。

QObject* rootObject = engine.rootObjects().first(); // 获取 QML 根对象
QObject* textObject = rootObject->findChild<QObject*>("myTXT"); // 查找 ID 为 myTXT 的节点

if (textObject) {
    qDebug() << "找到对象：" << textObject->objectName();
} else {
    qDebug() << "未找到指定的对象。";
}

在 QML 中，通过设置对象的 objectName 属性来指定节点的名称，例如：

Text {
    id: myTXT
    objectName: "myTXT"
    text: "Hello, Qt Quick!"
}

遍历所有子节点

遍历 QML 中的所有子节点通常用于查看整个 QML 树结构，或者需要对所有组件进行统一处理。

为了遍历整个 QML 树结构，我们可以使用 QObject 类的 children() 方法获取对象的所有子节点，然后递归地访问每一个子节点，直到遍历完整个树结构。

下面是一个遍历 QML 对象树的代码示例：

void PrintQmlObj(QObject* obj, int level = 0) {
    if (!obj) return;

    // 获取所有的子对象
    auto subs = obj->children();
    
    // 设置层级前缀，用于显示树状结构
    QString head = "";
    for (int i = 0; i < level; i++) {
        head += "-";
    }

    // 遍历子对象
    for (auto s : subs) {
        QString str = head;
        str += "className: ";
        str += s->metaObject()->className();  // 获取对象类名
        str += " ";
        
        // 访问属性并添加到输出字符串中
        str += "width: ";
        str += s->property("width").toString();  // 尝试读取宽度属性
        str += " height: ";
        str += s->property("height").toString();  // 尝试读取高度属性

        // 打印对象信息
        qDebug() << str;

        // 如果子节点还有自己的子节点，递归遍历
        if (!s->children().empty()) {
            PrintQmlObj(s, level + 1);
        }
    }
}

• void PrintQmlObj(QObject* obj, int level = 0):
  • obj 为当前对象的指针，level 用于表示遍历的层次。
  • 如果 obj 为 nullptr，直接返回。
• auto subs = obj->children();:
  • 获取当前对象的所有子对象。
• QString head = ""; for (int i = 0; i < level; i++) { head += "-"; }:
  • 根据层次深度创建一个字符串前缀，以便打印输出时显示层次结构。
• str += s->metaObject()->className();:
  • 使用 metaObject() 获取子对象的元信息，从中获取类名。
• str += s->property("width").toString();:
  • 使用 property() 获取对象的属性值。这里尝试读取 width 和 height 属性。
• qDebug() << str;:
  • 输出对象的信息，包括层级、类名和属性值。
• if (!s->children().empty()) { PrintQmlObj(s, level + 1); }:
  • 如果当前对象还有子节点，则递归调用 PrintQmlObj，继续遍历。

读取 QML 对象的属性

可以通过 property() 方法来读取 QML 对象的属性：

if (textObject) {
    QVariant width = textObject->property("width");
    if (width.isValid()) {
        int widthValue = width.toInt();
        qDebug() << "宽度为：" << widthValue;
    }
}

property() 方法返回 QVariant 类型的值，可以通过 toInt()、toString() 等方法将其转换为相应类型。

修改 QML 对象的属性

可以通过 setProperty() 方法来修改 QML 对象的属性：

if (textObject) {
    textObject->setProperty("text", "Changed by C++");
    qDebug() << "Text 属性已修改。";
}