COleDataSource::OnRenderData

Artigo
08/25/2010

Chamado pela estrutura para recuperar dados no formato especificado.

virtual BOOL OnRenderData(
   LPFORMATETC lpFormatEtc,
   LPSTGMEDIUM lpStgMedium 
);

Parâmetros

lpFormatEtc
Aponta para o FORMATETC estrutura especificando o formato no qual as informações são solicitadas.
lpStgMedium
Aponta para um STGMEDIUM estrutura na qual os dados estão a ser retornado.

Valor de retorno

Diferente de zero se bem-sucedida; caso contrário, 0.

Comentários

O formato especificado é um previamente colocado no COleDataSource objeto usando o DelayRenderData or DelayRenderFileDatafunção de membro para renderização posterior.A implementação padrão dessa função chamará OnRenderFileData or OnRenderGlobalData se a meio de armazenamento fornecido for um arquivo ou a memória, respectivamente.Se nenhum desses formatos são fornecidos, a implementação padrão irá retornar 0 e não fazer nada.Para obter mais informações sobre renderização atrasado sistema autônomo manipulado pelo MFC, consulte o artigo Objetos de dados e fontes de dados: Manipulação de.

If lpStgMedium->Tymed is TYMED_NULL, the STGMEDIUM deve ser alocada e preenchida conforme especificado por lpFormatEtc-> tymed.Se não for TYMED_NULL, the STGMEDIUM deve ser preenchido no lugar com os dados.

Esta é uma avançada substituível.Substitua esta função para fornecer seus dados no formato solicitado e meio.Dependendo de seus dados, é aconselhável substituir uma das outras versões dessa função em vez disso.Se os dados forem pequenos e de dimensionar fixo, substituir OnRenderGlobalData. Se seus dados em um arquivo ou é de dimensionar variável, substituir OnRenderFileData.

Para obter mais informações, consulte o STGMEDIUM and FORMATETC estruturas, a TYMED tipo de enumeração de e IDataObject::GetData in the Windows SDK*.*