Condividi tramite


COleDataSource::CacheData

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.

Requisiti

Header: afxole.h

Vedere anche

Riferimenti

Classe di COleDataSource

Grafico della gerarchia

COleDataSource::CacheGlobalData

COleDataSource::DelayRenderData

COleDataSource::DelayRenderFileData

COleDataSource::SetClipboard

COleDataSource::DoDragDrop