COleDataSource::CacheData

Articolo
02/19/2013

Chiamare la funzione per specificare un formato in cui i dati vengono forniti durante le operazioni di trasferimento dei dati.

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

Parametri

cfFormat
Il formato degli Appunti in cui i dati devono essere disponibili.Questo parametro può essere uno dei formati predefiniti degli Appunti o del valore restituito dalla funzione di Windows RegisterClipboardFormat nativi.
lpStgMedium
I punti su STGMEDIUM struttura contenere dati nel formato specificato.
lpFormatEtc
Punta a una struttura FORMATETC che descrive il formato in cui i dati devono essere disponibili.Immettere un valore per il parametro per specificare informazioni aggiuntive di formato oltre il formato degli Appunti specificato da cfFormat.Se è NULL, vengono utilizzati i valori predefiniti per gli altri campi nella struttura FORMATETC.

Note

È necessario fornire i dati, perché questa funzione fornisce utilizzando il rendering diretto.I dati vengono memorizzati nella cache fino a quando necessario.

Assicurarsi che i dati utilizzando una struttura STGMEDIUM.È inoltre possibile utilizzare la funzione membro CacheGlobalData se la quantità di dati forniti è sufficiente piccola essere trasferita efficiente utilizzando HGLOBAL.

Dopo la chiamata a CacheData il membro ptdlpFormatEtc e il contenuto lpStgMedium sono proprietà dell'oggetto dati, non dal chiamante.

Per utilizzare il rendering ritardato, chiamare la funzione membro DelayRenderFileData o DelayRenderData.Per ulteriori informazioni sul rendering ritardato come gestito da MFC, vedere l'articolo oggetti dati e origini dati: modifica.

Per ulteriori informazioni, vedere le strutture FORMATETC e STGMEDIUM in Windows SDK*.*

Per ulteriori informazioni, vedere RegisterClipboardFormat in Windows SDK.