QAxAggregated Class

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

[constexpr noexcept protected default] QAxAggregated::QAxAggregated()

QAxAggregated のインスタンスをデフォルトコンストラクタで生成します。

[virtual constexpr noexcept protected default] QAxAggregated::~QAxAggregated()

デストラクタはQtによって内部的に呼び出されます。

[protected] IUnknown *QAxAggregated::controllingUnknown() const

ActiveX コントロールの `IUnknown ` インターフェースを返します。QAxAggregated のサブクラスで `IUnknown ` インターフェースを実装し、`QueryInterface()`、`AddRef()`、および `Release() ` への呼び出しを、この関数が提供するインターフェースに委譲するようにしてください。

HRESULT AxImpl::QueryInterface(REFIID iid, void **iface)
{
    return controllingUnknown()->QueryInterface(iid, iface);
}

ulong AxImpl::AddRef()
{
    return controllingUnknown()->AddRef();
}

ulong AxImpl::Release()
{
    return controllingUnknown()->Release();
}

これら3つの関数を手動で宣言・実装する代わりに、サブクラスのクラス宣言でQAXAGG_IUNKNOWN マクロを使用することができます。

[protected] QObject *QAxAggregated::object() const

COM オブジェクトを実装する `QObject ` サブクラスへのポインタを返します。この関数は 0 を返す場合があります。

[pure virtual] long QAxAggregated::queryInterface(const QUuid &iid, void **iface)

追加の COM インターフェースをサポートするには、この純粋仮想関数を再実装してください。インターフェース `iid` をサポートするには、`iface ` の値を設定して、このオブジェクトを指すようにしてください。なお、this ポインタを適切なスーパークラスにキャストする必要があることに注意してください。

long AxImpl::queryInterface(const QUuid &iid, void **iface)
{
    *iface = 0;
    if (iid == IID_ISomeCOMInterface)
        *iface = (ISomeCOMInterface*)this;
    else
        return E_NOINTERFACE;

    AddRef();
    return S_OK;
}

標準の COM 結果であるS_OK （インターフェースがサポートされている）またはE_NOINTERFACE （要求されたインターフェースがサポートされていない）を返します。

[protected] QWidget *QAxAggregated::widget() const

ActiveX コントロールを実装する `QWidget ` サブクラスへのポインタを返します。この関数は 0 を返す場合があります。