QAxFactory Class

成员函数文档

QAxFactory::QAxFactory(const QUuid &libid, const QUuid &appid)

构建一个 QAxFactory 对象，该对象在实现相应的接口函数时，会返回 `libid ` 和 `appid `。

[override virtual noexcept] QAxFactory::~QAxFactory()

销毁QAxFactory 对象。

[virtual] QUuid QAxFactory::appID() const

请重新实现此函数，使其返回 ActiveX 服务器的应用程序标识符。

[virtual] QUuid QAxFactory::classID(const QString &key) const

重写此函数，使其返回由featureList() 实现返回的每个key 的类标识符；如果该工厂不支持key 的值，则返回空的QUuid 。

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

[pure virtual] QObject *QAxFactory::createObject(const QString &key)

重写此函数，使其在遇到 `key` 时返回一个新对象，否则（如果该工厂不支持 `key` 的值）返回 0。

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

[virtual] bool QAxFactory::createObjectWrapper(QObject *object, IDispatch **wrapper)

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

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

[virtual] QUuid QAxFactory::eventsID(const QString &key) const

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

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

[virtual] QString QAxFactory::exposeToSuperClass(const QString &key) const

重写此函数，使其返回key 的父类名称，即ActiveX控件应公开该类及其所有子类的的方法和属性。

默认实现将key 解释为类名，并返回Q_CLASSINFO() 项中“ToSuperClass”的值。如果未设置该值，则返回空字符串，此时将暴露包括QWidget 在内的所有父类的函数和属性。

若要仅公开该类自身的函数和属性，请重写此函数，使其返回key 。

[pure virtual] QStringList QAxFactory::featureList() const

重写此函数，使其返回该工厂所支持的小部件（类名）的列表。

[virtual] bool QAxFactory::hasStockEvents(const QString &key) const

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

• Click
• DblClick
• KeyDown
• KeyDown
• KeyUp
• 鼠标按下
• MouseUp
• MouseMove

默认实现将 `key ` 解释为类名，如果 `Q_CLASSINFO() ` 中的“StockEvents”项的值为“yes”，则返回 true。否则，该函数返回 false。

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

重写此函数，使其返回featureList()实现所返回的每个key 对应的接口标识符；若该工厂不支持key 的值，则返回空的QUuid 。

默认实现将 `key ` 解释为类名，并返回 `Q_CLASSINFO()` 条目中“InterfaceID”的值。

[static] bool QAxFactory::isServer()

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

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

[virtual] bool QAxFactory::isService() const

请重写此函数，使其在服务器作为持久性服务（例如 NT 服务）运行时返回 true，即使所有提供的对象已被释放，该服务也不应终止。

默认实现返回 false。

[pure virtual] const QMetaObject *QAxFactory::metaObject(const QString &key) const

请重写此函数，使其返回与key 对应的 `QMetaObject `，如果该工厂不支持key 的值，则返回 0。

[static] bool QAxFactory::registerActiveObject(QObject *object)

将QObject object 作为运行中的对象注册到COM中，如果注册成功则返回true，否则返回false。该对象在被销毁时会自动注销。

仅当应用程序由用户启动（即非由 COM 为响应请求而启动）时，才应调用此函数，且仅针对一个对象，通常是应用程序对象层次结构中的顶级对象。

如果对象的“RegisterObject”类信息未设置为“yes”，或者服务器是进程内服务器，则此函数不执行任何操作并返回 false。

[virtual] 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 。

[static] QString QAxFactory::serverDirPath()

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

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

[static] QString QAxFactory::serverFilePath()

返回服务器二进制文件的路径。

对于进程外服务器，此函数与 `QCoreApplication::applicationFilePath()` 功能相同。对于进程内服务器，该函数返回宿主应用程序的文件路径。

[static] 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);
}

。

[virtual] bool QAxFactory::stayTopLevel(const QString &key) const

请重写此函数，如果 ActiveX 控件key 应作为顶级窗口（例如对话框）显示，则该函数应返回 true。默认实现返回 false。

[static] bool QAxFactory::stopServer()

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

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

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

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

[virtual] QUuid QAxFactory::typeLibID() const

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

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

使用settings 对象，从系统注册表中注销类key 的所有附加值。

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

另请参阅 registerClass() 和QSettings 。

[virtual] bool QAxFactory::validateLicenseKey(const QString &key, const QString &licenseKey) const

请重写此函数，使其在以下情况下返回 true：licenseKey 是类key 的有效许可证，或者当前机器已获得许可。

默认实现会在以下情况返回 true：类key 未获得许可（即没有Q_CLASSINFO() 属性“LicenseKey”），或licenseKey 与“LicenseKey”属性的值匹配，或者该计算机通过一个与该 COM 服务器同名的 .LIC 文件获得了许可。