Freigeben über


ColorConverter-Klasse

Konvertiert Farben aus einem Datentyp in einen anderen. Greifen Sie auf diese Klasse über TypeDescriptor zu.

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

Syntax

'Declaration
Public Class ColorConverter
    Inherits TypeConverter
'Usage
Dim instance As ColorConverter
public class ColorConverter : TypeConverter
public ref class ColorConverter : public TypeConverter
public class ColorConverter extends TypeConverter
public class ColorConverter extends TypeConverter

Hinweise

Wenn eine Konvertierung aus einer Zeichenfolge in eine Color erfolgt, erwartet ColorConverter den nicht gekennzeichneten Farbnamen. Andernfalls wird beim Konvertierungsvorgang eine Ausnahme ausgelöst. Beispielsweise müssen Sie "Blue" an die ConvertFrom-Methode übergeben, nicht jedoch "System.Drawing.Color.Blue" oder "Color.Blue".

Beispiel

Im folgenden Codebeispiel wird die Verwendung der ConvertToString-Methode veranschaulicht. Dieses Beispiel ist für die Verwendung mit Windows Forms vorgesehen. Fügen Sie diesen Code in ein Formular ein, und rufen Sie beim Behandeln des Paint-Ereignisses des Formulars die ShowColorConverter-Methode auf, wobei Sie e als PaintEventArgs übergeben.

Private Sub ShowColorConverter(ByVal e As PaintEventArgs)

    Dim myColor As Color = Color.PaleVioletRed

    ' Create the ColorConverter.
    Dim converter As System.ComponentModel.TypeConverter = _
       System.ComponentModel.TypeDescriptor.GetConverter(myColor)

    Dim colorAsString As String = _
        converter.ConvertToString(Color.PaleVioletRed)
    e.Graphics.DrawString(colorAsString, Me.Font, _
        Brushes.PaleVioletRed, 50.0F, 50.0F)
End Sub
private void ShowColorConverter(PaintEventArgs e)
{

    Color myColor = Color.PaleVioletRed;

    // Create the ColorConverter.
    System.ComponentModel.TypeConverter converter = 
        System.ComponentModel.TypeDescriptor.GetConverter(myColor);

    string colorAsString = converter.ConvertToString(Color.PaleVioletRed);
    e.Graphics.DrawString(colorAsString, this.Font,
        Brushes.PaleVioletRed, 50.0F, 50.0F);
}
void ShowColorConverter( PaintEventArgs^ e )
{
   Color myColor = Color::PaleVioletRed;
   
   // Create the ColorConverter.
   System::ComponentModel::TypeConverter^ converter = System::ComponentModel::TypeDescriptor::GetConverter( myColor );
   String^ colorAsString = converter->ConvertToString( Color::PaleVioletRed );
   e->Graphics->DrawString( colorAsString, this->Font, Brushes::PaleVioletRed, 50.0F, 50.0F );
}
private void ShowColorConverter(PaintEventArgs e)
{
    Color myColor = Color.get_PaleVioletRed();

    // Create the ColorConverter.
    System.ComponentModel.TypeConverter converter = 
        System.ComponentModel.TypeDescriptor.GetConverter(myColor);
    String colorAsString = converter.ConvertToString(
        Color.get_PaleVioletRed());

    e.get_Graphics().DrawString(colorAsString, this.get_Font(), 
        Brushes.get_PaleVioletRed(), 50, 50);
} //ShowColorConverter

Vererbungshierarchie

System.Object
   System.ComponentModel.TypeConverter
    System.Drawing.ColorConverter
       System.Web.UI.WebControls.WebColorConverter

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

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

ColorConverter-Member
System.Drawing-Namespace