Función EnumEnhMetaFile (wingdi.h)
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 |