Condividi tramite


Interfaccia IDataObject (objidl.h)

Abilita il trasferimento e la notifica delle modifiche apportate ai dati. I metodi di trasferimento dei dati specificano il formato dei dati trasferiti insieme al supporto attraverso il quale devono essere trasferiti i dati. Facoltativamente, è possibile eseguire il rendering dei dati per un dispositivo di destinazione specifico. Oltre ai metodi per il recupero e l'archiviazione dei dati, l'interfaccia IDataObject specifica i metodi per enumerare i formati disponibili e gestire le connessioni ai sink consultivi per la gestione delle notifiche delle modifiche.

Il termine oggetto dati viene usato per indicare qualsiasi oggetto che supporta un'implementazione dell'interfaccia IDataObject . Le implementazioni variano a seconda delle operazioni necessarie per l'oggetto dati; in alcuni oggetti dati, l'implementazione di determinati metodi non supportati dall'oggetto potrebbe semplicemente essere la restituzione di E_NOTIMPL. Ad esempio, alcuni oggetti dati non consentono ai chiamanti di inviarli dati. Altri oggetti dati non supportano connessioni consultive e notifiche di modifica. Tuttavia, per gli oggetti dati che supportano le notifiche di modifica, OLE fornisce un oggetto denominato titolare del consiglio dati. Un puntatore di interfaccia a questo titolare è disponibile tramite una chiamata alla funzione helper CreateDataAdviseHolder. Un oggetto dati può avere più connessioni, ognuna con un proprio set di attributi. Il titolare dei dati OLE semplifica l'attività di gestione di queste connessioni e l'invio delle notifiche appropriate.

Ereditarietà

L'interfaccia IDataObject eredita dall'interfaccia IUnknown . IDataObject include anche questi tipi di membri:

Metodi

L'interfaccia IDataObject include questi metodi.

 
IDataObject::D Advise

Chiamato da un oggetto che supporta un sink consigliato per creare una connessione tra un oggetto dati e il sink di avviso. Ciò consente al sink di ricevere una notifica delle modifiche nei dati dell'oggetto.
IDataObject::D Unadvise

Elimina definitivamente una connessione di notifica configurata in precedenza.
IDataObject::EnumDAdvise

Crea un oggetto che può essere usato per enumerare le connessioni consultive correnti.
IDataObject::EnumFormatEtc

Crea un oggetto per enumerare i formati supportati da un oggetto dati.
IDataObject::GetCanonicalFormatEtc

Fornisce una struttura FORMATETC potenzialmente diversa ma logicamente equivalente. Questo metodo consente di determinare se due strutture FORMATETC diverse restituiscono gli stessi dati, eliminando la necessità di eseguire il rendering duplicato.
IDataObject::GetData

Chiamato da un consumer di dati per ottenere dati da un oggetto dati di origine.
IDataObject::GetDataHere

Chiamato da un consumer di dati per ottenere dati da un oggetto dati di origine. Questo metodo differisce dal metodo GetData in quanto il chiamante deve allocare e liberare il supporto di archiviazione specificato.
IDataObject::QueryGetData

Determina se l'oggetto dati è in grado di eseguire il rendering dei dati come specificato. Gli oggetti che tentano un'operazione incolla o di eliminazione possono chiamare questo metodo prima di chiamare IDataObject::GetData per ottenere un'indicazione dell'esito positivo dell'operazione.
IDataObject::SetData

Chiamato da un oggetto contenente un'origine dati per trasferire i dati all'oggetto che implementa questo metodo.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [app desktop | App UWP]
Server minimo supportato Windows 2000 Server [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione objidl.h