FORMATETC

9/8/2008

Essa estrutura é uma formato de Área de Transferência generalizado, aprimorado para abranger um dispositivo destino, o aspecto ou exibição de dados e um meio de armazenamento.

Syntax

typedef struct FARSTRUCT tagFORMATETC {
  unsigned long cfFormat;
  DVTARGETDEVICE* ptd;
  unsigned long dwAspect;
  long lindex;
  unsigned long tymed;
} FORMATETC, *LPFORMATETC;

Os membros

• cfFormat
  Determinado formato de Área de Transferência de interesse.

  Há três tipos de formatos reconhecidos pelo OLE:

  • Formatos intercâmbio padrão, como CF_TEXT
  • Formatos aplicativo particular compreendidos somente pelo aplicativo oferecer o formato ou por outros aplicativos oferecer recursos semelhantes
  • Formatos OLE, que são usados para criar vinculado ou incorporado objetos

• ptd
  Ponteiro para um DVTARGETDEVICE estrutura contendo informações sobre o dispositivo destino para o qual os dados sendo compostos.

  A NULL valor é usado sempre que o formato de dados especificado é independente de dispositivo de destino ou quando o chamador não faz o dispositivo é usado. Em maiúsculas e minúsculas a último, se a dados requer um dispositivo destino, o objeto deve escolher um apropriado dispositivo usar como padrão (geralmente a exibir para os componentes Visual).

  Dados obtidos de um objeto com um NULL dispositivo destino, such as a maioria dos metarquivos, é independente do dispositivo de destino. Os dados resultantes é geralmente o mesmo que seria se o usuário escolheu o comando Salvar como do menu Arquivo e selecionado um formato intercâmbio.

• dwAspect
  Especifica um DVASPECT enumeração constante que indica a quantidade de detalhes devem estar contidas no processamento.

  Um único formato de Área de Transferência pode suporte múltiplo aspectos ou modos de exibição do objeto.

  A maioria dos dados e transferir apresentação e cache informações aspecto transmitir métodos. De exemplo, um chamador pode solicitação um objeto é icônico imagem, usando o formato de Área de Transferência metarquivo para recuperá-lo.

  Apenas um DVASPECT valor pode ser usado em dwAspect. Ou seja, dwAspect não pode ser o resultado de uma operação BOOLEAN OR em vários DVASPECT Os valores.

• lIndex
  Parte de aspecto quando os dados devem ser dividir limites página. The most comum valor é – 1, que identifica todos os dados.

  Para os aspectos DVASPECT_THUMBNAIL e DVASPECT_ICON, lIndex é ignorado.

• tymed
  Uma da TYMED Constantes enumeração que indicam o tipo de meio de armazenamento usados para transferir dados do objeto.

  Dados podem ser transferidos usando qualquer mídia faz sentido para o objeto. De exemplo, dados podem ser passados usando memória global, um arquivo em disco ou armazenamento estruturado objetos. Para obter mais informações, consulte o TYMED enumeração.

Remarks

O FORMATETC estrutura é usada pelos métodos no transferência de dados e interfaces apresentação como um parâmetro especificando os dados que estão sendo transferidos.

O CF_ENHMETAFILE ou CF_METAFILEPICT valores na cfFormat membro não são com suporte.

Requirements

Header	objidl.h
Windows Embedded CE	Windows CE 2.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

DVASPECT
TYMED