Función GetEnhMetaFilePaletteEntries (wingdi.h)
La función GetEnhMetaFilePaletteEntries recupera entradas de paleta opcionales del metarchivo mejorado especificado.
Sintaxis
UINT GetEnhMetaFilePaletteEntries(
[in] HENHMETAFILE hemf,
[in] UINT nNumEntries,
[out] LPPALETTEENTRY lpPaletteEntries
);
Parámetros
[in] hemf
Identificador del metarchivo mejorado.
[in] nNumEntries
Número de entradas que se van a recuperar de la paleta opcional.
[out] lpPaletteEntries
Puntero a una matriz de estructuras PALETTEENTRY que recibe los colores de la paleta. La matriz debe contener al menos tantas estructuras como haya entradas especificadas por el parámetro cEntries .
Valor devuelto
Si el puntero de matriz es NULL y el metarchivo mejorado contiene una paleta opcional, el valor devuelto es el número de entradas de la paleta del metarchivo mejorado; si el puntero de matriz es un puntero válido y el metarchivo mejorado contiene una paleta opcional, el valor devuelto es el número de entradas copiadas; si el metarchivo no contiene una paleta opcional, el valor devuelto es cero. De lo contrario, el valor devuelto es GDI_ERROR.
Comentarios
Una aplicación puede almacenar una paleta opcional en un metarchivo mejorado llamando a las funciones CreatePalette y SetPaletteEntries antes de crear la imagen y almacenarla en el metarchivo. Al hacerlo, la aplicación puede lograr colores coherentes cuando la imagen se muestra en una variedad de dispositivos.
Una aplicación que muestra una imagen almacenada en un metarchivo mejorado puede llamar a la función GetEnhMetaFilePaletteEntries para determinar si existe la paleta opcional. Si lo hace, la aplicación puede llamar a la función GetEnhMetaFilePaletteEntries una segunda vez para recuperar las entradas de la paleta y, a continuación, crear una paleta lógica (mediante la función CreatePalette ), seleccionarla en su contexto de dispositivo (mediante la función SelectPalette ) y, a continuación, darse cuenta de ella (mediante la función RealizePalette ). Una vez realizada la paleta lógica, al llamar a la función PlayEnhMetaFile se muestra la imagen con sus colores originales.
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 |