本节课程将详细讲解如何通过 C++ 代码访问并操作 QML 对象。通常来说，我们的需求是访问 QML 的属性和信号，而避免直接修改 QML，因为这样做会改变业务逻辑。
查找 QML 对象
在 Qt Quick 中，我们可以通过 C++ 代码与 QML 对象进行交互，访问它们的属性和调用它们的方法。为了实现这种交互，我们需要先通过 QML 的上下文对象找到我们要操作的 QML 对象。然后，使用 QObject 提供的接口来遍历节点或操作对象的属性。
- 首先获取 QML 的根节点。
- 使用
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: myTXTobjectName: "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 属性已修改。";
}
