COleDataSource::CacheData

Artigo
02/25/2013

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

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

Parâmetros

cfFormat
O formato da área de transferência em que os dados devem ser oferecidos.Este parâmetro pode ser um dos formatos predefinidos da área de transferência ou do valor retornado pela função nativo de RegisterClipboardFormat do windows.
lpStgMedium
Os pontos a STGMEDIUM a estrutura contendo de dados no formato especificado.
lpFormatEtc
Pontos a estrutura de FORMATETC que descreve o formato em que os dados devem ser oferecidos.Fornecer um valor para este parâmetro se você desejar especificar informações extras de formato além de formato da área de transferência especificado por cfFormat.Se é NULO, os valores padrão são usadas para os outros campos na estrutura de FORMATETC .

Comentários

Você deve fornecer os dados, porque esta função o fornece usando renderização imediata.Os dados são armazenados em cache até necessário.

Fornecer dados usando uma estrutura de STGMEDIUM .Você também pode usar a função de membro de CacheGlobalData se a quantidade de dados que você está fornecendo é muito pequena ser transferida com eficiência usando HGLOBAL.

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

Para usar atrasou processar, chama a função de membro de DelayRenderData ou de DelayRenderFileData .Para obter mais informações sobre o processamento de tarde como tratado pelo MFC, consulte o artigo objetos de dados e fontes de dados: Tratamento.

Para obter mais informações, consulte as estruturas de STGMEDIUM e de FORMATETC em Windows SDK*.*

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