GetNearestColor-Funktion (wingdi.h)

Artikel
03/04/2024

Die GetNearestColor-Funktion ruft einen Farbwert ab, der eine Farbe aus der Systempalette identifiziert, die angezeigt wird, wenn der angegebene Farbwert verwendet wird.

Syntax

COLORREF GetNearestColor(
  [in] HDC      hdc,
  [in] COLORREF color
);

Parameter

[in] hdc

Ein Handle für den Gerätekontext.

[in] color

Ein Farbwert, der eine angeforderte Farbe identifiziert. Verwenden Sie das RGB-Makro, um einen COLORREF-Farbwert zu erstellen.

Rückgabewert

Wenn die Funktion erfolgreich ist, identifiziert der Rückgabewert eine Farbe aus der Systempalette, die dem angegebenen Farbwert entspricht.

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

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