Freigeben über


COleDataSource::CacheGlobalData

Rufen Sie diese Funktion auf, um ein Format angeben, in dem Daten während der Datenübertragungsvorgänge bereitgestellt werden.

void CacheGlobalData( 
   CLIPFORMAT cfFormat, 
   HGLOBAL hGlobal, 
   LPFORMATETC lpFormatEtc = NULL  
);

Parameter

  • cfFormat
    Das Zwischenablageformat, in dem die Daten bereitgestellt werden sollen. Dieser Parameter kann einer der vordefinierten Zwischenablageformate oder einen Wert sein, der von der Funktion systemeigene Windows RegisterClipboardFormat zurückgegeben werden.

  • hGlobal
    Handle im globalen Speicherblock, der die Daten im Format angegeben enthält.

  • lpFormatEtc
    zeigt auf eine FORMATETC-Struktur, die das Format beschreibt, in dem die Daten bereitgestellt werden sollen. Erstellen Sie einen Wert für diesen Parameter bereit, wenn Sie zusätzliche Formatinformationen über dem Zwischenablageformat hinaus angeben möchten, das von cfFormat angegeben wird. Wenn es NULL ist, werden Standardwerte für die anderen Felder in der FORMATETC-Struktur verwendet.

Hinweise

Diese Funktion stellt die Daten mithilfe des direkten Rendering bereit, müssen Sie die Daten bereitstellen, wenn Sie die Funktion aufrufen, die Daten werden bis zum zwischengespeichert. Verwenden Sie die CacheData-Memberfunktion, wenn Sie eine große Datenmenge angeben, oder Sie ein strukturiertes Speichermedium benötigen.

Um verzögertes Rendern zu verwenden, rufen Sie die DelayRenderData oder DelayRenderFileData-Memberfunktion auf. Weitere Informationen zum verzögerten Rendering, wie von MFC behandelt werden, finden Sie im Artikel Datenobjekte und Datenquellen: Manipulation.

Weitere Informationen finden Sie unter FORMATETC die Struktur in Windows SDK*.*

Weitere Informationen finden Sie unter RegisterClipboardFormat in Windows SDK.

Anforderungen

Header: afxole.h

Siehe auch

Referenz

COleDataSource-Klasse

Hierarchiediagramm

COleDataSource::CacheData

COleDataSource::DelayRenderData

COleDataSource::DelayRenderFileData