Clase IDataObjectImpl
Esta clase proporciona métodos para admitir Transferencia de datos uniforme y administrar conexiones.
Importante
Esta clase y sus miembros no se pueden usar en las aplicaciones que se ejecutan en Windows Runtime.
Sintaxis
template<class T>
class IDataObjectImpl
Parámetros
T
La clase, que se deriva de IDataObjectImpl.
Miembros
Métodos públicos
| Nombre | Descripción |
|---|---|
| IDataObjectImpl::DAdvise | Establece una conexión entre el objeto de datos y el receptor de recomendaciones. Esto permite al receptor de recomendaciones recibir notificaciones de cambios en el objeto. |
| IDataObjectImpl::DUnadvise | Finaliza una conexión previamente establecida mediante DAdvise. |
| IDataObjectImpl::EnumDAdvise | Crea un enumerador para recorrer en iteración las conexiones de aviso actuales. |
| IDataObjectImpl::EnumFormatEtc | Crea un enumerador para recorrer en iteración las FORMATETC estructuras admitidas por el objeto de datos. La implementación ATL devuelve E_NOTIMPL. |
| IDataObjectImpl::FireDataChange | Devuelve una notificación de cambio a cada receptor de recomendaciones. |
| IDataObjectImpl::GetCanonicalFormatEtc | Recupera una estructura FORMATETC que es lógicamente equivalente a una más compleja. La implementación ATL devuelve E_NOTIMPL. |
| IDataObjectImpl::GetData | Transfiere datos del objeto de datos al cliente. Los datos se describen en una estructura FORMATETC y se transfieren mediante una estructura STGMEDIUM. |
| IDataObjectImpl::GetDataHere | Es similar a GetData, excepto que el cliente debe asignar la estructura STGMEDIUM. La implementación ATL devuelve E_NOTIMPL. |
| IDataObjectImpl::QueryGetData | Determina si el objeto de datos admite una estructura determinada FORMATETC para transferir datos. La implementación ATL devuelve E_NOTIMPL. |
| IDataObjectImpl::SetData | Transfiere datos del cliente al objeto de datos. La implementación ATL devuelve E_NOTIMPL. |
Comentarios
La interfaz IDataObject proporciona métodos para admitir la Transferencia uniforme de datos. IDataObject usa las estructuras de formato estándar FORMATETC y STGMEDIUM para recuperar y almacenar los datos.
IDataObject también administra las conexiones a los receptores de recomendaciones para controlar las notificaciones de cambio de datos. Para que el cliente reciba notificaciones de cambio de datos del objeto de datos, el cliente debe implementar la interfaz IAdviseSink en un objeto llamado receptor de recomendaciones. Cuando el cliente llama a IDataObject::DAdvise, se establece una conexión entre el objeto de datos y el receptor de recomendaciones.
La clase IDataObjectImpl proporciona una implementación predeterminada de IDataObject e implementa IUnknown mediante el envío de información al dispositivo de volcado de memoria en las compilaciones de depuración.
Artículos relacionados Tutorial de ATL, Creación de un proyecto ATL
Jerarquía de herencia
IDataObject
IDataObjectImpl
Requisitos
Encabezado: atlctl.h
IDataObjectImpl::DAdvise
Establece una conexión entre el objeto de datos y el receptor de recomendaciones.
HRESULT DAdvise(
FORMATETC* pformatetc,
DWORD advf,
IAdviseSink* pAdvSink,
DWORD* pdwConnection);
Comentarios
Esto permite al receptor de recomendaciones recibir notificaciones de cambios en el objeto.
Llame a DUnadvise para finalizar la conexión.
Consulte IDataObject::DAdvise en Windows SDK.
IDataObjectImpl::DUnadvise
Finaliza una conexión previamente establecida mediante DAdvise.
HRESULT DUnadvise(DWORD dwConnection);
Comentarios
Consulte IDataObject::D Unadvise en Windows SDK.
IDataObjectImpl::EnumDAdvise
Crea un enumerador para recorrer en iteración las conexiones de aviso actuales.
HRESULT DAdvise(
FORMATETC* pformatetc,
DWORD advf,
IAdviseSink* pAdvSink,
DWORD* pdwConnection);
Comentarios
Consulte IDataObject::EnumDAdvise en Windows SDK.
IDataObjectImpl::EnumFormatEtc
Crea un enumerador para recorrer en iteración las FORMATETC estructuras admitidas por el objeto de datos.
HRESULT EnumFormatEtc(
DWORD dwDirection,
IEnumFORMATETC** ppenumFormatEtc);
Comentarios
Consulte IDataObject::EnumFormatEtc en Windows SDK.
Valor devuelto
Devuelve E_NOTIMPL.
IDataObjectImpl::FireDataChange
Devuelve una notificación de cambio a cada receptor de recomendaciones que se está administrando actualmente.
HRESULT FireDataChange();
Valor devuelto
Valor HRESULT estándar.
IDataObjectImpl::GetCanonicalFormatEtc
Recupera una estructura FORMATETC que es lógicamente equivalente a una más compleja.
HRESULT GetCanonicalFormatEtc(FORMATETC* pformatetcIn, FORMATETC* pformatetcOut);
Valor devuelto
Devuelve E_NOTIMPL.
Comentarios
Consulte IDataObject::GetCanonicalFormatEtc en Windows SDK.
IDataObjectImpl::GetData
Transfiere datos del objeto de datos al cliente.
HRESULT GetData(
FORMATETC* pformatetcIn,
STGMEDIUM* pmedium);
Comentarios
El parámetro pformatetcIn debe especificar el tipo de medio de almacenamiento TYMED_MFPICT.
Consulte IDataObject::GetData en Windows SDK.
IDataObjectImpl::GetDataHere
Es similar a GetData, excepto que el cliente debe asignar la estructura STGMEDIUM.
HRESULT GetDataHere(
FORMATETC* pformatetc,
STGMEDIUM* pmedium);
Valor devuelto
Devuelve E_NOTIMPL.
Comentarios
Consulte IDataObject::GetDataHere en Windows SDK.
IDataObjectImpl::QueryGetData
Determina si el objeto de datos admite una estructura determinada FORMATETC para transferir datos.
HRESULT QueryGetData(FORMATETC* pformatetc);
Valor devuelto
Devuelve E_NOTIMPL.
Comentarios
Consulte IDataObject::QueryGetData en Windows SDK.
IDataObjectImpl::SetData
Transfiere datos del cliente al objeto de datos.
HRESULT SetData(
FORMATETC* pformatetc,
STGMEDIUM* pmedium,
BOOL fRelease);
Valor devuelto
Devuelve E_NOTIMPL.
Comentarios
Consulte IDataObject::SetData en Windows SDK.