QAxBase Class

成员函数文档

[protected] QAxBase::QAxBase()

创建一个 QAxBase 对象。

[virtual noexcept] QAxBase::~QAxBase()

关闭 COM 对象并销毁QAxBase 对象。

另请参阅 clear()。

QVariant QAxBase::asVariant() const

返回一个封装了 COM 对象的 `QVariant ` 对象。随后，该 Variant 对象可作为参数用于诸如 `dynamicCall()` 等方法中。

ulong QAxBase::classContext() const

返回 ActiveX 控件将运行的上下文（默认值为 CLSCTX_SERVER）。

另请参阅 setClassContext()。

void QAxBase::clear()

断开与 COM 对象的连接并销毁该对象。

如果您重写了此函数，还必须重写析构函数以调用 clear()，并在您的 clear() 函数结尾处调用此实现。

QString QAxBase::control() const

返回 ActiveX 控件。

void QAxBase::disableClassInfo()

禁用此 ActiveX 容器的类信息生成。如果您不需要 ActiveX 控件的任何类信息，请使用此函数以加快元对象的生成速度。

请注意，必须在对象构造完成后立即调用此函数

void QAxBase::disableEventSink()

禁用此 ActiveX 容器的事件接收器实现。如果您不打算监听 ActiveX 控件的事件，请使用此函数以加快元对象的生成速度。

某些 ActiveX 控件在连接到事件接收器时可能不稳定。若要获取 OLE 事件，必须使用标准的 COM 方法注册您自己的事件接收器。请使用 `queryInterface()` 获取原始 COM 对象的访问权限。

请注意，应在对象构建完成后立即调用此函数。

void QAxBase::disableMetaObject()

禁用此 ActiveX 容器的元对象生成。这也会禁用事件接收器和类信息的生成。如果您不打算使用 Qt 元对象实现，请调用此函数以加快控件的实例化速度。 您仍然可以通过dynamicCall() 调用该对象，但QObject API 将无法访问信号、槽和属性。

某些 ActiveX 控件在与 OLE 自动化配合使用时可能不稳定。请使用标准 COM 方法，通过 `queryInterface()` 提供的 COM 接口来使用这些控件。

请注意，必须在对象构建完成后立即调用此函数。

QVariant QAxBase::dynamicCall(const char *function, const QVariant &var1 = QVariant(), const QVariant &var2 = QVariant(), const QVariant &var3 = QVariant(), const QVariant &var4 = QVariant(), const QVariant &var5 = QVariant(), const QVariant &var6 = QVariant(), const QVariant &var7 = QVariant(), const QVariant &var8 = QVariant())

调用 COM 对象的方法 `function`，传入参数 `var1`、`var1`、`var2`、`var3`、`var4`、`var5`、`var6`、`var7 ` 和 `var8`，并返回该方法返回的值；如果该方法不返回值，或者函数调用失败，则返回无效的 `QVariant `。

如果function 是该对象的一个方法，则必须提供完整的原型字符串，例如在QObject::connect() 调用中写法那样。

activeX->dynamicCall("Navigate(const QString&)", "www.qt-project.org");

或者，也可以通过将参数嵌入字符串中来调用函数，例如，上述函数也可以使用以下方式调用

activeX->dynamicCall("Navigate(\"www.qt-project.org\")");

所有参数均以字符串形式传递；能否被正确解析取决于控件本身，且其速度慢于使用原型并采用正确类型参数的方式。

如果 `function ` 是一个属性，则该字符串必须是该属性的名称。当 `var1 ` 是有效的 `QVariant` 时，将调用该属性的设置器；否则，将调用获取器。

activeX->dynamicCall("Value", 5);
QString text = activeX->dynamicCall("Text").toString();

请注意，使用QObject::property() 和QObject::setProperty() 获取和设置属性速度更快。

dynamicCall() 还可以用于调用带有disabled metaobject 包装器的对象，这可以显著提高性能，特别是在自动化过程中调用许多不同类型的对象时。不过，此时 ActiveQt 将不会对参数进行验证。

仅能通过 dynamicCall() 调用那些参数或返回值数据类型为QVariant 所支持的函数。有关支持和不支持的数据类型列表，请参阅QAxBase 类的文档。 若需调用参数列表中包含不受支持数据类型的函数，请使用queryInterface() 获取相应的 COM 接口，然后直接调用该函数。

IWebBrowser2 *webBrowser = 0;
activeX->queryInterface(IID_IWebBrowser2, (void **)&webBrowser);
if (webBrowser) {
    webBrowser->Navigate2(pvarURL);
    webBrowser->Release();
}

这种方法效率也更高。

QVariant QAxBase::dynamicCall(const char *function, QList<QVariant> &vars)

调用 COM 对象的方法 `function`，传入 `vars` 中的参数，并返回该方法返回的值。如果该方法不返回值，或者函数调用失败，则此函数将返回一个无效的 `QVariant ` 对象。

当该方法具有输出参数时，vars 中的QVariant 对象会被更新。

QString QAxBase::generateDocumentation()

返回一个包含被封装的 COM 对象文档的富文本字符串。可将该字符串导出为 HTML 文件，或将其用于例如QTextBrowser 控件中。

[virtual protected] bool QAxBase::initialize(IUnknown **ptr)

该虚拟函数由 setControl() 调用，用于创建所请求的 COM 对象。ptr 被设置为该对象的 IUnknown 实现。如果对象初始化成功，该函数返回 true；否则返回 false。

默认实现会解析control()返回的字符串，如果该字符串与相应的模式匹配，则调用initializeRemote()、initializeLicensed()或initializeActive()。如果control()是现有文件的名称，则调用initializeFromFile()。如果未匹配任何模式，或者远程初始化或许可初始化失败，则直接使用CoCreateInstance来创建该对象。

有关支持的模式的详细信息，请参阅QAxBaseWidget::control 属性的文档。

当本函数返回时，ptr 返回的接口必须被精确引用一次。例如由 CoCreateInstance 提供的接口已被引用，因此无需再次引用。

[protected] bool QAxBase::initializeActive(IUnknown **ptr)

连接到当前计算机上正在运行的活动实例，并返回ptr 中运行对象的IUnknown接口。如果成功，该函数返回true；否则返回false。

如果控制字符串中包含子字符串“}&”，则由initialize() 调用此函数。

另请参阅 initialize()。

[protected] bool QAxBase::initializeFromFile(IUnknown **ptr)

创建处理控件属性中文件名的 COM 对象，并将该对象的 IUnknown 接口返回给ptr 。如果操作成功，该函数返回 true；否则返回 false。

如果控件字符串是现有文件的名称，则由initialize() 调用此函数。

另请参阅 initialize()。

[protected] bool QAxBase::initializeLicensed(IUnknown **ptr)

创建一个已授权控件的实例，并通过ptr 返回该对象的IUnknown接口。若操作成功，该函数返回true；否则返回false。

如果控件字符串中包含子字符串“}:”，则由initialize()调用此函数。许可证密钥必须紧跟在此子字符串之后。

另请参阅 initialize()。

[protected] bool QAxBase::initializeRemote(IUnknown **ptr)

在远程服务器上创建实例，并将该对象的 IUnknown 接口返回给ptr 。如果成功，该函数返回 true；否则返回 false。

如果控制字符串包含子字符串“/{”，则由initialize() 调用此函数。有关远程计算机的信息需置于该子字符串之前。

另请参阅 initialize()。

bool QAxBase::isNull() const

如果该包装器未加载任何 COM 对象，则返回 true；否则返回 false。

另请参阅 control()。

QAxBase::PropertyBag QAxBase::propertyBag() const

返回一个包含 COM 对象所暴露的所有属性的名称-值映射。

如果 COM 对象支持属性袋，此方法比逐个获取多个属性更为高效。

另请参阅 setPropertyBag()。

[virtual] bool QAxBase::propertyWritable(const char *prop) const

如果属性prop 可写，则返回true；否则返回false。默认情况下，所有属性均为可写的。

另请参阅 setPropertyWritable()、QAxBaseWidget::propertyChanged() 和QAxBaseObject::propertyChanged()。

long QAxBase::queryInterface(const QUuid &uuid, void **iface) const

从 COM 对象请求接口uuid ，并将iface 的值设置为所提供的接口；如果无法提供所请求的接口，则将其设置为 0。

返回 COM 对象的 QueryInterface 实现的结果。

另请参阅 control()。

QAxObject *QAxBase::querySubObject(const char *name, const QVariant &var1 = QVariant(), const QVariant &var2 = QVariant(), const QVariant &var3 = QVariant(), const QVariant &var4 = QVariant(), const QVariant &var5 = QVariant(), const QVariant &var6 = QVariant(), const QVariant &var7 = QVariant(), const QVariant &var8 = QVariant())

返回一个指向QAxObject 的指针，该 封装了由方法或属性name 提供的COM对象，并传递参数var1 、var1 、var2 、var3 、var4 、var5 、var6 、var7 和var8 。

如果name 由方法提供，则该字符串必须包含完整的函数原型。

如果 `name ` 是一个属性，则该字符串必须是该属性的名称，且 `var1`、`...` 以及 `var8 ` 将被忽略。

返回的QAxObject 是该对象的子对象（类型为QAxObject 或QAxWidget 之一），并在该对象被删除时被删除。不过，您自己手动删除该返回对象是安全的，在遍历子对象列表时应这样做。

支持 COM 的应用程序通常具有一个对象模型，该模型将应用程序的某些元素作为分发接口发布。使用此方法可在对象模型的层次结构中进行导航，例如：

QAxWidget outlook("Outlook.Application");
QAxObject *session = outlook.querySubObject("Session");
if (session) {
    QAxObject *defFolder = session->querySubObject(
                            "GetDefaultFolder(OlDefaultFolders)",
                            "olFolderContacts");
    //...
}

QAxObject *QAxBase::querySubObject(const char *name, QList<QVariant> &vars)

当方法具有输出参数时，vars 中的QVariant 对象会被更新。

void QAxBase::setClassContext(ulong classContext)

设置 ActiveX 控件的运行上下文classContext

在调用 CoCreateInstance 时，此参数会影响“dwClsContext”参数。对于同时支持“进程内”和“进程外”两种启动方式的控件，可通过此参数控制其启动模式。 此外，当与 CLSCTX_ENABLE_CLOAKING 及一个冒名顶替令牌配合使用时，可用于修改或降低控件的权限。

请注意，此函数必须在调用 setControl() 之前调用，否则不会生效。

另请参阅 classContext()。

void QAxBase::setPropertyBag(const QAxBase::PropertyBag &bag)

将 COM 对象的属性设置为 `bag` 中的相应值。

另请参阅 propertyBag()。

[virtual] void QAxBase::setPropertyWritable(const char *prop, bool ok)

如果 `ok ` 为真，则将属性 `prop ` 设置为可写；否则将 `prop ` 设置为只读。默认情况下，所有属性均为可写。

另请参阅 propertyWritable()、QAxBaseWidget::propertyChanged() 和QAxBaseObject::propertyChanged()。

QStringList QAxBase::verbs() const

返回 COM 对象可执行的动词列表。如果该对象未实现 IOleObject 接口，或者不支持任何动词，则此函数返回一个空字符串列表。

请注意，该列表中不包含 OLE 默认动词（如 OLEIVERB_SHOW 等）。