COleDataSource::OnRenderData

Artículo
02/19/2013

Llamado por el marco para recuperar datos en el formato especificado.

virtual BOOL OnRenderData(
   LPFORMATETC lpFormatEtc,
   LPSTGMEDIUM lpStgMedium 
);

Parámetros

lpFormatEtc
Señala la estructura de FORMATETC que especifica el formato en el que se solicita información.
lpStgMedium
Señala una estructura de STGMEDIUM en la que los datos debe volver.

Valor devuelto

Distinto de cero si correctamente; si no 0.

Comentarios

El formato especificado es uno colocado previamente en el objeto de COleDataSource utilizando la función miembro de DelayRenderData o de DelayRenderFileData para generar retrasada.La implementación predeterminada de esta función llamará OnRenderFileData o OnRenderGlobalData si el medio de almacenamiento proporcionado es un archivo o en memoria, respectivamente.Si ninguno de estos formatos se proporcionan, la implementación predeterminada devolverá 0 y no hará nada.Para obtener más información acerca de cómo generar retrasada como controlado por MFC, vea el artículo objetos de datos y orígenes de datos: manipulación.

Si lpStgMedium- >tymed es TYMED_NULL, STGMEDIUM se debe asignar y rellenar según lo especificado por lpformatetc->tymed.Si no es TYMED_NULL, STGMEDIUM se debe rellenar en contexto con los datos.

éste es un overridable avanzado.Invalide esta función para proporcionar los datos en el formato y mediano solicitados.Dependiendo de los datos, puede que desee reemplazar una de las otras versiones de esta función en su lugar.Si los datos pequeño y fijo de tamaño, reemplace OnRenderGlobalData.Si los datos se encuentra en un archivo, o es de tamaño variable, reemplace OnRenderFileData.

Para obtener más información, vea las estructuras de STGMEDIUM y de FORMATETC , el tipo de enumeración de TYMED , y IDataObject::GetData en Windows SDK*.*