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 Forms 搭配使用。This example is designed to be used with Windows Forms. 將此程式碼貼入表單, 並ShowColorConverter在處理表單的Paint事件時呼叫方法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", 而不是ConvertFrom "system.object" 或 "Color. blue" 傳遞給方法。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[])

使用指定的內容和屬性 (Attribute),傳回由值參數所指定之陣列型別的屬性 (Property) 集合。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 的淺層複本 (Shallow Copy)。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)

適用於