ColorConverter 类

定义

将颜色从一种数据类型转换为另一种数据类型。Converts colors from one data type to another. 通过 TypeDescriptor 访问此类。Access this class through the TypeDescriptor.

public ref class ColorConverter : System::ComponentModel::TypeConverter
public class ColorConverter : System.ComponentModel.TypeConverter
type ColorConverter = class
    inherit TypeConverter
Public Class ColorConverter
Inherits TypeConverter
继承
ColorConverter
派生

示例

下面的代码示例演示如何使用 ConvertToString 方法。The following code example demonstrates how to use the ConvertToString method. 此示例旨在与 Windows 窗体一起使用。This example is designed to be used with Windows Forms. 将此代码粘贴到窗体中,并在处理窗体的 Paint 事件时调用 ShowColorConverter 方法,并将 e 作为 PaintEventArgs传递。Paste this code into a form and call the ShowColorConverter method when handling the form's Paint event, passing e as PaintEventArgs.

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 需要非限定的颜色名称;否则,将在转换过程中出现异常。When converting from a string to a Color the ColorConverter expects the unqualified color name; otherwise, an exception will occur in the conversion process. 例如,应将 "Blue" 而不是 "System.web. Color" 或 "Color 蓝" 传递到 ConvertFrom 方法。For example, you should pass "Blue", not "System.Drawing.Color.Blue" or "Color.Blue", to the ConvertFrom method.

构造函数

ColorConverter()

初始化 ColorConverter 类的新实例。Initializes a new instance of the ColorConverter class.

方法

CanConvertFrom(ITypeDescriptorContext, Type)

确定该转换器是否可以将给定源类型的对象转换为转换器的本机类型。Determines if this converter can convert an object in the given source type to the native type of the converter.

CanConvertFrom(Type)

返回该转换器是否可以将给定类型的对象转换为此转换器的类型。Returns whether this converter can convert an object of the given type to the type of this converter.

(继承自 TypeConverter)
CanConvertTo(ITypeDescriptorContext, Type)

返回指示该转换器能否使用上下文将对象转换为给定目标类型的值。Returns a value indicating whether this converter can convert an object to the given destination type using the context.

CanConvertTo(Type)

返回此转换器是否可将该对象转换为指定的类型。Returns whether this converter can convert the object to the specified type.

(继承自 TypeConverter)
ConvertFrom(ITypeDescriptorContext, CultureInfo, Object)

将给定对象转换为转换器的本机类型。Converts the given object to the converter's native type.

ConvertFrom(Object)

将给定值转换为此转换器的类型。Converts the given value to the type of this converter.

(继承自 TypeConverter)
ConvertFromInvariantString(ITypeDescriptorContext, String)

使用不变区域性和指定上下文将给定字符串转换为此转换器的类型。Converts the given string to the type of this converter, using the invariant culture and the specified context.

(继承自 TypeConverter)
ConvertFromInvariantString(String)

使用不变区域性将给定字符串转换为此转换器的类型。Converts the given string to the type of this converter, using the invariant culture.

(继承自 TypeConverter)
ConvertFromString(ITypeDescriptorContext, CultureInfo, String)

使用指定的上下文和区域性信息将给定的文本转换为对象。Converts the given text to an object, using the specified context and culture information.

(继承自 TypeConverter)
ConvertFromString(ITypeDescriptorContext, String)

使用指定的上下文将给定的文本转换为对象。Converts the given text to an object, using the specified context.

(继承自 TypeConverter)
ConvertFromString(String)

将指定文本转换为对象。Converts the specified text to an object.

(继承自 TypeConverter)
ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)

将指定的对象转换为其他类型。Converts the specified object to another type.

ConvertTo(Object, Type)

使用参数将给定的值对象转换为指定的类型。Converts the given value object to the specified type, using the arguments.

(继承自 TypeConverter)
ConvertToInvariantString(ITypeDescriptorContext, Object)

使用指定的上下文将指定的值转换为区域性不变的字符串表示形式。Converts the specified value to a culture-invariant string representation, using the specified context.

(继承自 TypeConverter)
ConvertToInvariantString(Object)

将指定值转换为区域性不变的字符串表示形式。Converts the specified value to a culture-invariant string representation.

(继承自 TypeConverter)
ConvertToString(ITypeDescriptorContext, CultureInfo, Object)

使用指定的上下文和区域性信息将给定的值转换为字符串表示形式。Converts the given value to a string representation, using the specified context and culture information.

(继承自 TypeConverter)
ConvertToString(ITypeDescriptorContext, Object)

使用给定的上下文将给定的值转换为字符串表示形式。Converts the given value to a string representation, using the given context.

(继承自 TypeConverter)
ConvertToString(Object)

将指定值转换为字符串表示形式。Converts the specified value to a string representation.

(继承自 TypeConverter)
CreateInstance(IDictionary)

在给定 Object 的一组属性值的情况下重新创建该对象。Re-creates an Object given a set of property values for the object.

(继承自 TypeConverter)
CreateInstance(ITypeDescriptorContext, IDictionary)

给定该对象的一组属性值,使用指定上下文创建与此 TypeConverter 相关联的类型的实例。Creates an instance of the type that this TypeConverter is associated with, using the specified context, given a set of property values for the object.

(继承自 TypeConverter)
Equals(Object)

确定指定对象是否等于当前对象。Determines whether the specified object is equal to the current object.

(继承自 Object)
GetConvertFromException(Object)

返回当转换无法执行时所引发的异常。Returns an exception to throw when a conversion cannot be performed.

(继承自 TypeConverter)
GetConvertToException(Object, Type)

返回当转换无法执行时所引发的异常。Returns an exception to throw when a conversion cannot be performed.

(继承自 TypeConverter)
GetCreateInstanceSupported()

返回更改此对象的值是否求调用 CreateInstance(IDictionary) 方法来创建新值。Returns whether changing a value on this object requires a call to the CreateInstance(IDictionary) method to create a new value.

(继承自 TypeConverter)
GetCreateInstanceSupported(ITypeDescriptorContext)

返回一个结果,即更改此对象上的某个值是否需要调用 CreateInstance(IDictionary) 以使用指定的上下文创建新值。Returns whether changing a value on this object requires a call to CreateInstance(IDictionary) to create a new value, using the specified context.

(继承自 TypeConverter)
GetHashCode()

用作默认哈希函数。Serves as the default hash function.

(继承自 Object)
GetProperties(ITypeDescriptorContext, Object)

使用指定的上下文返回值参数指定的数组类型的属性的集合。Returns a collection of properties for the type of array specified by the value parameter, using the specified context.

(继承自 TypeConverter)
GetProperties(ITypeDescriptorContext, Object, Attribute[])

使用指定的上下文和特性返回由该值参数指定的数组类型的属性集合。Returns a collection of properties for the type of array specified by the value parameter, using the specified context and attributes.

(继承自 TypeConverter)
GetProperties(Object)

返回由值参数指定的数组类型的属性集合。Returns a collection of properties for the type of array specified by the value parameter.

(继承自 TypeConverter)
GetPropertiesSupported()

返回此对象是否支持属性。Returns whether this object supports properties.

(继承自 TypeConverter)
GetPropertiesSupported(ITypeDescriptorContext)

通过使用指定的上下文,返回此对象是否支持属性。Returns whether this object supports properties, using the specified context.

(继承自 TypeConverter)
GetStandardValues()

从默认的上下文返回此类型转换器设计用于的数据类型的标准值集合。Returns a collection of standard values from the default context for the data type this type converter is designed for.

(继承自 TypeConverter)
GetStandardValues(ITypeDescriptorContext)

检索一个集合,该集合包含适用于此验证程序的数据类型的标准值集。Retrieves a collection containing a set of standard values for the data type for which this validator is designed. 如果该数据类型不支持标准值集,这将返回 nullThis will return null if the data type does not support a standard set of values.

GetStandardValuesExclusive()

返回从 GetStandardValues() 返回的标准值的集合是否为独占列表。Returns whether the collection of standard values returned from GetStandardValues() is an exclusive list.

(继承自 TypeConverter)
GetStandardValuesExclusive(ITypeDescriptorContext)

使用指定的上下文返回从 GetStandardValues() 返回的标准值的集合是否为可能值的独占列表。Returns whether the collection of standard values returned from GetStandardValues() is an exclusive list of possible values, using the specified context.

(继承自 TypeConverter)
GetStandardValuesSupported()

返回此对象是否支持可以从列表中选取的值的标准集。Returns whether this object supports a standard set of values that can be picked from a list.

(继承自 TypeConverter)
GetStandardValuesSupported(ITypeDescriptorContext)

确定该对象是否支持可以从列表中选取的标准值集。Determines if this object supports a standard set of values that can be chosen from a list.

GetType()

获取当前实例的 TypeGets the Type of the current instance.

(继承自 Object)
IsValid(ITypeDescriptorContext, Object)

返回给定的值对象是否对此类型和对指定的上下文有效。Returns whether the given value object is valid for this type and for the specified context.

(继承自 TypeConverter)
IsValid(Object)

返回给定值对象对于此类型是否有效。Returns whether the given value object is valid for this type.

(继承自 TypeConverter)
MemberwiseClone()

创建当前 Object 的浅表副本。Creates a shallow copy of the current Object.

(继承自 Object)
SortProperties(PropertyDescriptorCollection, String[])

对属性的集合进行排序。Sorts a collection of properties.

(继承自 TypeConverter)
ToString()

返回表示当前对象的字符串。Returns a string that represents the current object.

(继承自 Object)

适用于