Freigeben über


GetNearestColor-Funktion (wingdi.h)

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

Weitere Informationen

COLORREF

Farbfunktionen

Übersicht über Farben

GetDeviceCaps

GetNearestPaletteIndex

RGB