QAxAggregated Class

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

[virtual constexpr noexcept protected] 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 を返すことがあります。