0 out of 2 rated this helpful - Rate this topic

ColorConverter Class

.NET Framework 2.0

Other Versions

Converts colors from one data type to another. Access this class through the TypeDescriptor.

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

Syntax

C++

Copy

public class ColorConverter : TypeConverter

Copy

public class ColorConverter extends TypeConverter

JScript

Copy

public class ColorConverter extends TypeConverter

XAML

Copy

Not applicable.

Remarks

When converting from a string to a Color the ColorConverter expects the unqualified color name; otherwise, an exception will occur in the conversion process. For example, you should pass "Blue", not "System.Drawing.Color.Blue" or "Color.Blue", to the ConvertFrom method.

Example

The following code example demonstrates how to use the ConvertToString method. This example is designed to be used with Windows Forms. Paste this code into a form and call the ShowColorConverter method when handling the form's Paint event, passing e as PaintEventArgs.

C++

Copy


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);
}

Copy

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

Inheritance Hierarchy

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

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Windows 98, Windows Server 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

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

Version Information

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

Reference

ColorConverter Members
System.Drawing Namespace

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

Community Content Add

FAQ