COleDataSource::CacheData

Artigo
08/25/2010

telefonar Esta função para especificar um formato em que dados são oferecidos durante dados operações de transferência.

void CacheData(
   CLIPFORMAT cfFormat,
   LPSTGMEDIUM lpStgMedium,
   LPFORMATETC lpFormatEtc = NULL 
);

Parâmetros

cfFormat
O formato da área de transferência na qual os dados são ser oferecida.Esse parâmetro pode ser um dos formatos predefinidos de área de transferência ou o valor retornado pelo Windows nativo RegisterClipboardFormat função.
lpStgMedium
Aponta para um STGMEDIUM estrutura que contém os dados no formato especificado.
lpFormatEtc
Aponta para um FORMATETC estrutura que descreve o formato no qual os dados são ser oferecida.Fornecer um valor para esse parâmetro se desejar especificar as informações de formato adicionais além o formato da área de transferência especificado por cfFormat. Se for NULO, valores padrão são usados para outros campos no FORMATETC estrutura.

Comentários

Você deve fornecer os dados, porque essa função fornece-la usando renderização imediato.Os dados armazenados em cache até que seja necessário.

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

Após a telefonar para CacheData o PTD membro lpFormatEtc e o Sumário de lpStgMedium são de propriedade do objeto de dados, não pelo chamador.

Para usar o renderização atrasado, chame o DelayRenderData or DelayRenderFileDatafunção de membro .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.

Para obter mais informações, consulte o STGMEDIUM and FORMATETC estruturas no Windows SDK*.*

Para obter mais informações, consulte RegisterClipboardFormat in the Windows SDK.