Função AnimatePalette (wingdi.h)

Artigo
03/08/2023

A função AnimatePalette substitui entradas na paleta lógica especificada.

Sintaxe

BOOL AnimatePalette(
  [in] HPALETTE           hPal,
  [in] UINT               iStartIndex,
  [in] UINT               cEntries,
  [in] const PALETTEENTRY *ppe
);

Parâmetros

[in] hPal

Um identificador para a paleta lógica.

[in] iStartIndex

A primeira entrada de paleta lógica a ser substituída.

[in] cEntries

O número de entradas a serem substituídas.

[in] ppe

Um ponteiro para o primeiro membro em uma matriz de estruturas PALETTEENTRY usadas para substituir as entradas atuais.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero.

Comentários

Um aplicativo pode determinar se um dispositivo dá suporte a operações de paleta chamando a função GetDeviceCaps e especificando a constante RASTERCAPS.

A função AnimatePalette altera apenas as entradas com o sinalizador PC_RESERVED definido no membro palPalEntry correspondente da estrutura LOGPALETTE .

Se a paleta fornecida estiver associada à janela ativa, as cores na paleta serão substituídas imediatamente.

Requisitos

Requisito	Valor
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