GetNearestPaletteIndex-Funktion (wingdi.h)

Artikel
03/04/2024

Die GetNearestPaletteIndex-Funktion ruft den Index für den Eintrag in der angegebenen logischen Palette ab, die einem angegebenen Farbwert am ehesten entspricht.

Syntax

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

Parameter

[in] h

Ein Handle für eine logische Palette.

[in] color

Eine Farbe, die abgeglichen werden soll. Verwenden Sie das RGB-Makro, um einen COLORREF-Farbwert zu erstellen.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert der Index eines Eintrags in einer logischen Palette.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert CLR_INVALID.

Hinweise

Eine Anwendung kann ermitteln, ob ein Gerät Palettenvorgänge unterstützt, indem sie die GetDeviceCaps-Funktion aufruft und die RASTERCAPS-Konstante angibt.

Wenn die angegebene logische Palette Einträge enthält, deren flag PC_EXPLICIT festgelegt ist, ist der Rückgabewert nicht definiert.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wingdi.h (windows.h einschließen)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll