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