IDataObjectImpl, classe
Cette classe fournit des méthodes pour prendre en charge le transfert de données uniformes et la gestion des connexions.
Important
Cette classe et ses membres ne peuvent pas être utilisés dans les applications qui s’exécutent dans Windows Runtime.
Syntaxe
template<class T>
class IDataObjectImpl
Paramètres
T
Votre classe, dérivée de IDataObjectImpl.
Membres
Méthodes publiques
| Nom | Description |
|---|---|
| IDataObjectImpl ::D Advise | Établit une connexion entre l’objet de données et un récepteur d’avis. Cela permet au récepteur d’avis de recevoir des notifications de modifications dans l’objet. |
| IDataObjectImpl ::D Unadvise | Termine une connexion précédemment établie via DAdvise. |
| IDataObjectImpl ::EnumDAdvise | Crée un énumérateur pour itérer au sein des connexions de conseil actuelles. |
| IDataObjectImpl ::EnumFormatEtc | Crée un énumérateur pour itérer dans les FORMATETC structures prises en charge par l’objet de données. L’implémentation ATL retourne E_NOTIMPL. |
| IDataObjectImpl ::FireDataChange | Renvoie une notification de modification à chaque récepteur d’avis. |
| IDataObjectImpl ::GetCanonicalFormatEtc | Récupère une structure logiquement équivalente FORMATETC à une structure plus complexe. L’implémentation ATL retourne E_NOTIMPL. |
| IDataObjectImpl ::GetData | Transfère les données de l’objet de données au client. Les données sont décrites dans une FORMATETC structure et transférées par le biais d’une STGMEDIUM structure. |
| IDataObjectImpl ::GetDataHere | Similaire à GetData, sauf que le client doit allouer la STGMEDIUM structure. L’implémentation ATL retourne E_NOTIMPL. |
| IDataObjectImpl ::QueryGetData | Détermine si l’objet de données prend en charge une structure particulière FORMATETC pour le transfert de données. L’implémentation ATL retourne E_NOTIMPL. |
| IDataObjectImpl ::SetData | Transfère les données du client à l’objet de données. L’implémentation ATL retourne E_NOTIMPL. |
Notes
L’interface IDataObject fournit des méthodes pour prendre en charge le transfert de données uniformes. IDataObject utilise les structures de format standard FORMATETC et STGMEDIUM pour récupérer et stocker des données.
IDataObject gère également les connexions pour conseiller les récepteurs de gérer les notifications de modification de données. Pour que le client reçoive des notifications de modification de données de l’objet de données, le client doit implémenter l’interface IAdviseSink sur un objet appelé récepteur d’avis. Lorsque le client appelle IDataObject::DAdviseensuite, une connexion est établie entre l’objet de données et le récepteur conseiller.
La classe IDataObjectImpl fournit une implémentation par défaut et IDataObject implémente en IUnknown envoyant des informations à l’appareil de vidage dans les builds de débogage.
Didacticiel ATL sur les articles connexes, création d’un projet ATL
Hiérarchie d'héritage
IDataObject
IDataObjectImpl
Spécifications
En-tête : atlctl.h
IDataObjectImpl ::D Advise
Établit une connexion entre l’objet de données et un récepteur d’avis.
HRESULT DAdvise(
FORMATETC* pformatetc,
DWORD advf,
IAdviseSink* pAdvSink,
DWORD* pdwConnection);
Notes
Cela permet au récepteur d’avis de recevoir des notifications de modifications dans l’objet.
Pour terminer la connexion, appelez DUnadvise.
Voir IDataObject ::D Advise dans le Kit de développement logiciel (SDK) Windows.
IDataObjectImpl ::D Unadvise
Termine une connexion précédemment établie via DAdvise.
HRESULT DUnadvise(DWORD dwConnection);
Notes
Consultez IDataObject ::D Unadvise dans le Kit de développement logiciel (SDK) Windows.
IDataObjectImpl ::EnumDAdvise
Crée un énumérateur pour itérer au sein des connexions de conseil actuelles.
HRESULT DAdvise(
FORMATETC* pformatetc,
DWORD advf,
IAdviseSink* pAdvSink,
DWORD* pdwConnection);
Notes
Voir IDataObject ::EnumDAdvise dans le Kit de développement logiciel (SDK) Windows.
IDataObjectImpl ::EnumFormatEtc
Crée un énumérateur pour itérer dans les FORMATETC structures prises en charge par l’objet de données.
HRESULT EnumFormatEtc(
DWORD dwDirection,
IEnumFORMATETC** ppenumFormatEtc);
Notes
Voir IDataObject ::EnumFormatEtc dans le Kit de développement logiciel (SDK) Windows.
Valeur de retour
Retourne E_NOTIMPL.
IDataObjectImpl ::FireDataChange
Renvoie une notification de modification à chaque récepteur d’avis en cours de gestion.
HRESULT FireDataChange();
Valeur de retour
Valeur HRESULT standard.
IDataObjectImpl ::GetCanonicalFormatEtc
Récupère une structure logiquement équivalente FORMATETC à une structure plus complexe.
HRESULT GetCanonicalFormatEtc(FORMATETC* pformatetcIn, FORMATETC* pformatetcOut);
Valeur de retour
Retourne E_NOTIMPL.
Notes
Voir IDataObject ::GetCanonicalFormatEtc dans le Kit de développement logiciel (SDK) Windows.
IDataObjectImpl ::GetData
Transfère les données de l’objet de données au client.
HRESULT GetData(
FORMATETC* pformatetcIn,
STGMEDIUM* pmedium);
Notes
Le paramètre pformatetcIn doit spécifier un type de support de stockage de TYMED_MFPICT.
Voir IDataObject ::GetData dans le Kit de développement logiciel (SDK) Windows.
IDataObjectImpl ::GetDataHere
Similaire à GetData, sauf que le client doit allouer la STGMEDIUM structure.
HRESULT GetDataHere(
FORMATETC* pformatetc,
STGMEDIUM* pmedium);
Valeur de retour
Retourne E_NOTIMPL.
Notes
Voir IDataObject ::GetDataHere dans le Kit de développement logiciel (SDK) Windows.
IDataObjectImpl ::QueryGetData
Détermine si l’objet de données prend en charge une structure particulière FORMATETC pour le transfert de données.
HRESULT QueryGetData(FORMATETC* pformatetc);
Valeur de retour
Retourne E_NOTIMPL.
Notes
Voir IDataObject ::QueryGetData dans le Kit de développement logiciel (SDK) Windows.
IDataObjectImpl ::SetData
Transfère les données du client à l’objet de données.
HRESULT SetData(
FORMATETC* pformatetc,
STGMEDIUM* pmedium,
BOOL fRelease);
Valeur de retour
Retourne E_NOTIMPL.
Notes
Voir IDataObject ::SetData dans le Kit de développement logiciel (SDK) Windows.