Função GetEnhMetaFilePaletteEntries (wingdi.h)
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 |