COleDataSource::CacheData

Artículo
02/19/2013

Llame a esta función para especificar un formato en el que los datos se proporcione durante las operaciones de transferencia de datos.

void CacheData(
   CLIPFORMAT cfFormat,
   LPSTGMEDIUM lpStgMedium,
   LPFORMATETC lpFormatEtc = NULL 
);

Parámetros

cfFormat
El formato del Portapapeles en el que los datos debe ser proporcionado.Este parámetro puede tener uno de los formatos de Portapapeles predefinidos o el valor devuelto por la función de Windows RegisterClipboardFormat nativo.
lpStgMedium
Señala una estructura de STGMEDIUM que contiene los datos en el formato especificado.
lpFormatEtc
Señala una estructura de FORMATETC que describe el formato en el que los datos debe ser proporcionado.Proporcione un valor para este parámetro si desea especificar la información de formato adicional más allá del formato del Portapapeles especificado por cfFormat.Si es NULL, los valores predeterminados que se utilizan para los demás campos en la estructura de FORMATETC .

Comentarios

Debe proporcionar los datos, porque esta función se proporciona mediante la presentación inmediata.Se almacena en caché los datos hasta que se necesite.

Proporcione los datos utilizando una estructura de STGMEDIUM .También puede utilizar la función miembro de CacheGlobalData si la cantidad de datos que está proporcionando es lo suficientemente pequeño para transferido eficazmente mediante HGLOBAL.

Después de la llamada a CacheData el objeto de datos, no por el llamador poseen el miembro de ptd de lpFormatEtc y el contenido de lpStgMedium .

Para utilizar retardó la generación, llama a funciones miembro de DelayRenderData o de DelayRenderFileData .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.

Para obtener más información, vea las estructuras de STGMEDIUM y de FORMATETC en Windows SDK*.*

Para obtener más información, vea RegisterClipboardFormat en Windows SDK.