Estrutura ENHMETAHEADER (wingdi.h)

A estrutura ENHMETAHEADER contém dados avançados de meta-arquivo, como as dimensões da imagem armazenada no meta-arquivo aprimorado, a contagem de registros no metarquivo aprimorado, a resolução do dispositivo no qual a imagem foi criada e assim por diante.

Essa estrutura é sempre o primeiro registro em um meta-arquivo aprimorado.

Sintaxe

typedef struct tagENHMETAHEADER {
  DWORD iType;
  DWORD nSize;
  RECTL rclBounds;
  RECTL rclFrame;
  DWORD dSignature;
  DWORD nVersion;
  DWORD nBytes;
  DWORD nRecords;
  WORD  nHandles;
  WORD  sReserved;
  DWORD nDescription;
  DWORD offDescription;
  DWORD nPalEntries;
  SIZEL szlDevice;
  SIZEL szlMillimeters;
  DWORD cbPixelFormat;
  DWORD offPixelFormat;
  DWORD bOpenGL;
  SIZEL szlMicrometers;
} ENHMETAHEADER, *PENHMETAHEADER, *LPENHMETAHEADER;

Membros

iType

O tipo de registro. Esse membro deve especificar o valor atribuído à constante EMR_HEADER.

nSize

O tamanho da estrutura, em bytes.

rclBounds

As dimensões, em unidades de dispositivo, do menor retângulo que pode ser desenhado em torno da imagem armazenada no metarquivo. Esse retângulo é fornecido pela GDI (interface gráfica do dispositivo). Suas dimensões incluem as bordas direita e inferior.

rclFrame

As dimensões, em unidades de .01 milímetros, de um retângulo que envolve a imagem armazenada no metarquivo. Esse retângulo deve ser fornecido pelo aplicativo que cria o metarquivo. Suas dimensões incluem as bordas direita e inferior.

dSignature

Uma assinatura. Esse membro deve especificar o valor atribuído à constante ENHMETA_SIGNATURE.

nVersion

A versão do metarquivo. O valor da versão atual é 0x10000.

nBytes

O tamanho do meta-arquivo aprimorado, em bytes.

nRecords

O número de registros no metarquivo aprimorado.

nHandles

O número de identificadores na tabela de identificadores enhanced-metafile. (O índice zero nesta tabela é reservado.)

sReserved

Reservados; deve ser zero.

nDescription

O número de caracteres na matriz que contém a descrição do conteúdo do metarquivo aprimorado. Esse membro deverá ser definido como zero se o metafile aprimorado não contiver uma cadeia de caracteres de descrição.

offDescription

O deslocamento do início da estrutura ENHMETAHEADER para a matriz que contém a descrição do conteúdo do metarquivo aprimorado. Esse membro deverá ser definido como zero se o metafile aprimorado não contiver uma cadeia de caracteres de descrição.

nPalEntries

O número de entradas na paleta do metarquivo aprimorado.

szlDevice

A resolução do dispositivo de referência, em pixels.

szlMillimeters

A resolução do dispositivo de referência, em milímetros.

cbPixelFormat

O tamanho do último formato de pixel registrado em um metarquivo. Se um formato de pixel for definido em um DC de referência no início da gravação, cbPixelFormat será definido como o tamanho do PIXELFORMATDESCRIPTOR. Quando nenhum formato de pixel é definido quando um metarquivo é gravado, esse membro é definido como zero. Se mais de um único formato de pixel for definido, o cabeçalho apontará para o último formato de pixel.

offPixelFormat

O deslocamento do formato de pixel usado ao gravar um meta-arquivo. Se um formato de pixel for definido em um DC de referência no início da gravação ou durante a gravação, offPixelFormat será definido como o deslocamento do PIXELFORMATDESCRIPTOR no metarquivo. Se nenhum formato de pixel for definido quando um metarquivo for gravado, esse membro será definido como zero. Se mais de um único formato de pixel for definido, o cabeçalho apontará para o último formato de pixel.

bOpenGL

Indica se algum registro OpenGL está presente em um metarquivo. bOpenGL é um sinalizador booliano simples que você pode usar para determinar se um meta-arquivo aprimorado requer manipulação de OpenGL. Quando um metarquivo contém registros OpenGL, bOpenGL é TRUE; caso contrário, será FALSE.

szlMicrometers

O tamanho do dispositivo de referência, em micrometers.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho	wingdi.h (inclua Windows.h)

Confira também

ENHMETARECORD

Estruturas de metarquivo

Visão geral dos metafiles

RECTL