QAxFactory Class

メンバ関数のドキュメント

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

libid とappid を返す QAxFactory オブジェクトを、それぞれのインターフェイス関数の実装で構築します。

[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

この関数を再実装して、ActiveX コントロールがメソッドとプロパティを公開するkey までのスーパークラスの名前を返します。

デフォルトの実装では、key をクラス名として解釈し、Q_CLASSINFO() のエントリ "ToSuperClass" の値を返します。そのような値が設定されていない場合、NULL文字列が返され、QWidget を含むすべてのスーパークラスの関数とプロパティが公開されます。

クラス自身の関数とプロパティのみを公開するには、この関数を再実装してkey を返します。

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

このファクトリーがサポートするウィジェット（クラス名）のリストを返すために、この関数を再実装します。

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

この関数を再実装し、ActiveX コントロールkey が標準 ActiveX イベントをサポートする場合に true を返すようにします。

• クリック
• ダブルクリック
• キーダウン
• キープレス
• キーアップ
• マウスダウン
• マウスアップ
• マウス移動

デフォルトの実装では、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 がリクエストに応答するためではなく）にのみ呼び出され、1 つのオブジェクト（通常はアプリケーションのオブジェクト階層のトップレベル・オブジェクト）に対してのみ呼び出されます。

この関数は、オブジェクトの "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)

COM サーバーをtype で起動し、成功すれば真を、そうでなければ偽を返す。

サーバーがすでに実行されている場合（またはインプロセスサーバーの場合）、この関数を呼び出しても何もせず、trueを返します。

サーバの実行ファイルが-activex コマンドラインパラメータで開始されている場合、サーバはMultipleInstances に設定されたtype で自動的に開始されます。SingleInstance に切り替えるには

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

この関数を再実装して、licenseKey がクラスkey に対して有効なライセンスである場合、または現在のマシンにライセンスが付与されている場合に真を返します。

デフォルトの実装では、クラスkey がライセンスされていない場合 (つまり、Q_CLASSINFO() 属性 "LicenseKey" がない場合)、またはlicenseKey が "LicenseKey" 属性の値と一致する場合、またはマシンがこの COM サーバーと同じファイル名の .LIC ファイルを介してライセンスされている場合に true を返す。