COleControl::OnRenderData

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 colocada anteriormente no objeto de controle usando o DelayRenderData or DelayRenderFileData membro funções para renderização posterior.A implementação padrão dessa função chama OnRenderFileData ou OnRenderGlobalData, respectivamente, se a meio de armazenamento fornecido for um arquivo ou memória. Se o formato solicitado é CF_METAFILEPICT ou a propriedade persistent conjunto formato, a implementação padrão processa os dados apropriados e retorna diferente de zero. Caso contrário, retornará 0 e não faz nada.

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

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 FORMATETC and STGMEDIUM estruturas no Windows SDK.

Requisitos

Cabeçalho: afxctl.h

Consulte também

Referência

Classe COleControl

Gráfico de hierarquia

COleControl::OnRenderFileData

COleControl::OnRenderGlobalData

Outros recursos

COleControl membros