COleDataSource::DelayRenderFileData

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

データ転送操作のときに提供されるデータの形式を指定します。

void DelayRenderFileData(
   CLIPFORMAT cfFormat,
   LPFORMATETC lpFormatEtc = NULL 
);

パラメータ

cfFormat
提供されるデータのクリップボード形式。このパラメータには、定義済みのクリップボード形式、または Windows ネイティブの RegisterClipboardFormat 関数が返す値を指定できます。
lpFormatEtc
提供されるデータの形式を示す FORMATETC 構造体へのポインタ。cfFormat で指定されたクリップボード形式に追加の形式情報を指定するときは、このパラメータを指定します。パラメータが NULL のときは、FORMATETC 構造体のほかのフィールドには既定の値が使われます。

解説

この関数は、遅延レンダリングを使ってデータを提供するので、データは同時には渡しません。データを要求するために、OnRenderFileData メンバ関数が呼び出されます。

CFile オブジェクトを使ってデータを渡す場合は、この関数を使います。CFile オブジェクトを使ってデータを渡さない場合は、DelayRenderData メンバ関数を呼び出します。MFC で処理される遅延レンダリングの詳細については、「データオブジェクトとデータソース : 操作」を参照してください。

即時レンダリングを使うには、CacheData メンバ関数または CacheGlobalData メンバ関数を呼び出します。

詳細については、Windows SDK の FORMATETC 構造体の説明を参照してください。

詳細については、Windows SDK の「RegisterClipboardFormat」を参照してください。