wingdi.h


GetNearestPaletteIndex

La función GetNearestPaletteIndex devuelve el índice de la entrada de la paleta lógica especificada más parecido al valor de color especificado.

Sintaxis

UINT GetNearestPaletteIndex(
    HPALETTE hpal,    // manipulador de paleta de colores lógica
    COLORREF crColor  // color a comparar
   );

Parámetros

hpal: identifica una paleta de colores lógica.

crColor: especifica un color a comparar.

Valor de retorno

Si la función tiene éxito, el valor de retorno es el índice de la entrada de la paleta lógica.

Si la función falla, el valor de retorno es CLR_INVALID. Para obtener mayor información sobre el error, llamar a GetLastError.

Observaciones

Para determinar si un dispositivo soporta operaciones de paleta se puede usar la función GetDeviceCaps, especificando la constante RASTERCAPS.

Si la paleta lógica dada contiene entradas con el banderín PC_EXPLICIT activo, el valor de retorno queda indefinido.