COleDataSource::CacheData

Artikel
02/26/2013

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

void CacheData(
   CLIPFORMAT cfFormat,
   LPSTGMEDIUM lpStgMedium,
   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.
lpStgMedium
Zeigt auf STGMEDIUM-Struktur das Speichern der Daten im angegebenen Format.
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

Sie müssen die Daten bereitstellen, da diese Funktion es von der Anwendung des direkten Renderings bereitstellt.Die Daten werden bis zum zwischengespeichert.

Geben Sie die Daten mit einer STGMEDIUM-Struktur.Sie können die CacheGlobalData-Memberfunktion auch verwenden, wenn die Datenmenge, die Sie angeben, so klein ist, mit HGLOBAL effizient übertragen werden.

Nach dem Aufruf von CacheData wird der ptd-Member von lpFormatEtc und der Inhalt von lpStgMedium durch das Datenobjekt, nicht durch den Aufrufer gehören.

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 in STGMEDIUM und FORMATETC-Strukturen in Windows SDK*.*

Weitere Informationen finden Sie unter RegisterClipboardFormat in Windows SDK.