Estructura ENHMETAHEADER (wingdi.h)

La estructura ENHMETAHEADER contiene datos de metarchivo mejorados, como las dimensiones de la imagen almacenada en el metarchivo mejorado, el recuento de registros en el metarchivo mejorado, la resolución del dispositivo en el que se creó la imagen, etc.

Esta estructura es siempre el primer registro de un metarchivo mejorado.

Sintaxis

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;

Miembros

iType

Tipo de registro. Este miembro debe especificar el valor asignado a la constante EMR_HEADER.

nSize

Tamaño de la estructura, en bytes.

rclBounds

Las dimensiones, en unidades de dispositivo, del rectángulo más pequeño que se puede dibujar alrededor de la imagen almacenada en el metarchivo. Este rectángulo lo proporciona la interfaz de dispositivo gráfico (GDI). Sus dimensiones incluyen los bordes derecho e inferior.

rclFrame

Las dimensiones, en unidades .01 milímetros, de un rectángulo que rodea la imagen almacenada en el metarchivo. La aplicación que crea el metarchivo debe proporcionar este rectángulo. Sus dimensiones incluyen los bordes derecho e inferior.

dSignature

Una firma. Este miembro debe especificar el valor asignado a la constante ENHMETA_SIGNATURE.

nVersion

Versión del metarchivo. El valor de la versión actual es 0x10000.

nBytes

Tamaño del metarchivo mejorado, en bytes.

nRecords

Número de registros del metarchivo mejorado.

nHandles

Número de identificadores de la tabla de identificadores de metarchivo mejorado. (El índice cero de esta tabla está reservado).

sReserved

Reservados; debe ser cero.

nDescription

Número de caracteres de la matriz que contiene la descripción del contenido del metarchivo mejorado. Este miembro debe establecerse en cero si el metarchivo mejorado no contiene una cadena de descripción.

offDescription

Desplazamiento desde el principio de la estructura ENHMETAHEADER hasta la matriz que contiene la descripción del contenido del metarchivo mejorado. Este miembro debe establecerse en cero si el metarchivo mejorado no contiene una cadena de descripción.

nPalEntries

Número de entradas en la paleta del metarchivo mejorado.

szlDevice

Resolución del dispositivo de referencia, en píxeles.

szlMillimeters

Resolución del dispositivo de referencia, en milímetros.

cbPixelFormat

Tamaño del último formato de píxel registrado en un metarchivo. Si se establece un formato de píxel en un CONTROLADOR de dominio de referencia al principio de la grabación, cbPixelFormat se establece en el tamaño del PIXELFORMATDESCRIPTOR. Cuando no se establece ningún formato de píxel cuando se registra un metarchivo, este miembro se establece en cero. Si se establece más de un formato de píxel único, el encabezado apunta al último formato de píxel.

offPixelFormat

Desplazamiento del formato de píxel utilizado al grabar un metarchivo. Si se establece un formato de píxel en un controlador de dominio de referencia al principio de la grabación o durante la grabación, offPixelFormat se establece en el desplazamiento del PIXELFORMATDESCRIPTOR en el metarchivo. Si no se establece ningún formato de píxel cuando se registra un metarchivo, este miembro se establece en cero. Si se establece más de un formato de píxel único, el encabezado apunta al último formato de píxel.

bOpenGL

Indica si hay registros openGL presentes en un metarchivo. bOpenGL es una marca booleana sencilla que puede usar para determinar si un metarchivo mejorado requiere el control de OpenGL. Cuando un metarchivo contiene registros OpenGL, bOpenGL es TRUE; de lo contrario, es FALSE.

szlMicrometers

Tamaño del dispositivo de referencia, en micrometros.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	wingdi.h (incluye Windows.h)

Consulte también

ENHMETARECORD

Estructuras de metarchivo

Introducción a los metarchivos

RECTL