COleDataSource::CacheData

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

Parámetros

cfFormat

El formato del Portapapeles en que los datos son ofrecidos. Este parámetro puede ser uno de los formatos de Portapapeles predefinidos o el valor devuelto por el nativo de Windows RegisterClipboardFormat función.

lpStgMedium

Apunta a un estructura STGMEDIUM que contiene los datos en el formato especificado.

lpFormatEtc

Apunta a un estructura FORMATETC describir el formato en que los datos son ofrecidos. Proporcionar un valor para este parámetro si desea especificar información de formato adicionales más allá del formato de Portapapeles especificado por cfFormat. Si es NULL, se utilizan los valores predeterminados para los demás campos de la estructura FORMATETC.

Observaciones

Llamar a esta función para especificar un formato en que se ofrecieron datos durante los datos operaciones de transferencia. Debe suministrar los datos, porque esta función lo proporciona mediante procesamiento inmediato. Los datos se almacena en caché hasta que se necesite.

Sumi&nistro de datos mediante un estructura STGMEDIUM . También puede utilizar la función de miembro de CacheGlobalData si la cantidad de datos que se están suministrando es lo suficientemente pequeña como para transferirse eficazmente mediante un .nbsp HGLOBAL;

Después de la llamada a CacheData el miembro DPT de lpFormatEtc y el contenido de lpStgMedium son propiedad del objeto de datos, no por el llamador.

Para utilizar procesamiento retardado, llame a la función miembro DelayRenderData o DelayRenderFileData . Para obtener más información sobre representación tardía como manejados por MFC, vea el artículo los objetos de datos y fuentes de datos: manipulación de en la Guía del programador de Visual C++.

Para obtener más información, consulte el STGMEDIUM y FORMATETC estructuras en la referencia del programador 2 OLE, volumen 1.

Para obtener más información, consulte RegisterClipboardFormat en la documentación de Win32.

I&ntroducción a COleDataSource |nbsp; Miembros de clase | Diagrama de jerarquía

Vea tambié&nnbsp;COleDataSource::CacheGlobalData, COleDataSource::DelayRenderData, COleDataSource::DelayRenderFileData, COleDataSource::SetClipboard, COleDataSource::DoDragDrop

Index