Função GetEnhMetaFilePaletteEntries (wingdi.h)

Artigo
08/27/2023

A função GetEnhMetaFilePaletteEntries recupera entradas de paleta opcionais do meta-arquivo aprimorado especificado.

Sintaxe

UINT GetEnhMetaFilePaletteEntries(
  [in]  HENHMETAFILE   hemf,
  [in]  UINT           nNumEntries,
  [out] LPPALETTEENTRY lpPaletteEntries
);

Parâmetros

[in] hemf

Um identificador para o metarquivo aprimorado.

[in] nNumEntries

O número de entradas a serem recuperadas da paleta opcional.

[out] lpPaletteEntries

Um ponteiro para uma matriz de estruturas PALETTEENTRY que recebe as cores da paleta. A matriz deve conter pelo menos quantas estruturas houver entradas especificadas pelo parâmetro cEntries .

Valor retornado

Se o ponteiro da matriz for NULL e o meta-arquivo aprimorado contiver uma paleta opcional, o valor retornado será o número de entradas na paleta do meta-arquivo aprimorado; se o ponteiro da matriz for um ponteiro válido e o meta-arquivo aprimorado contiver uma paleta opcional, o valor retornado será o número de entradas copiadas; se o metarquivo não contiver uma paleta opcional, o valor retornado será zero. Caso contrário, o valor retornado será GDI_ERROR.

Comentários

Um aplicativo pode armazenar uma paleta opcional em um meta-arquivo aprimorado chamando as funções CreatePalette e SetPaletteEntries antes de criar a imagem e armazená-la no metarquivo. Ao fazer isso, o aplicativo pode obter cores consistentes quando a imagem é exibida em uma variedade de dispositivos.

Um aplicativo que exibe uma imagem armazenada em um metarquivo aprimorado pode chamar a função GetEnhMetaFilePaletteEntries para determinar se a paleta opcional existe. Se isso acontecer, o aplicativo poderá chamar a função GetEnhMetaFilePaletteEntries uma segunda vez para recuperar as entradas da paleta e, em seguida, criar uma paleta lógica (usando a função CreatePalette ), selecioná-la em seu contexto de dispositivo (usando a função SelectPalette ) e, em seguida, perceber (usando a função RealizePalette ). Depois que a paleta lógica for realizada, chamar a função PlayEnhMetaFile exibirá a imagem usando suas cores originais.

Requisitos


Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wingdi.h (inclua Windows.h)
Biblioteca	Gdi32.lib
DLL	Gdi32.dll