COleDataSource:: CacheData

privatevoid CacheData ( CLIPFORMAT cfFormat, LPSTGMEDIUM lpStgMedium, LPFORMATETC lpFormatEtc = Nulo );

Parâmetros

cfFormat

O formato de área de transferência na qual os dados são para ser oferecido. Este parâmetro pode ser um dos formatos da área de transferência predefinidos ou o valor retornado pelo Windows nativo RegisterClipboardFormat função.

lpStgMedium

Aponta para um STGMEDIUM estrutura contendo os dados no formato especificado.

lpFormatEtc

Aponta para um FORMATETC estrutura que descreve o formato no qual os dados são para ser oferecido. Fornece um valor para esse parâmetro se desejar especificar informações de formato adicionais além o formato de área de transferência especificado por cfFormat. Se for NULL, os valores padrão são usados para os outros campos na estrutura de FORMATETC.

Observações

Chame essa função para especificar um Formatarar no qual dados são oferecidos durante dados operações de transferência. Você deve fornecer os dados, porque essa função fornece-lo usando processamento imediato. Os dados são armazenados em cache até que sejam necessários.

For&necer os dados usando um estrutura de STGMEDIUM . Você também pode usar a função de membro CacheGlobalData se a quantidade de dados que você está fornecendo é pequena o suficiente para ser transferido com eficiência usando um HGLOBAL.nbsp;

Após a chamada CacheData o membro ptd lpFormatEtc e o conteúdo de lpStgMedium pertencem pelo objeto de dados, não pelo chamador.

Para usar processamento atrasado, chame a função de membro DelayRenderData ou DelayRenderFileData . Para obter mais informações sobre processamento atrasado como tratados pelo MFC, consulte o artigo objetos de dados e fontes de dados: manipulação no Guia do programador do Visual C++.

Para obter mais informações, consulte o STGMEDIUM e estruturas de FORMATETC o referência OLE 2 Programmer, Volume 1.

Para obter mais informações, consulte RegisterClipboardFormat na documentação do Win32.

Visão geral de COleDataSourceMembros de classe | Gráfico de hierarquia

Co&nsulte tambémnbsp;COleDataSource:: CacheGlobalData, COleDataSource:: DelayRenderData, COleDataSource::DelayRenderFileData, COleDataSource::SetClipboard, COleDataSource:: DoDragDrop

Index