Função GetNearestPaletteIndex (wingdi.h)

Artigo
03/04/2024

A função GetNearestPaletteIndex recupera o índice da entrada na paleta lógica especificada que corresponde mais de perto a um valor de cor especificado.

Sintaxe

UINT GetNearestPaletteIndex(
  [in] HPALETTE h,
  [in] COLORREF color
);

Parâmetros

[in] h

Um identificador para uma paleta lógica.

[in] color

Uma cor a ser correspondida. Para criar um valor de cor COLORREF , use a macro RGB .

Retornar valor

Se a função for bem-sucedida, o valor retornado será o índice de uma entrada em uma paleta lógica.

Se a função falhar, o valor de retorno será CLR_INVALID.

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.

Se a paleta lógica fornecida contiver entradas com o sinalizador PC_EXPLICIT definido, o valor retornado será indefinido.

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