Freigeben über


Color.FromName-Methode

Erstellt eine Color-Struktur aus dem angegebenen Namen einer vordefinierten Farbe.

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

Syntax

'Declaration
Public Shared Function FromName ( _
    name As String _
) As Color
'Usage
Dim name As String
Dim returnValue As Color

returnValue = Color.FromName(name)
public static Color FromName (
    string name
)
public:
static Color FromName (
    String^ name
)
public static Color FromName (
    String name
)
public static function FromName (
    name : String
) : Color

Parameter

  • name
    Eine Zeichenfolge, die den Namen der vordefinierten Farbe darstellt. Gültige Namen sind die Namen der Elemente der KnownColor-Enumeration.

Rückgabewert

Die Color, die von dieser Methode erstellt wird.

Hinweise

Vordefinierte Farben werden auch als bekannte Farben bezeichnet und durch ein Element der KnownColor-Enumeration dargestellt. Wenn name-Parameter kein gültiger Name für eine vordefinierte Farbe ist, erstellt die FromName-Methode eine Color-Struktur mit dem ARGB-Wert 0 (d. h., alle ARGB-Komponenten sind 0).

Beispiel

Im folgenden Codebeispiel werden der G-Member, der B-Member, der R-Member, der A-Member und der FromName-Member einer Color sowie der op_Implicit-Member veranschaulicht.

Dieses Beispiel ist für die Verwendung mit einem Windows Form vorgesehen. Fügen Sie den Code in das Formular ein, und rufen Sie in der Paint-Ereignisbehandlungsmethode des Formulars die ShowPropertiesOfSlateBlue-Methode auf, wobei Sie e als PaintEventArgs übergeben.

Private Sub ShowPropertiesOfSlateBlue(ByVal e As PaintEventArgs)
    Dim slateBlue As Color = Color.FromName("SlateBlue")
    Dim g As Byte = slateBlue.G
    Dim b As Byte = slateBlue.B
    Dim r As Byte = slateBlue.R
    Dim a As Byte = slateBlue.A
    Dim text As String = _
    String.Format("Slate Blue has these ARGB values: Alpha:{0}, " _
       & "red:{1}, green: {2}, blue {3}", New Object() {a, r, g, b})
    e.Graphics.DrawString(text, New Font(Me.Font, FontStyle.Italic), _
        New SolidBrush(slateBlue), _
        New RectangleF(New PointF(0.0F, 0.0F), _
        Size.op_Implicit(Me.Size)))
End Sub
private void ShowPropertiesOfSlateBlue(PaintEventArgs e)
{
    Color slateBlue = Color.FromName("SlateBlue");
    byte g = slateBlue.G;
    byte b = slateBlue.B;
    byte r = slateBlue.R;
    byte a = slateBlue.A;
    string text = String.Format("Slate Blue has these ARGB values: Alpha:{0}, " +
        "red:{1}, green: {2}, blue {3}", new object[]{a, r, g, b});
    e.Graphics.DrawString(text, 
        new Font(this.Font, FontStyle.Italic), 
        new SolidBrush(slateBlue), 
        new RectangleF(new PointF(0.0F, 0.0F), this.Size));
}
void ShowPropertiesOfSlateBlue( PaintEventArgs^ e )
{
   Color slateBlue = Color::FromName( "SlateBlue" );
   Byte g = slateBlue.G;
   Byte b = slateBlue.B;
   Byte r = slateBlue.R;
   Byte a = slateBlue.A;
   array<Object^>^temp0 = {a,r,g,b};
   String^ text = String::Format( "Slate Blue has these ARGB values: Alpha:{0}, "
   "red:{1}, green: {2}, blue {3}", temp0 );
   e->Graphics->DrawString( text, gcnew System::Drawing::Font( this->Font,FontStyle::Italic ), gcnew SolidBrush( slateBlue ), RectangleF(PointF(0.0F,0.0F),this->Size) );
}
private void ShowPropertiesOfSlateBlue(PaintEventArgs e)
{
    Color slateBlue = Color.FromName("SlateBlue");
    ubyte g = slateBlue.get_G();
    ubyte b = slateBlue.get_B();
    ubyte r = slateBlue.get_R();
    ubyte a = slateBlue.get_A();
    String text = String.Format(
        "Slate Blue has these ARGB values: Alpha:{0}, "  
        + "red:{1}, green: {2}, blue {3}", 
        new Object[] { (UInt16)a, (UInt16)r, (UInt16)g, (UInt16)b });

    e.get_Graphics().DrawString(text, 
        new Font(this.get_Font(), FontStyle.Italic), 
        new SolidBrush(slateBlue), 
        new RectangleF(new PointF(0, 0), 
        Size.op_Implicit(this.get_Size())));
} //ShowPropertiesOfSlateBlue

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

Color-Struktur
Color-Member
System.Drawing-Namespace