ColorConverter 类

定义

命名空间:

System.Drawing

程序集:

System.ComponentModel.TypeConverter.dll

Source:

ColorConverter.cs

将颜色从一种数据类型转换为另一种数据类型。 通过 TypeDescriptor 访问此类。

public ref class ColorConverter : System::ComponentModel::TypeConverter

public class ColorConverter : System.ComponentModel.TypeConverter

type ColorConverter = class
    inherit TypeConverter

Public Class ColorConverter
Inherits TypeConverter

继承

Object

TypeConverter

ColorConverter

派生

System.Web.UI.WebControls.WebColorConverter

示例

下面的代码示例演示如何使用 ConvertToString 方法。 此示例旨在与 Windows 窗体 一起使用。 将此代码粘贴到窗体中， ShowColorConverter 并在处理窗体 Paint 的事件时调用 方法，作为 ePaintEventArgs传递。

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.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 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

注解

从字符串转换为 Color 时， ColorConverter 需要非限定的颜色名称;否则，转换过程中将发生异常。 例如，应将“Blue”而不是“System.Drawing.Color.Blue”或“Color.Blue”传递给 ConvertFrom 方法。

构造函数

ColorConverter()

初始化 ColorConverter 类的新实例。

方法

CanConvertFrom(ITypeDescriptorContext, Type)	确定该转换器是否可以将给定源类型的对象转换为转换器的本机类型。
CanConvertFrom(Type)	返回该转换器是否可以将给定类型的对象转换为此转换器的类型。 (继承自 TypeConverter)
CanConvertTo(ITypeDescriptorContext, Type)	返回指示该转换器能否使用上下文将对象转换为给定目标类型的值。
CanConvertTo(Type)	返回此转换器是否可将该对象转换为指定的类型。 (继承自 TypeConverter)
ConvertFrom(ITypeDescriptorContext, CultureInfo, Object)	将给定对象转换为转换器的本机类型。
ConvertFrom(Object)	将给定值转换为此转换器的类型。 (继承自 TypeConverter)
ConvertFromInvariantString(ITypeDescriptorContext, String)	使用不变区域性和指定上下文将给定字符串转换为此转换器的类型。 (继承自 TypeConverter)
ConvertFromInvariantString(String)	使用不变区域性将给定字符串转换为此转换器的类型。 (继承自 TypeConverter)
ConvertFromString(ITypeDescriptorContext, CultureInfo, String)	使用指定的上下文和区域性信息将给定的文本转换为对象。 (继承自 TypeConverter)
ConvertFromString(ITypeDescriptorContext, String)	使用指定的上下文将给定的文本转换为对象。 (继承自 TypeConverter)
ConvertFromString(String)	将指定文本转换为对象。 (继承自 TypeConverter)
ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)	将指定的对象转换为其他类型。
ConvertTo(Object, Type)	使用参数将给定的值对象转换为指定的类型。 (继承自 TypeConverter)
ConvertToInvariantString(ITypeDescriptorContext, Object)	使用指定的上下文将指定的值转换为区域性不变的字符串表示形式。 (继承自 TypeConverter)
ConvertToInvariantString(Object)	将指定值转换为区域性不变的字符串表示形式。 (继承自 TypeConverter)
ConvertToString(ITypeDescriptorContext, CultureInfo, Object)	使用指定的上下文和区域性信息将给定的值转换为字符串表示形式。 (继承自 TypeConverter)
ConvertToString(ITypeDescriptorContext, Object)	使用给定的上下文将给定的值转换为字符串表示形式。 (继承自 TypeConverter)
ConvertToString(Object)	将指定值转换为字符串表示形式。 (继承自 TypeConverter)
CreateInstance(IDictionary)	在给定 Object 的一组属性值的情况下重新创建该对象。 (继承自 TypeConverter)
CreateInstance(ITypeDescriptorContext, IDictionary)	给定该对象的一组属性值，使用指定上下文创建与此 TypeConverter 相关联的类型的实例。 (继承自 TypeConverter)
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetConvertFromException(Object)	返回当转换无法执行时所引发的异常。 (继承自 TypeConverter)
GetConvertToException(Object, Type)	返回当转换无法执行时所引发的异常。 (继承自 TypeConverter)
GetCreateInstanceSupported()	返回更改此对象的值是否求调用 CreateInstance(IDictionary) 方法来创建新值。 (继承自 TypeConverter)
GetCreateInstanceSupported(ITypeDescriptorContext)	返回一个结果，即更改此对象上的某个值是否需要调用 CreateInstance(IDictionary) 以使用指定的上下文创建新值。 (继承自 TypeConverter)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetProperties(ITypeDescriptorContext, Object)	使用指定的上下文返回值参数指定的数组类型的属性的集合。 (继承自 TypeConverter)
GetProperties(ITypeDescriptorContext, Object, Attribute[])	使用指定的上下文和特性返回由该值参数指定的数组类型的属性集合。 (继承自 TypeConverter)
GetProperties(Object)	返回由值参数指定的数组类型的属性集合。 (继承自 TypeConverter)
GetPropertiesSupported()	返回此对象是否支持属性。 (继承自 TypeConverter)
GetPropertiesSupported(ITypeDescriptorContext)	通过使用指定的上下文，返回此对象是否支持属性。 (继承自 TypeConverter)
GetStandardValues()	从默认的上下文返回此类型转换器设计用于的数据类型的标准值集合。 (继承自 TypeConverter)
GetStandardValues(ITypeDescriptorContext)	检索一个集合，该集合包含适用于此验证程序的数据类型的标准值集。 如果该数据类型不支持标准值集，这将返回 null。
GetStandardValuesExclusive()	返回从 GetStandardValues() 返回的标准值的集合是否为独占列表。 (继承自 TypeConverter)
GetStandardValuesExclusive(ITypeDescriptorContext)	使用指定的上下文返回从 GetStandardValues() 返回的标准值的集合是否为可能值的独占列表。 (继承自 TypeConverter)
GetStandardValuesSupported()	返回此对象是否支持可以从列表中选取的标准值集。 (继承自 TypeConverter)
GetStandardValuesSupported(ITypeDescriptorContext)	确定该对象是否支持可以从列表中选取的标准值集。
GetType()	获取当前实例的 Type。 (继承自 Object)
IsValid(ITypeDescriptorContext, Object)	返回给定的值对象是否对此类型和对指定的上下文有效。 (继承自 TypeConverter)
IsValid(Object)	返回给定值对象对于此类型是否有效。 (继承自 TypeConverter)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
SortProperties(PropertyDescriptorCollection, String[])	对属性的集合进行排序。 (继承自 TypeConverter)
ToString()	返回表示当前对象的字符串。 (继承自 Object)