QAxFactory 类

成员函数文档

QAxFactory::QAxFactory(const QUuid &libid, const QUuid &appid)直接链接到此处

构造一个QAxFactory对象，在相应接口函数的实现中返回libid和appid。

[重写虚函数 noexcept] QAxFactory::~QAxFactory()直接链接到此处

销毁QAxFactory对象。

[虚拟] QUuid QAxFactory::appID() const直接链接到此处

重写此函数以返回ActiveX服务器应用程序标识符。

[虚拟] QUuid QAxFactory::classID(const QString &key) const直接链接到此处

重写此函数以返回featureList()实现返回的每个key的类标识符，或者如果在工厂中不支持key的值，则返回一个空的QUuid。

默认实现将key解释为类名，并返回Q_CLASSINFO()条目"ClassID"的值。

[纯虚函数] QObject *QAxFactory::createObject(const QString &key)

重写此函数以返回对应的对象，或返回0表示此工厂不支持该key值。

如果返回的对象是QWidget，它将被暴露为ActiveX控件，否则返回的对象将被作为简单的COM对象暴露。

[虚函数] bool QAxFactory::createObjectWrapper(QObject *object, IDispatch **wrapper)

重写此函数以在wrapper中提供object的COM对象。如果函数成功返回true；否则返回false。

默认实现将基于object的元对象信息创建一个通用的自动化wrapper。

[虚函数] QUuid QAxFactory::eventsID(const QString &key) const

重写此函数以返回由featureList()实现返回的每个key的事件接口标识符，如果此工厂不支持该key值，则返回空的QUuid。

默认实现将key解释为类名，并返回Q_CLASSINFO()条目"EventsID"的值。

[虚函数] QString QAxFactory::exposeToSuperClass(const QString &key) const

重写此函数以返回应该由ActiveX控件暴露的关键字的方法和属性的上层类的名称。

默认实现将key解释为类名，并返回Q_CLASSINFO()条目"Q_CLASSINFO"的值。如果没有设置这样的值，则返回null字符串，并暴露包括QWidget在内的所有上层类的函数和属性。

为了仅暴露本类的函数和属性，请重写此函数以返回key。

[纯虚函数] QStringList QAxFactory::featureList() const

重写此函数以返回由此工厂支持的控件列表（类名）。

[虚函数] bool QAxFactory::hasStockEvents(const QString &key) const

重写此函数以返回true，如果ActiveX控件key应支持标准ActiveX事件。

• 点击
• 双击
• 按键下
• 按键压
• 按键抬
• 鼠标下
• 鼠标上
• 鼠标移动

默认实现将key解释为类名，并根据Q_CLASSINFO()条目"StockEvents"为"yes"时返回true。否则此函数返回false。

[虚拟] QUuid QAxFactory::interfaceID(const QString &key) const

重新实现此函数以返回由 featureList() 实现返回的每个 key 的接口标识符，或者当此工厂不支持 key 的值时返回一个空的 QUuid。

默认实现在将 key 解释为类名后，返回 Q_CLASSINFO() 条目 "InterfaceID" 的值。

[静态] bool QAxFactory::isServer()

如果应用程序已作为 ActiveX 服务器启动（由 COM），则返回 true，否则返回 false。

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);
    if (!QAxFactory::isServer()) {
        // initialize for stand-alone execution
    }
    return app.exec();
}

[虚拟] bool QAxFactory::isService() const

重新实现此函数以返回服务器作为持久服务（例如 NT 服务）运行时为 true，即使已经释放了提供的所有对象也不应终止。

默认实现返回 false。

[纯虚] const QMetaObject *QAxFactory::metaObject(const QString &key) const

重新实现此函数以返回与 key 相关的 QMetaObject，或当此工厂不支持 key 的值时返回 0。

[静态] bool QAxFactory::registerActiveObject(QObject *object)

将 QObject object 在 COM 中注册为运行对象，并在注册成功时返回 true，否则返回 false。当对象被销毁时，将自动取消注册。

仅在用户（即不是由 COM 响应请求）启动应用程序时调用此函数，并且通常只能为应用程序对象层次结构中的顶级对象。

如果对象的 "RegisterObject" 类信息未设置为 "yes"，或服务器是进程内服务器，则此函数什么都不做并返回 false。

[虚拟] void QAxFactory::registerClass(const QString &key, QSettings *settings) const

使用 settings 对象在系统注册表中注册类 key 的附加值。框架已经注册了标准值，但可以通过此函数的实现添加附加值，例如实现类别。

settings->setValue("/CLSID/" + classID(key)
                   + "/Implemented Categories/"
                   + "/{00000000-0000-0000-000000000000}/.",
                   QString());

如果您重新实现此函数，还必须重新实现 unregisterClass() 以删除附加注册值。

另请参阅QSettings。

[静态] QString QAxFactory::serverDirPath()

返回包含服务器二进制文件的目录。

对于进程外服务器，此目录与 QCoreApplication::applicationDirPath() 相同。对于进程内服务器，该函数返回包含托管应用程序的目录。

[静态] QString QAxFactory::serverFilePath()

返回服务器可执行文件的文件路径。

对于进程外服务器，这和 QCoreApplication::applicationFilePath() 是一样的。对于进程内服务器，该函数返回宿主应用程序的文件路径。

[静态] bool QAxFactory::startServer(QAxFactory::ServerType type = MultipleInstances)

以 type 参数启动 COM 服务器，如果成功则返回 true，否则返回 false。

如果服务器已经运行（或对于进程内服务器），调用此函数不执行任何操作并返回 true。

如果使用带 -activex 命令行参数启动服务器可执行文件，则自动以 type 设置为 MultipleInstances 的方式启动服务器。要切换到 SingleInstance，请在您的 main() 入口函数中调用

if (QAxFactory::isServer()) {
    QAxFactory::stopServer();
    QAxFactory::startServer(QAxFactory::SingleInstance);
}

。

[虚函数] bool QAxFactory::stayTopLevel(const QString &key) const

重新实现此函数以返回 true，如果 ActiveX 控件 key 应该是一个顶级窗口，例如一个对话框。默认实现返回 false。

[静态] bool QAxFactory::stopServer()

停止 COM 服务器并返回 true 如果成功，否则返回 false。

如果服务器未运行（或对于进程内服务器），调用此函数不执行任何操作并返回 true。

停止服务器不会使现有对象无效，但无法从现有服务器进程创建新的对象。通常 COM 会启动一个新的服务器进程，如果有额外的对象请求。

当 main() 函数返回时，服务器会自动停止。

[虚函数] QUuid QAxFactory::typeLibID() const

重新实现此函数以返回 ActiveX 服务器的类型库标识符。

[虚函数] void QAxFactory::unregisterClass(const QString &key, QSettings *settings) const

使用 settings 对象从系统注册表中注销类 key 的任何额外值。

settings->remove("/CLSID/" + classID(key)
                 + "/Implemented Categories"
                 + "/{00000000-0000-0000-000000000000}/.");

另请参阅registerClass() 和 QSettings.

[虚函数] bool QAxFactory::validateLicenseKey(const QString &key, const QString &licenseKey) const

重新实现此函数以返回 true，如果 licenseKey 是类 key 的有效许可证，或者当前机器已获得授权。

默认实现返回 true，如果类 key 未授权（即没有 Q_CLASSINFO() 属性 "LicenseKey")，或者如果 licenseKey 与 "LicenseKey" 属性的值匹配，或者通过与该 COM 服务器具有相同文件名的 .LIC 文件授权了机器。