COleControl::OnRenderGlobalData
更新 : 2007 年 11 月
指定されたストレージ メディアがグローバル メモリのとき、指定の形式でデータを取り出すためにフレームワークによって呼び出されます。
virtual BOOL OnRenderGlobalData(
LPFORMATETC lpFormatEtc,
HGLOBAL* phGlobal
);
パラメータ
lpFormatEtc
要求された情報の形式を指定する FORMATETC 構造体へのポインタ。phGlobal
データが返されるグローバル メモリのハンドルへのポインタ。まだメモリが割り当てられていない場合は、このパラメータに NULL を指定できます。
戻り値
正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。
解説
この指定形式は、遅延レンダリングするために、DelayRenderData メンバ関数を使用して以前にコントロール オブジェクトに指定されたものです。既定の実装は、FALSE を返すだけです。
phGlobal が NULL のときは、新しく HGLOBAL を確保し、phGlobal に返します。それ以外の場合は、phGlobal で指定された HGLOBAL にデータが設定されます。HGLOBAL に置かれるデータ量は、メモリ ブロックの現在のサイズを超えることはできません。また、メモリ ブロックをより大きいサイズで再確保することもできません。
要求された形式と媒体でデータを渡す場合は、この関数をオーバーライドします。データによっては、この関数の別のバージョンの 1 つをオーバーライドした方がよい場合があります。複数のストレージ メディアを処理する場合は、OnRenderData をオーバーライドします。データがファイルにある場合、または可変長の場合は、OnRenderFileData をオーバーライドします。
詳細については、Windows SDK の FORMATETC 構造体の説明を参照してください。
必要条件
ヘッダー : afxctl.h