COleDataSource::CacheData

Artykuł
02/27/2013

Wywołanie tej funkcji, aby określić format, w którym dane jest oferowane w danych operacji transferu.

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

Parametry

cfFormat
Format Schowka, w którym dane jest oferowana.Ten parametr może być jedną z wstępnie zdefiniowane formaty Schowka lub wartość zwracana przez macierzysty Windows RegisterClipboardFormat funkcji.
lpStgMedium
Wskazuje na STGMEDIUM struktury zawierającego dane w formacie określonym.
lpFormatEtc
Wskazuje na FORMATETC format, w którym dane oferowana opisujący strukturę.Podać wartość dla tego parametru, jeśli chcesz określić format dodatkowych informacji poza format schowka określonej przez cfFormat.Jeśli jest NULL, używane są wartości domyślne dla innych pól w FORMATETC struktury.

Uwagi

Należy podać danych, ponieważ funkcja ta zapewnia go za pomocą bezpośredniego renderowania.Dane są buforowane aż potrzebne.

Dostarczania danych przy użyciu STGMEDIUM struktury.Można również użyć CacheGlobalData funkcji składowej, jeśli ilość danych dostarczanie jest wystarczająco małe, aby przekazywane skutecznie przy użyciu HGLOBAL.

Po wywołaniu CacheDataptd członek lpFormatEtc i zawartość lpStgMedium są własnością obiektu danych, a nie przez obiekt wywołujący.

Aby użyć renderowania opóźnione, call DelayRenderData lub DelayRenderFileData funkcji składowej.Aby uzyskać więcej informacji o opóźnionych renderowania jako obsługiwany przez MFC, zobacz obiekty danych i źródeł danych: manipulowanie.

Aby uzyskać więcej informacji, zobacz STGMEDIUM i FORMATETC struktur Windows SDK*.*

Aby uzyskać więcej informacji, zobacz RegisterClipboardFormat w Windows SDK.