COleDataSource::CacheData
データがデータ転送操作中に用意されている形式を指定するには、この関数を呼び出します。
void CacheData(
CLIPFORMAT cfFormat,
LPSTGMEDIUM lpStgMedium,
LPFORMATETC lpFormatEtc = NULL
);
パラメーター
cfFormat
データが指定されたクリップボード形式。 このパラメーターは、ネイティブな Windows RegisterClipboardFormat の関数によって返される定義済みのクリップボード形式または値の 1 つです。lpStgMedium
STGMEDIUM をポイントし、指定された形式のデータを含むを構成します。lpFormatEtc
データが指定された書式を記述する FORMATETC の構造体へのポインター。 cfFormatで指定されたクリップボード形式を超える追加の書式設定情報を指定する場合は、このパラメーターに値を指定します。 これは nullの場合、既定値は FORMATETC の構造体に他のフィールドに使用されます。
解説
この関数が直接のレンダリングを使用してサービスを提供するため、データを指定する必要があります。 データは必要になるまでキャッシュされます。
STGMEDIUM の構造体を使用してデータを提供します。 ユーザーが入力するデータの量が完全に小さい場合 HGLOBALを使用して効率的に移動するには、CacheGlobalData のメンバー関数を使用できます。
CacheData の呼び出しの後に lpFormatEtc の ptd のメンバーと lpStgMedium の内容は、データ オブジェクトには、呼び出し元が所有されます。
使用するには、レンダリングを遅れましたり DelayRenderData または DelayRenderFileData のメンバー関数を呼び出します。 MFC によって処理される遅延レンダリングの詳細については、" " データのオブジェクトとデータ ソース: 処理を参照してください。
詳細については、Windows SDKの STGMEDIUM と FORMATETC の構造体を参照してください*。*
詳細については、Windows SDKの RegisterClipboardFormat を参照してください。
必要条件
ヘッダー : afxole.h
参照
関連項目
COleDataSource::CacheGlobalData
COleDataSource::DelayRenderData