Interfaz IDataObject (objidl.h)
Habilita la transferencia de datos y la notificación de cambios en los datos. Los métodos de transferencia de datos especifican el formato de los datos transferidos junto con el medio a través del cual se van a transferir los datos. Opcionalmente, los datos se pueden representar para un dispositivo de destino específico. Además de los métodos para recuperar y almacenar datos, la interfaz IDataObject especifica métodos para enumerar formatos disponibles y administrar conexiones a receptores de asesoramiento para controlar las notificaciones de cambios.
El término objeto de datos se usa para significar cualquier objeto que admita una implementación de la interfaz IDataObject . Las implementaciones varían, en función de lo que se requiera para hacer el objeto de datos; en algunos objetos de datos, la implementación de ciertos métodos no admitidos por el objeto podría ser simplemente el retorno de E_NOTIMPL. Por ejemplo, algunos objetos de datos no permiten a los llamadores enviarlos datos. Otros objetos de datos no admiten conexiones de asesoramiento ni notificaciones de cambio. Sin embargo, para los objetos de datos que admiten notificaciones de cambios, OLE proporciona un objeto denominado titular de aviso de datos. Un puntero de interfaz a este titular está disponible a través de una llamada a la función auxiliar CreateDataAdviseHolder. Un objeto de datos puede tener varias conexiones, cada una con su propio conjunto de atributos. El titular del asesor de datos OLE simplifica la tarea de administrar estas conexiones y enviar las notificaciones adecuadas.
Herencia
La interfaz IDataObject hereda de la interfaz IUnknown . IDataObject también tiene estos tipos de miembros:
Métodos
La interfaz IDataObject tiene estos métodos.
| IDataObject::D Advise Lo llama un objeto que admite un receptor de aviso para crear una conexión entre un objeto de datos y el receptor de aviso. Esto permite notificar al receptor de asesoramiento los cambios en los datos del objeto. |
| IDataObject::D Unadvise Destruye una conexión de notificación que se había configurado anteriormente. |
| IDataObject::EnumDAdvise Crea un objeto que se puede utilizar para enumerar las conexiones de consulta actuales. |
| IDataObject::EnumFormatEtc Crea un objeto para enumerar los formatos admitidos por un objeto de datos. |
| IDataObject::GetCanonicalFormatEtc Proporciona una estructura FORMATETC potencialmente diferente pero lógicamente equivalente. Use este método para determinar si dos estructuras FORMATETC diferentes devolverían los mismos datos, lo que elimina la necesidad de representación duplicada. |
| IDataObject::GetData Lo llama un consumidor de datos para obtener datos de un objeto de datos de origen. |
| IDataObject::GetDataHere Lo llama un consumidor de datos para obtener datos de un objeto de datos de origen. Este método difiere del método GetData en que el autor de la llamada debe asignar y liberar el medio de almacenamiento especificado. |
| IDataObject::QueryGetData Determina si el objeto de datos es capaz de representar los datos según lo especificado. Los objetos que intentan realizar una operación de pegado o colocar pueden llamar a este método antes de llamar a IDataObject::GetData para obtener una indicación de si la operación puede ser correcta. |
| IDataObject::SetData Llamado por un objeto que contiene un origen de datos para transferir datos al objeto que implementa este método. |
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP] |
| Servidor mínimo compatible | Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP] |
| Plataforma de destino | Windows |
| Encabezado | objidl.h |