Interface IDataObject (objidl.h)

Active le transfert de données et la notification des modifications apportées aux données. Les méthodes de transfert de données spécifient le format des données transférées ainsi que le support par lequel les données doivent être transférées. Si vous le souhaitez, les données peuvent être rendues pour un appareil cible spécifique. En plus des méthodes de récupération et de stockage des données, l’interface IDataObject spécifie des méthodes permettant d’énumérer les formats disponibles et de gérer les connexions aux récepteurs consultatifs pour la gestion des notifications de modification.

Le terme objet de données est utilisé pour désigner tout objet qui prend en charge une implémentation de l’interface IDataObject . Les implémentations varient en fonction de ce que l’objet de données doit effectuer ; dans certains objets de données, l’implémentation de certaines méthodes non prises en charge par l’objet peut simplement être le retour de E_NOTIMPL. Par exemple, certains objets de données ne permettent pas aux appelants de leur envoyer des données. Les autres objets de données ne prennent pas en charge les connexions d’avis et les notifications de modification. Toutefois, pour les objets de données qui prennent en charge les notifications de modification, OLE fournit un objet appelé support de conseil de données. Un pointeur d’interface vers ce titulaire est disponible via un appel à la fonction d’assistance CreateDataAdviseHolder. Un objet de données peut avoir plusieurs connexions, chacune avec son propre ensemble d’attributs. Le titulaire de conseils de données OLE simplifie la tâche de gestion de ces connexions et d’envoi des notifications appropriées.

Héritage

L’interface IDataObject hérite de l’interface IUnknown. IDataObject a également les types de membres suivants :

Méthodes

L’interface IDataObject a ces méthodes.

IDataObject ::D Advise Appelé par un objet prenant en charge un récepteur d’avis pour créer une connexion entre un objet de données et le récepteur de conseil. Cela permet au récepteur d’avis d’être informé des modifications apportées aux données de l’objet.
IDataObject ::D Unadvise Détruit une connexion de notification qui avait été configurée précédemment.
IDataObject ::EnumDAdvise Crée un objet qui peut être utilisé pour énumérer les connexions de notifications actuelles.
IDataObject ::EnumFormatEtc Crée un objet pour énumérer les formats pris en charge par un objet de données.
IDataObject ::GetCanonicalFormatEtc Fournit une structure FORMATETC potentiellement différente, mais logiquement équivalente. Vous utilisez cette méthode pour déterminer si deux structures FORMATETC différentes retournent les mêmes données, ce qui supprime la nécessité d’un rendu en double.
IDataObject ::GetData Appelé par un consommateur de données pour obtenir des données à partir d’un objet de données source.
IDataObject ::GetDataHere Appelé par un consommateur de données pour obtenir des données à partir d’un objet de données source. Cette méthode diffère de la méthode GetData en ce que l’appelant doit allouer et libérer le support de stockage spécifié.
IDataObject ::QueryGetData Détermine si l'objet de données est capable de rendre les données comme spécifié. Les objets tentant une opération de collage ou de suppression peuvent appeler cette méthode avant d’appeler IDataObject ::GetData pour obtenir une indication de la réussite de l’opération.
IDataObject ::SetData Appelé par un objet contenant une source de données pour transférer des données vers l’objet qui implémente cette méthode.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau | Applications UWP]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau | Applications UWP]
Plateforme cible	Windows
En-tête	objidl.h