GetNearestPaletteIndex-Funktion (wingdi.h)
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 |