COleDataSource::DelayRenderFileData

[アーティクル]
08/09/2011

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

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」を参照してください。