COleDataSource::OnRenderFileData

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

更新 : 2007 年 11 月

指定されたストレージメディアがファイルのとき、指定の形式でデータを取得するために、フレームワークが呼び出します。

virtual BOOL OnRenderFileData(
   LPFORMATETC lpFormatEtc,
   CFile* pFile 
);

パラメータ

lpFormatEtc
要求された情報の形式を指定する FORMATETC 構造体へのポインタ。
pFile
データがレンダリングされる CFile オブジェクトへのポインタ。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

この指定形式は、遅延レンダリングするために、DelayRenderData メンバ関数を使用して以前 COleDataSource オブジェクトに指定されたものです。既定の実装は、FALSE を返すだけです。

これは、オーバライド可能な高度な関数です。要求された形式と媒体でデータを提供する場合は、この関数をオーバーライドします。データによっては、この関数の別のバージョンの 1 つをオーバーライドした方がよい場合があります。複数のストレージメディアを処理する場合は、OnRenderData をオーバーライドします。データがファイルにある場合、または可変長の場合は、OnRenderFileData をオーバーライドします。MFC で処理される遅延レンダリングの詳細については、「データオブジェクトとデータソース : 操作」を参照してください。

詳細については、Windows SDK の「IDataObject::GetData」の FORMATETC 構造体の箇所を参照してください。