QAxAggregated Class

Documentation sur les fonctions membres

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

Construit par défaut une instance de ` QAxAggregated`.

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

Le destructeur est appelé en interne par Qt.

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

Renvoie l'interface « IUnknown » du contrôle ActiveX. Implémentez l'interface « IUnknown » dans votre sous-classe « QAxAggregated » afin de déléguer les appels vers « QueryInterface() », « AddRef() » et « Release() » à l'interface fournie par cette fonction.

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

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

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

Au lieu de déclarer et d’implémenter ces trois fonctions manuellement, vous pouvez utiliser la macro ` QAXAGG_IUNKNOWN ` dans la déclaration de classe de votre sous-classe.

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

Renvoie un pointeur vers la sous-classe de ` QObject ` implémentant l'objet COM. Cette fonction peut renvoyer 0.

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

Réimplémentez cette fonction virtuelle pure pour prendre en charge des interfaces COM supplémentaires. Définissez la valeur de ` iface ` de manière à ce qu’elle pointe vers cet objet afin de prendre en charge l’interface ` iid`. Notez que vous devez effectuer un transtypage du pointeur ` this ` vers la superclasse appropriée.

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;
}

Renvoyez les résultats COM standard : ` S_OK ` (l'interface est prise en charge) ou ` E_NOINTERFACE ` (l'interface demandée n'est pas prise en charge).

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

Renvoie un pointeur vers la sous-classe de ` QWidget ` implémentant le contrôle ActiveX. Cette fonction peut renvoyer 0.