QAxBindable Class

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

QAxBindable::QAxBindable()

空のQAxBindableオブジェクトを生成します。

[virtual noexcept] QAxBindable::~QAxBindable()

QAxBindable オブジェクトを破棄します。

[protected] IUnknown *QAxBindable::clientSite() const

この ActiveX オブジェクトのクライアント側インターフェースへのポインタを返します。クライアント側が設定されていない場合は null を返します。

返されたインターフェースに対してQueryInterface() を呼び出すことで、呼び出したいインターフェースを取得できます。

[virtual] QAxAggregated *QAxBindable::createAggregate()

ActiveX コントロールに追加の COM インターフェースを実装したい場合、または COM インターフェースの代替実装を提供したい場合は、この関数を再実装してください。QAxAggregated のサブクラスである新しいオブジェクトを返してください。

デフォルトの実装では、nullポインタが返されます。

[protected] void QAxBindable::propertyChanged(const char *property)

この関数を呼び出すことで、この ActiveX コントロールをホストしているクライアントに対し、プロパティ `property ` が変更されたことを通知します。

この関数は通常、プロパティの書き込み関数の最後に呼び出されます。

requestPropertyChange()も参照してください 。

[virtual] bool QAxBindable::readData(QIODevice *source, const QString &format)

COM オブジェクトが MIME タイプをサポートしている場合、この関数が呼び出され、format にあるデータsource に基づいて COM オブジェクトが初期化されます。このデータから読み取るには、事前にsource を読み取り用にオープンしておく必要があります。

成功した場合は true を返します。この関数が false を返した場合、ActiveQt はメタオブジェクトシステムを通じてプロパティを設定することでデータを処理します。

この関数を再実装する場合は、writeData() も実装する必要があります。デフォルトの実装では何も行わず、false を返します。

writeData()も参照してください 。

void QAxBindable::reportError(int code, const QString &src, const QString &desc, const QString &context = QString())

クライアントアプリケーションにエラーを報告します。code は、コントロールで定義されたエラーコードです。desc は、アプリケーションのユーザー向けに、人間が読みやすい形で記述されたエラーの説明です。src は、エラーの発生源の名前であり、通常はActiveXサーバー名です。context は、エラーに関する詳細情報が記載されたヘルプファイルの場所です。context が角括弧内の数字（例：[12]）で終わっている場合、この数字はヘルプファイル内でコンテキストIDとして解釈されます。

[protected] bool QAxBindable::requestPropertyChange(const char *property)

この関数を呼び出すと、この ActiveX コントロールをホストしているクライアントから、プロパティ `property ` を変更する許可を要求します。クライアントが変更を許可した場合は `true` を返し、そうでない場合は `false` を返します。

この関数は通常、property の書き込み関数内で最初に呼び出され、関数が false を返した場合は書き込みが中止されます。

void MyActiveQt::setText(const QString &text)
{
    if (!requestPropertyChange("text"))
        return;

    // update property

    propertyChanged("text");
}

propertyChanged()も参照してください 。

[virtual] bool QAxBindable::writeData(QIODevice *sink)

COMオブジェクトがMIMEタイプをサポートしている場合、この関数が呼び出され、COMオブジェクトがsink に保存されます。書き込みを行うには、事前にsink を書き込み用にオープンしておく必要があります。

成功した場合は true を返します。関数が false を返した場合、ActiveQt はプロパティ値を保存することでオブジェクトをシリアライズします。

この関数を再実装する場合は、readData() も実装する必要があります。デフォルトの実装は何も行わず、false を返します。

readData()も参照してください 。