qobject_cast 是 Qt 提供的一个 类型安全的指针转换函数，专门用于将 QObject* 或其子类指针转换为目标类型指针（也是继承自 QObject 的类）。

它的功能类似于 C++ 的 dynamic_cast，但它不依赖 RTTI（运行时类型识别），而是使用 Qt 的元对象系统（Meta-Object System）。

🔹 语法

T qobject_cast<T>(QObject *object);
T qobject_cast<T>(const QObject *object);

🔹 示例

QWidget *widget = new QPushButton("点击我");
QPushButton *button = qobject_cast<QPushButton *>(widget);

if (button) {
    button->setText("转换成功！");
}

上面代码中，widget 实际上是一个 QPushButton，使用 qobject_cast 可以安全地将其转换回原始类型。

🔹 特点

🔹 使用场景

• 你有一个 QObject* 或 QWidget* 指针，但不确定它指向的实际类型。

• 想安全地尝试转换为某个子类指针。

• 在处理 Qt 的信号槽、事件过滤器、插件系统等场景时。

🔹 等价原理

其实可以理解为：

if (object->inherits("QPushButton")) {
    QPushButton *btn = static_cast<QPushButton *>(object);
}
 

但 qobject_cast 比 inherits + static_cast 更安全，也更简洁。

🔹 注意事项

• 要转换的类必须继承自 QObject。

• 必须有 Q_OBJECT 宏，否则 Qt 的元对象系统不会生效，qobject_cast 无法正常判断类型。