Función GetNearestPaletteIndex (wingdi.h)

Artículo
08/27/2023

La función GetNearestPaletteIndex recupera el índice de la entrada de la paleta lógica especificada más estrechamente que coincida con un valor de color especificado.

Sintaxis

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

Parámetros

[in] h

Identificador de una paleta lógica.

[in] color

Color que se va a buscar. Para crear un valor de color COLORREF , use la macro RGB .

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es el índice de una entrada en una paleta lógica.

Si la función no se realiza correctamente, el valor devuelto es CLR_INVALID.

Comentarios

Una aplicación puede determinar si un dispositivo admite operaciones de paleta llamando a la función GetDeviceCaps y especificando la constante RASTERCAPS.

Si la paleta lógica especificada contiene entradas con la marca PC_EXPLICIT establecida, el valor devuelto no está definido.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wingdi.h (incluye Windows.h)
Library	Gdi32.lib
Archivo DLL	Gdi32.dll