COleControl::OnRenderData

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

更新 : 2007 年 11 月

指定された形式でデータを取得するために、フレームワークによって呼び出されます。

virtual BOOL OnRenderData(
   LPFORMATETC lpFormatEtc,
   LPSTGMEDIUM lpStgMedium 
);

パラメータ

lpFormatEtc
要求された情報の形式を指定する FORMATETC 構造体へのポインタ。
lpStgMedium
データが返される STGMEDIUM 構造体へのポインタ。

戻り値

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

解説

指定された形式は、遅延レンダリングのために DelayRenderData または DelayRenderFileData メンバ関数を使ってコントロールオブジェクトに以前に置かれたうちの 1 つです。この関数の既定の実装では、指定されたストレージメディアがファイルかメモリかにより、それぞれ OnRenderFileData または OnRenderGlobalData を呼び出します。要求された形式が CF_METAFILEPICT または保存プロパティセット形式のときは、既定の実装は、適切なデータを描画し 0 以外を返します。それ以外の場合は 0 を返し、動作は実行しません。

lpStgMedium->tymed が TYMED_NULL の場合は、STGMEDIUM の領域が確保され、lpFormatEtc->tymed で指定されたように設定されます。TYMED_NULL ではない場合、STGMEDIUM にデータが設定されます。

要求された形式と媒体でデータを渡す場合は、この関数をオーバーライドします。データによっては、この関数の別のバージョンの 1 つをオーバーライドした方がよい場合があります。データのサイズが小さく、固定長の場合は、OnRenderGlobalData をオーバーライドします。データがファイルにある場合、または可変長の場合は、OnRenderFileData をオーバーライドします。

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