COleControl::OnRenderData

發行項
02/28/2013

呼叫由架構擷取指定之格式的資料。

virtual BOOL OnRenderData(
   LPFORMATETC lpFormatEtc,
   LPSTGMEDIUM lpStgMedium 
);

參數

lpFormatEtc
為指定的所需資訊的格式的 FORMATETC 結構的點。
lpStgMedium
對資料所要傳回的 STGMEDIUM 結構的點。

傳回值

如果不是零，則成功，則為 0。

備註

指定的格式是在控制項物件之前放置一個使用延遲轉譯的 DelayRenderData 或 DelayRenderFileData 成員函式。這個函式呼叫 OnRenderFileData 或 OnRenderGlobalData的預設實作，不同，則為，如果提供的儲存媒體是檔案或記憶體。如果要求的格式是 CF_METAFILEPICT 或保存屬性設定格式，預設實作會呈現適當的資料並傳回非零。否則，它會傳回 0 並進行。

如果 lpStgMedium->tymed 是 TYMED_NULL，應該配置和填滿 STGMEDIUM 由 lpFormatEtc->tymed。如果沒有 TYMED_NULL， STGMEDIUM 應該現用資料並沒有填滿。

覆寫這個函式會提供您在要求的格式、中的資料。根據您的資料，您可能想要覆寫這個函式的其他版本。如果您的資料是小型和大小固定，請覆寫 OnRenderGlobalData。如果您的資料是檔案或為可變大小，請覆寫 OnRenderFileData。

如需詳細資訊，請參閱 Windows SDK的 FORMATETC 和 STGMEDIUM 結構。