COleControl::OnRenderData

virtual BOOL OnRenderData( LPFORMATETC lpFormatEtc, LPSTGMEDIUM lpStgMedium );

返回值:
如果成功,则返回非零值;否则为0。

参数:
lpFormatEtcFORMATETC结构指针。该结构说明要求信息的格式。
lpStgMedium一个STGMEDIUM结构指针。该结构用于返回数据。

说明:
框架调用以使用指定格式存取数据。指定的格式必须是上次调用DelayRenderData或DelayRenderFileData成员函数放在控件对象中的。缺省实现时,如果支持的存储介质可以是文件或内存,该函数相应地调用OnRenderFileData或OnRenderGlobalData。如果要求的格式是CF_METAFILEPICT或永久性设置格式,该函数显示合适的数据并返回非零值,否则为0,并不做任何事情。
如果lpStgMedium->tymed是TYMED_NULL, STGMEDIUM必须按lpFormatEtc->tymed指定的进行分配和填充。如果不是TYMED_NULL,则STGMEDIUM和数据一起填充。
覆盖该函数以使用指定格式提供数据。根据数据的不同,你必须覆盖该函数的不同版本。如果数据小且尺寸固定,覆盖OnRenderGlobalData。如果数据是一个文件,或者数据是变长的,覆盖OnRenderFileData。
要了解更多的信息,请参阅OLE文档中的FORMATETC和STGMEDIUM结构。

请参阅:
COleControl::OnRenderFileData, COleControl::OnRenderGlobalData