Partager via


Classe d'IDispEventImpl

Cette classe fournit des implémentations de méthodes d' IDispatch .

Important

Cette classe et ses membres ne peuvent pas être utilisés dans les applications qui s'exécutent dans Windows Runtime.

template <
UINT nID,
class T,
const IID* pdiid= &IID_NULL,
const GUID* plibid= &GUID_NULL,
WORD wMajor= 0,
WORD wMinor= 0,
class tihclass= CcomTypeInfoHolder
>
class ATL_NO_VTABLE IDispEventImpl :
public IDispEventSimpleImpl<nID, T, pdiid>

Paramètres

  • nID
    Un identificateur unique de l'objet source.Lorsque IDispEventImpl est la classe de base pour un contrôle composite, utilisez l'ID de ressource du contrôle contenu souhaité pour ce paramètre.Dans d'autres cas, utilisez un entier positif arbitraire.

  • T
    La classe de l'utilisateur, qui est dérivée d' IDispEventImpl.

  • pdiid
    Le pointeur à l'IID de la dispinterface d'événements implémentée par cette classe.Cette interface doit être définie dans la bibliothèque de types dénotée par plibid, wMajor, et wMinor.

  • plibid
    Un pointeur vers la bibliothèque de types qui définit l'interface de dispatch a globale pointe vers pdiid.Si &GUID_NULL, la bibliothèque de types est chargé d'approvisionnement d'objet des événements.

  • wMajor
    Version principale de la bibliothèque de types.La valeur par défaut est 0.

  • wMinor
    Version secondaire de la bibliothèque de types.La valeur par défaut est 0.

  • tihclass
    La classe utilisée pour gérer les informations de type pour T.La valeur par défaut est une classe de type CComTypeInfoHolder; toutefois, vous pouvez remplacer ce paramètre de modèle en fournissant une classe d'un type autre que CComTypeInfoHolder.

Membres

d7eecxta.collapse_all(fr-fr,VS.110).gifTypedefs publics

Nom

Description

Classe d'IDispEventImpl

La classe utilisée pour gérer les informations de type.Par défaut, CComTypeInfoHolder.

d7eecxta.collapse_all(fr-fr,VS.110).gifConstructeurs publics

Nom

Description

IDispEventImpl::IDispEventImpl

Constructeur.

d7eecxta.collapse_all(fr-fr,VS.110).gifMéthodes publiques

Nom

Description

IDispEventImpl::GetFuncInfoFromId

Localise l'index de la fonction de l'identificateur spécifié d'expédition.

IDispEventImpl::GetIDsOfNames

Mappe un membre unique et un jeu facultatif de noms d'argument à un ensemble correspondant de Dispid entier.

IDispEventImpl::GetTypeInfo

Extrait les informations de type d'un objet.

IDispEventImpl::GetTypeInfoCount

Récupère le nombre d'interfaces des informations de type.

IDispEventImpl::GetUserDefinedType

Récupère le type de base d'un type défini par l'utilisateur.

Notes

IDispEventImpl permet d'implémenter une dispinterface d'événements sans qu'il soit nécessaire de fournir le code d'implémentation pour chaque méthode/événement sur cette interface.IDispEventImpl fournit des implémentations de méthodes d' IDispatch .Vous devez seulement fournir des implémentations pour les événements qui vous intéressent par la gestion.

IDispEventImpl fonctionne avec table de récepteurs d'événements dans votre classe pour router des événements à la fonction gestionnaire appropriée.Pour utiliser cette classe :

Ajoutez une macro de SINK_ENTRY ou de SINK_ENTRY_EX à la table de récepteurs d'événements pour chaque événement sur chaque objet que vous souhaitez gérer.Lorsque vous utilisez IDispEventImpl comme classe de base d'un contrôle composite, vous pouvez appeler AtlAdviseSinkMap pour générer et arrêter la connexion avec les sources d'événements pour toute la carte du récepteur d'entrées dans le.Dans d'autres cas, ou pour un contrôle, un appel supérieurs DispEventAdvise pour établir la connexion entre l'objet source et la classe de base.Appel DispEventUnadvise pour arrêter la connexion.

Vous devez dériver d' IDispEventImpl (à l'aide d'une valeur unique pour nID) pour chaque objet dont vous devez gérer des événements.Vous pouvez réutiliser la classe de base par unadvising à un objet source informant ensuite à un objet source différent, mais le nombre maximal d'objets sources qui peuvent être gérés par un objet unique en même temps est limité par le nombre de classes de base d' IDispEventImpl .

IDispEventImpl fournit les mêmes fonctionnalités que IDispEventSimpleImpl, à moins qu'il puisse obtenir des informations de type sur l'interface d'une bibliothèque de types plutôt que l'ayant l'a fourni comme pointeur vers une structure de _ATL_FUNC_INFORMATION .Utilisez IDispEventSimpleImpl lorsque vous n'avez pas une bibliothèque de types décrivant l'interface d'événement ou ne souhaitez pas éviter la charge mémoire associée à utiliser la bibliothèque de types.

[!REMARQUE]

IDispEventImpl et IDispEventSimpleImpl fournissent leur propre implémentation d' IUnknown::QueryInterface ce qui permet à chaque classe de base d' IDispEventImpl et d' IDispEventSimpleImpl d'agir en tant qu'identité séparée COM tout en permettant à l'accès direct aux membres de classe dans votre objet COM principal.

L'implémentation ATL windows embedded CE des récepteurs d'événements ActiveX ne prend en charge que les valeurs de retour de type HRESULT ou void de vos méthodes de gestionnaire d'événements ; toute autre valeur de retour n'est pas prise en charge et son comportement n'est pas défini.

Pour plus d'informations, consultez l' IDispEventImpl prenant.

Hiérarchie d'héritage

_IDispEvent

_IDispEventLocator

IDispEventSimpleImpl

IDispEventImpl

Configuration requise

Header: atlcom.h

Voir aussi

Référence

Structure de _ATL_FUNC_INFORMATION

Classe d'IDispatchImpl

Classe d'IDispEventSimpleImpl

SINK_ENTRY

SINK_ENTRY_EX

SINK_ENTRY_INFORMATION

Autres ressources

Vue d'ensemble de la classe ATL