COleControl::OnRenderData
指定された形式でデータを取得するために、フレームワークによって呼び出されます。
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