Funzione GetNearestPaletteIndex (wingdi.h)

La funzione GetNearestPaletteIndex recupera l'indice per la voce nella tavolozza logica specificata più strettamente corrispondente a un valore di colore specificato.

Sintassi

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

Parametri

[in] h

Handle in una tavolozza logica.

[in] color

Colore da abbinare. Per creare un valore di colore COLORREF , usare la macro RGB .

Valore restituito

Se la funzione ha esito positivo, il valore restituito è l'indice di una voce in una tavolozza logica.

Se la funzione ha esito negativo, il valore restituito è CLR_INVALID.

Commenti

Un'applicazione può determinare se un dispositivo supporta le operazioni del tavolozza chiamando la funzione GetDeviceCaps e specificando la costante RASTERCAPS.

Se il riquadro logico specificato contiene voci con il flag PC_EXPLICIT impostato, il valore restituito non è definito.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione wingdi.h (include Windows.h)
Libreria Gdi32.lib
DLL Gdi32.dll

Vedi anche

COLORREF

Funzioni colore

Panoramica dei colori

GetDeviceCaps

GetNearestColor

GetPaletteEntries

GetSystemPaletteEntries

RGB