ColorConverter

.NET Framework クラス ライブラリ リファレンス

ColorConverter クラス

あるデータ型の色を別の色に変換します。このクラスには TypeDescriptor を使用してアクセスします。

名前空間: System.Drawing
アセンブリ: System.Drawing (system.drawing.dll 内)
構文

Visual Basic (宣言)

Public Class ColorConverter
    Inherits TypeConverter

Visual Basic (使用法)

Dim instance As ColorConverter

C#

public class ColorConverter : TypeConverter

C++

public ref class ColorConverter : public
 TypeConverter

J#

public class ColorConverter extends TypeConverter

JScript

public class ColorConverter extends
 TypeConverter

解説

文字列を Color に変換する場合、ColorConverter は非修飾のカラー名を想定しています。それ以外の場合は、変換プロセスで例外が発生します。たとえば、ConvertFrom メソッドに対しては、"System.Drawing.Color.Blue" や "Color.Blue" ではなく、"Blue" を渡す必要があります。

使用例

ConvertToString メソッドを使用する方法を次のコード例に示します。この例は、Windows フォームでの使用を意図してデザインされています。このコードをフォームに貼り付け、フォームの Paint イベントを処理するときに PaintEventArgs の e を渡して ShowColorConverter メソッドを呼び出します。

Visual Basic

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

C#

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

C++

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

J#

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

継承階層

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

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

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

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
ColorConverter メンバ
System.Drawing 名前空間

ColorConverter コンストラクタ

ColorConverter クラスの新しいインスタンスを初期化します。

名前空間: System.Drawing
アセンブリ: System.Drawing (system.drawing.dll 内)
構文

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New ColorConverter

C#

public ColorConverter ()

C++

public:
ColorConverter ()

J#

public ColorConverter ()

JScript

public function ColorConverter ()

プラットフォーム

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

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
ColorConverter クラス
ColorConverter メンバ
System.Drawing 名前空間

ColorConverter メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	CanConvertFrom	オーバーロードされます。 このコンバータが、任意の型のオブジェクトをコンバータのネイティブな型に変換できるかどうかを確認します。
	CanConvertTo	オーバーロードされます。 このコンバータが、オブジェクトを特定の目的の型に変換できるかどうかを示す値を返します。
	ConvertFrom	オーバーロードされます。 特定のオブジェクトをコンバータのネイティブな型に変換します。
	ConvertFromInvariantString	オーバーロードされます。 インバリアント カルチャを使用して、値をコンバータの型に変換します。 ( TypeConverter から継承されます。)
	ConvertFromString	オーバーロードされます。 指定したテキストをオブジェクトに変換します。 ( TypeConverter から継承されます。)
	ConvertTo	オーバーロードされます。 指定したオブジェクトを別の型に変換します。
	ConvertToInvariantString	オーバーロードされます。 指定した値を、インバリアント カルチャを使用した文字列形式に変換します。 ( TypeConverter から継承されます。)
	ConvertToString	オーバーロードされます。 指定した値を文字列形式に変換します。 ( TypeConverter から継承されます。)
	CreateInstance	オーバーロードされます。 Object の一連のプロパティ値を指定して、そのオブジェクトを再作成します。 ( TypeConverter から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetCreateInstanceSupported	オーバーロードされます。 このオブジェクトの値を変更するときに CreateInstance メソッドを呼び出して、新しい値を作成する必要があるかどうかを返します。 ( TypeConverter から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetProperties	オーバーロードされます。 value パラメータに指定された配列型のプロパティのコレクションを返します。 ( TypeConverter から継承されます。)
	GetPropertiesSupported	オーバーロードされます。 オブジェクトがプロパティをサポートしているかどうかを示す値を返します。 ( TypeConverter から継承されます。)
	GetStandardValues	オーバーロードされます。 検証コントロールがデザインされた対象のデータ型の値の標準セットを含むコレクションを取得します。
	GetStandardValuesExclusive	オーバーロードされます。 GetStandardValues から返された標準値のコレクションが、排他的なリストかどうかを示す値を返します。 ( TypeConverter から継承されます。)
	GetStandardValuesSupported	オーバーロードされます。 リストから選択できる値の標準セットをオブジェクトがサポートしているかどうかを確認します。
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	IsValid	オーバーロードされます。 指定した値オブジェクトが型に対して有効かどうかを示す値を返します。 ( TypeConverter から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	GetConvertFromException	変換を実行できなかった場合にスローされる例外を返します。 ( TypeConverter から継承されます。)
	GetConvertToException	変換を実行できなかった場合にスローされる例外を返します。 ( TypeConverter から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)
	SortProperties	プロパティのコレクションを並べ替えます。 ( TypeConverter から継承されます。)

参照

関連項目

ColorConverter クラス
System.Drawing 名前空間

ColorConverter メンバ

あるデータ型の色を別の色に変換します。このクラスには TypeDescriptor を使用してアクセスします。

ColorConverter データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	ColorConverter	ColorConverter クラスの新しいインスタンスを初期化します。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	CanConvertFrom	オーバーロードされます。 このコンバータが、任意の型のオブジェクトをコンバータのネイティブな型に変換できるかどうかを確認します。
	CanConvertTo	オーバーロードされます。 このコンバータが、オブジェクトを特定の目的の型に変換できるかどうかを示す値を返します。
	ConvertFrom	オーバーロードされます。 特定のオブジェクトをコンバータのネイティブな型に変換します。
	ConvertFromInvariantString	オーバーロードされます。 インバリアント カルチャを使用して、値をコンバータの型に変換します。 (TypeConverter から継承されます。)
	ConvertFromString	オーバーロードされます。 指定したテキストをオブジェクトに変換します。 (TypeConverter から継承されます。)
	ConvertTo	オーバーロードされます。 指定したオブジェクトを別の型に変換します。
	ConvertToInvariantString	オーバーロードされます。 指定した値を、インバリアント カルチャを使用した文字列形式に変換します。 (TypeConverter から継承されます。)
	ConvertToString	オーバーロードされます。 指定した値を文字列形式に変換します。 (TypeConverter から継承されます。)
	CreateInstance	オーバーロードされます。 Object の一連のプロパティ値を指定して、そのオブジェクトを再作成します。 (TypeConverter から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetCreateInstanceSupported	オーバーロードされます。 このオブジェクトの値を変更するときに CreateInstance メソッドを呼び出して、新しい値を作成する必要があるかどうかを返します。 (TypeConverter から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetProperties	オーバーロードされます。 value パラメータに指定された配列型のプロパティのコレクションを返します。 (TypeConverter から継承されます。)
	GetPropertiesSupported	オーバーロードされます。 オブジェクトがプロパティをサポートしているかどうかを示す値を返します。 (TypeConverter から継承されます。)
	GetStandardValues	オーバーロードされます。 検証コントロールがデザインされた対象のデータ型の値の標準セットを含むコレクションを取得します。
	GetStandardValuesExclusive	オーバーロードされます。 GetStandardValues から返された標準値のコレクションが、排他的なリストかどうかを示す値を返します。 (TypeConverter から継承されます。)
	GetStandardValuesSupported	オーバーロードされます。 リストから選択できる値の標準セットをオブジェクトがサポートしているかどうかを確認します。
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	IsValid	オーバーロードされます。 指定した値オブジェクトが型に対して有効かどうかを示す値を返します。 (TypeConverter から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	GetConvertFromException	変換を実行できなかった場合にスローされる例外を返します。 (TypeConverter から継承されます。)
	GetConvertToException	変換を実行できなかった場合にスローされる例外を返します。 (TypeConverter から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)
	SortProperties	プロパティのコレクションを並べ替えます。 (TypeConverter から継承されます。)

参照

関連項目

ColorConverter クラス
System.Drawing 名前空間