Graphics.GetNearestColor-Methode

Ruft die der angegebenen Color-Struktur nächstgelegene Farbe ab.

Namespace: System.Drawing
Assembly: System.Drawing (in system.drawing.dll)

Syntax

'Declaration
Public Function GetNearestColor ( _
    color As Color _
) As Color
'Usage
Dim instance As Graphics
Dim color As Color
Dim returnValue As Color

returnValue = instance.GetNearestColor(color)

public Color GetNearestColor (
    Color color
)

public:
Color GetNearestColor (
    Color color
)

public Color GetNearestColor (
    Color color
)

public function GetNearestColor (
    color : Color
) : Color

Parameter

• color
  Color-Struktur, für die eine Übereinstimmung gesucht werden soll.

Rückgabewert

Eine Color-Struktur, die die nächstgelegene Farbe für die durch den color-Parameter angegebene Farbe darstellt.

Beispiel

Das folgende Codebeispiel ist für die Verwendung mit Windows Forms vorgesehen und erfordert PaintEventArgse, wobei es sich um einen Parameter des Paint-Ereignishandlers handelt. Der Code führt die folgenden Aktionen aus:

• Erstellt willkürlich eine Farbe mit ARGB-Koordinaten (255, 165, 63, 136).

• Erstellt einen einfarbigen Pinsel und legt seine Farbe auf die angegebene Farbe fest.

• Füllt eine Ellipse mit der willkürlich erstellten Farbe.

• Erstellt eine zweite Farbe und legt ihren Wert auf die nächstgelegene ARGB-Farbe im System fest.

• Füllt eine zweite Ellipse mit dieser Farbe.

Das Ergebnis sind zwei Ellipsen: die erste Ellipse ist mit der willkürlich angegebenen Farbe gezeichnet, und die zweite mit der Farbe des Systems, die der angegebenen Farbe am nächsten liegt.

Public Sub GetNearestColorColor(ByVal e As PaintEventArgs)

    ' Create solid brush with arbitrary color.
    Dim arbColor As Color = Color.FromArgb(255, 165, 63, 136)
    Dim arbBrush As New SolidBrush(arbColor)

    ' Fill ellipse on screen.
    e.Graphics.FillEllipse(arbBrush, 0, 0, 200, 100)

    ' Get nearest color.
    Dim realColor As Color = e.Graphics.GetNearestColor(arbColor)
    Dim realBrush As New SolidBrush(realColor)

    ' Fill ellipse on screen.
    e.Graphics.FillEllipse(realBrush, 0, 100, 200, 100)
End Sub

public void GetNearestColorColor(PaintEventArgs e)
{
    // Create solid brush with arbitrary color.
    Color arbColor = Color.FromArgb(255, 165, 63, 136);
    SolidBrush arbBrush = new SolidBrush(arbColor);

    // Fill ellipse on screen.
    e.Graphics.FillEllipse(arbBrush, 0, 0, 200, 100);

    // Get nearest color.
    Color realColor = e.Graphics.GetNearestColor(arbColor);
    SolidBrush realBrush = new SolidBrush(realColor);

    // Fill ellipse on screen.
    e.Graphics.FillEllipse(realBrush, 0, 100, 200, 100);
}

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

Graphics-Klasse
Graphics-Member
System.Drawing-Namespace