Partilhar via


COleControl::OnRenderGlobalData

Chamado pela estrutura para recuperar dados no formato especificado quando o meio de armazenamento especificado é memória global.

virtual BOOL OnRenderGlobalData(
   LPFORMATETC lpFormatEtc,
   HGLOBAL* phGlobal 
);

Parâmetros

  • lpFormatEtc
    Pontos a estrutura de FORMATETC que especifica o formato em que a informação é solicitada.

  • phGlobal
    Aponta para um identificador para a memória global em que os dados serão retornado.Se nenhuma memória foi atribuído, este parâmetro pode ser NULO.

Valor de retorno

Diferente de zero se com êxito; se não 0.

Comentários

O formato especificado é um colocado anteriormente no objeto do controle usando a função de membro de DelayRenderData para processar tarde.A implementação padrão de essa função retorna apenas Falso.

Se phGlobal é NULO, então novo HGLOBAL deve ser atribuído e retornado em phGlobal.Caso contrário, HGLOBAL especificado por phGlobal deve ser preenchido com dados.A quantidade de dados colocados em HGLOBAL não pode exceder o tamanho atual do bloco de memória.Além de isso, o bloco não pode ser realocado para um tamanho maior.

Substituir essa função para fornecer os dados no formato e entre aplicativos.Dependendo dos dados, você pode querer substituir o invés de uma das outras versões de essa função.Se você desejar manipular vários meios de memória, substitua OnRenderData.Se seus dados estão em um arquivo, ou são de tamanho variável, substitua OnRenderFileData.

Para obter mais informações, consulte a estrutura de FORMATETC em Windows SDK.

Requisitos

Cabeçalho: afxctl.h

Consulte também

Referência

Classe de COleControl

Gráfico de hierarquia

COleControl::OnRenderFileData

COleControl::OnRenderData