Compartilhar via


Função GetNearestColor (wingdi.h)

A função GetNearestColor recupera um valor de cor que identifica uma cor da paleta do sistema que será exibida quando o valor de cor especificado for usado.

Sintaxe

COLORREF GetNearestColor(
  [in] HDC      hdc,
  [in] COLORREF color
);

Parâmetros

[in] hdc

Um identificador para o contexto do dispositivo.

[in] color

Um valor de cor que identifica uma cor solicitada. Para criar um valor de cor COLORREF , use a macro RGB .

Retornar valor

Se a função for bem-sucedida, o valor retornado identificará uma cor da paleta do sistema que corresponde ao valor de cor fornecido.

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

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

GetNearestPaletteIndex

RGB