QAxWidget 是 Qt 中用于嵌入 ActiveX 控件或 COM 对象的类，主要用于 Windows 平台。以下是其使用方法的详细步骤和示例：

1. 环境配置

在 .pro 文件中添加 axcontainer 模块：

QT += axcontainer

2. 基本使用

创建控件实例

#include <QAxWidget>

QAxWidget *axWidget = new QAxWidget(this);

加载 ActiveX 控件

通过 ProgID 或 CLSID 指定控件：

// 使用 ProgID（例如 Windows Media Player）
axWidget->setControl("WMPlayer.OCX.7");

// 或使用 CLSID
axWidget->setControl("{6BF52A52-394A-11D3-B153-00C04F79FAA6}");

设置属性和调用方法

• 设置属性：

  axWidget->setProperty("URL", "C:/music.mp3");
  

• 调用方法：

  axWidget->dynamicCall("play()");
  

获取属性值

QVariant volume = axWidget->property("Volume");

3. 处理事件

连接 ActiveX 控件的事件到 Qt 槽函数：

// 连接播放状态改变事件
connect(axWidget, SIGNAL(PlayStateChange(int)), this, SLOT(onPlayStateChanged(int)));

// 槽函数定义
void MyClass::onPlayStateChanged(int state) {
    qDebug() << "Playback state changed:" << state;
}

4. 访问子对象

使用 querySubObject 访问子对象：

QAxObject *settings = axWidget->querySubObject("settings");
if (settings) {
    settings->dynamicCall("setVolume(int)", 50);
    delete settings;
}

5. 错误处理

检查控件是否加载成功：

if (axWidget->isNull()) {
    qDebug() << "Failed to load ActiveX control.";
}

6. 示例：嵌入 Windows Media Player

QAxWidget *wmp = new QAxWidget(this);
wmp->setControl("WMPlayer.OCX.7");
wmp->setProperty("URL", "C:/music.mp3");
wmp->resize(400, 300);  // 设置控件大小
wmp->show();  // 显示控件

注意事项

• 平台限制：仅支持 Windows。
• 控件注册：确保目标机器已注册所需控件（如使用 regsvr32 注册 .dll）。
• 文档参考：查阅对应 ActiveX 控件的文档以获取正确的方法、属性和事件名称。

常见问题

• QAxWidget 加载失败：检查 ProgID/CLSID 是否正确，控件是否已注册。
• 方法调用失败：确认参数类型和数量与 COM 接口一致。
• 内存管理：使用 deleteLater() 避免内存泄漏。

通过以上步骤，您可以在 Qt 应用中集成 ActiveX 控件，实现丰富的功能扩展。