Estrutura FORMATETC (objidl.h)
Representa um formato de área de transferência generalizado. Ele é aprimorado para abranger um dispositivo de destino, o aspecto ou a exibição dos dados e um indicador médio de armazenamento. Quando se pode esperar encontrar um formato de área de transferência, o OLE usa uma estrutura de dados FORMATETC . Essa estrutura é usada como um parâmetro em funções E métodos OLE que exigem informações de formato de dados.
Sintaxe
typedef struct tagFORMATETC {
CLIPFORMAT cfFormat;
DVTARGETDEVICE *ptd;
DWORD dwAspect;
LONG lindex;
DWORD tymed;
} FORMATETC, *LPFORMATETC;
Membros
cfFormat
O formato de interesse da área de transferência. Há três tipos de formatos reconhecidos pelo OLE:
- Formatos de intercâmbio padrão, como CF_TEXT.
- Formatos de aplicativo privado compreendidos apenas pelo aplicativo que oferece o formato ou por outros aplicativos que oferecem recursos semelhantes.
- Formatos OLE, que são usados para criar objetos vinculados ou inseridos.
ptd
Um ponteiro para uma estrutura DVTARGETDEVICE que contém informações sobre o dispositivo de destino para o qual os dados estão sendo compostos. Um valor NULL é usado sempre que o formato de dados especificado é independente do dispositivo de destino ou quando o chamador não se importa com qual dispositivo é usado. No último caso, se os dados exigirem um dispositivo de destino, o objeto deverá escolher um dispositivo padrão apropriado (geralmente a exibição para componentes visuais). Os dados obtidos de um objeto com um dispositivo de destino NULL , como a maioria dos metarquivos, são independentes do dispositivo de destino. Os dados resultantes geralmente são os mesmos que seriam se o usuário escolhesse o comando Salvar como no menu Arquivo e selecionasse um formato de intercâmbio.
dwAspect
Indica quantos detalhes devem ser contidos na renderização. Esse parâmetro deve ser um dos valores de enumeração DVASPECT . Um único formato de área de transferência pode dar suporte a vários aspectos ou exibições do objeto. A maioria dos métodos de transferência e cache de dados e apresentação passa informações de aspecto. Por exemplo, um chamador pode solicitar a imagem icônica de um objeto, usando o formato da área de transferência de metarquivo para recuperá-la. Observe que apenas um valor DVASPECT pode ser usado em dwAspect. Ou seja, dwAspect não pode ser o resultado de uma operação OR booliana em vários valores DVASPECT .
lindex
Parte do aspecto quando os dados devem ser divididos entre limites de página. O valor mais comum é -1, que identifica todos os dados. Para os aspectos DVASPECT_THUMBNAIL e DVASPECT_ICON, lindex é ignorado.
tymed
Uma das constantes de enumeração TYMED que indicam o tipo de meio de armazenamento usado para transferir os dados do objeto. Os dados podem ser transferidos usando qualquer meio que faça sentido para o objeto . Por exemplo, os dados podem ser passados usando memória global, um arquivo de disco ou objetos de armazenamento estruturados. Para obter mais informações, consulte a enumeração TYMED .
Comentários
A estrutura FORMATETC é usada por métodos nas interfaces de transferência de dados e apresentação como um parâmetro que especifica os dados que estão sendo transferidos. Por exemplo, o método IDataObject::GetData usa a estrutura FORMATETC para indicar exatamente que tipo de dados o chamador está solicitando.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP] |
| Cabeçalho | objidl.h |