Función GetEnhMetaFilePaletteEntries (wingdi.h)

Artículo
03/08/2023

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