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」エントリの値を返します。この値が設定されていない場合は空文字列が返され、QWidget を含むすべてのスーパークラスの関数とプロパティが公開されます。

クラス自体の関数とプロパティのみを公開するには、この関数を再実装して `key` を返すようにしてください。

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

この関数を再実装し、このファクトリがサポートするウィジェット（クラス名）のリストを返すようにしてください。

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

ActiveX コントロール「key 」が標準の ActiveX イベントをサポートすべきである場合に true を返すよう、この関数を再実装してください。

• Click
• DblClick
• KeyDown
• KeyPress
• 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 によって起動された場合を除く）にのみ呼び出すべきであり、また 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)

type を使用して COM サーバーを起動します。成功した場合は true を返し、失敗した場合は false を返します。

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

サーバーの実行ファイルが-activex コマンドライン引数で起動されている場合、type がMultipleInstances に設定されていれば、サーバーは自動的に起動されます。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 の有効なライセンスである場合、または現在のマシンにライセンスが適用されている場合に true を返すようにしてください。

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