Compartilhar via


Função GetNearestPaletteIndex (wingdi.h)

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

Confira também

COLORREF

Funções de cor

Visão geral de cores

Getdevicecaps

GetNearestColor

GetPaletteEntries

Getsystempaletteentries

RGB