Función EnumEnhMetaFile (wingdi.h)

Artículo
03/08/2023

La función EnumEnhMetaFile enumera los registros dentro de un metarchivo de formato mejorado recuperando cada registro y pasándolo a la función de devolución de llamada especificada. La función de devolución de llamada proporcionada por la aplicación procesa cada registro según sea necesario. La enumeración continúa hasta que se procesa el último registro o cuando la función de devolución de llamada devuelve cero.

Sintaxis

BOOL EnumEnhMetaFile(
  [in] HDC           hdc,
  [in] HENHMETAFILE  hmf,
  [in] ENHMFENUMPROC proc,
  [in] LPVOID        param,
  [in] const RECT    *lpRect
);

Parámetros

[in] hdc

Identificador de un contexto de dispositivo. Este identificador se pasa a la función de devolución de llamada.

[in] hmf

Identificador de un metarchivo mejorado.

[in] proc

Puntero a la función de devolución de llamada proporcionada por la aplicación. Para obtener más información, vea la función EnhMetaFileProc .

[in] param

Puntero a datos opcionales de función de devolución de llamada.

[in] lpRect

Puntero a una estructura RECT que especifica las coordenadas, en unidades lógicas, de las esquinas superior izquierda e inferior derecha de la imagen.

Valor devuelto

Si la función de devolución de llamada enumera correctamente todos los registros del metarchivo mejorado, el valor devuelto es distinto de cero.

Si la función de devolución de llamada no enumera correctamente todos los registros del metarchivo mejorado, el valor devuelto es cero.

Comentarios

Los puntos a lo largo del borde del rectángulo al que apunta el parámetro lpRect se incluyen en la imagen. Si el parámetro hdc es NULL, el sistema omite lpRect.

Si la función de devolución de llamada llama a la función PlayEnhMetaFileRecord , hdc debe identificar un contexto de dispositivo válido. El sistema usa el modo de transformación y asignación del contexto del dispositivo para transformar la imagen mostrada por la función PlayEnhMetaFileRecord .

Puede usar la función EnumEnhMetaFile para insertar un metarchivo mejorado dentro de otro.

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wingdi.h (incluye Windows.h)
Library	Gdi32.lib
Archivo DLL	Gdi32.dll