COleControl::OnRenderData
更新 : 2007 年 11 月
指定された形式でデータを取得するために、フレームワークによって呼び出されます。
virtual BOOL OnRenderData(
LPFORMATETC lpFormatEtc,
LPSTGMEDIUM lpStgMedium
);
パラメータ
戻り値
正常終了した場合は 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 構造体を参照してください。
必要条件
ヘッダー : afxctl.h
参照
参照
COleControl::OnRenderGlobalData