ColorConverter 類別

定義

命名空間:

System.Drawing

組件:

System.ComponentModel.TypeConverter.dll

來源:

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 Forms 搭配使用。 將此程式代碼貼到表單中，並在處理表單的事件時呼叫 ShowColorConverter 方法，並e傳遞為 PaintEventArgs。Paint

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[])	使用指定的內容和屬性 (attribute)，傳回由該值參數所指定之陣列類型的屬性 (property) 集合。 (繼承來源 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)