ColorDialogとは何？わかりやすく解説 Weblio辞書

索引トップ用語の索引ランキング

ColorDialog イベント

	名前	説明
	Disposed	コンポーネントの Disposed イベントを待機するイベントハンドラを追加します。 ( Component から継承されます。)
	HelpRequest	ユーザーがコモンダイアログボックスの [?] ボタンをクリックすると発生します。 ( CommonDialog から継承されます。)

参照

ColorDialog クラス

使用できる一連の色と、ユーザーがカスタムカラーを定義するために使用できるコントロールを表示するコモンダイアログボックスを表します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Class ColorDialog
    Inherits CommonDialog

Visual Basic (使用法)

Dim instance As ColorDialog

public class ColorDialog : CommonDialog

C++

public ref class ColorDialog : public
 CommonDialog

public class ColorDialog extends CommonDialog

JScript

public class ColorDialog extends
 CommonDialog

解説

このコモンダイアログボックスを作成するには、継承メンバ ShowDialog を呼び出す必要があります。HookProc をオーバーライドして、ダイアログボックスに対して特定のフック機能を実装することもできます。Color を使用して、ユーザーが選択した色を取得します。

ColorDialog のインスタンスを作成すると、一部の読み書き可能プロパティが初期値に設定されます。これらの初期値の一覧については、ColorDialog コンストラクタのトピックを参照してください。

使用例

新しい ColorDialog を作成する例を次に示します。この例では、TextBox と Button が配置されている既存のフォームからメソッドを呼び出す必要があります。

Visual Basic

Private Sub button1_Click(sender As
 Object, e As System.EventArgs)
    Dim MyDialog As New
 ColorDialog()
    ' Keeps the user from selecting a custom color.
    MyDialog.AllowFullOpen = False
    ' Allows the user to get help. (The default is false.)
    MyDialog.ShowHelp = True
    ' Sets the initial color select to the current text color,
    MyDialog.Color = textBox1.ForeColor

    ' Update the text box color if the user clicks OK 
    If (MyDialog.ShowDialog() = DialogResult.OK) Then
        textBox1.ForeColor =  MyDialog.Color
    End If

End Sub 'button1_Click

private void button1_Click(object sender, System.EventArgs
 e)
 {
    ColorDialog MyDialog = new ColorDialog();
    // Keeps the user from selecting a custom color.
    MyDialog.AllowFullOpen = false ;
    // Allows the user to get help. (The default is false.)
    MyDialog.ShowHelp = true ;
    // Sets the initial color select to the current text color.
    MyDialog.Color = textBox1.ForeColor ;
    
    // Update the text box color if the user clicks OK 
    if (MyDialog.ShowDialog() == DialogResult.OK)
        textBox1.ForeColor =  MyDialog.Color;
 }

C++

private:
   void button1_Click( Object^ /*sender*/, System::EventArgs^
 /*e*/ )
   {
      ColorDialog^ MyDialog = gcnew ColorDialog;
      // Keeps the user from selecting a custom color.
      MyDialog->AllowFullOpen = false;
      // Allows the user to get help. (The default is false.)
      MyDialog->ShowHelp = true;
      // Sets the initial color select to the current text color.
      MyDialog->Color = textBox1->ForeColor;
      
      // Update the text box color if the user clicks OK 
      if ( MyDialog->ShowDialog() == ::DialogResult::OK )
      {
         textBox1->ForeColor = MyDialog->Color;
      }
   }

protected void button1_Click(Object sender,
 System.EventArgs e)
{
    ColorDialog myDialog = new ColorDialog();
    // Keeps the user from selecting a custom color.
    myDialog.set_AllowFullOpen(false);
    // Allows the user to get help. (The default is false.)
    myDialog.set_ShowHelp(true);
    // Sets the initial color select to the current text color.
    myDialog.set_Color(textBox1.get_ForeColor());
    // Update the text box color if the user clicks OK 
    if (myDialog.ShowDialog().Equals(get_DialogResult().OK)) {
        textBox1.set_ForeColor(myDialog.get_Color());
    }
} //button1_Click

継承階層

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
       System.Windows.Forms.CommonDialog
        System.Windows.Forms.ColorDialog

スレッドセーフ

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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

参照

関連項目
ColorDialog メンバ
System.Windows.Forms 名前空間
CommonDialog

ColorDialog コンストラクタ

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

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New ColorDialog

public ColorDialog ()

C++

public:
ColorDialog ()

public ColorDialog ()

JScript

public function ColorDialog ()

解説

ColorDialog のインスタンスを作成すると、次の読み書き可能プロパティが初期値に設定されます。

プロパティ	初期値
AllowFullOpen	true
AnyColor	false
Color	Color.Black
CustomColors	null 参照 (Visual Basic では Nothing)
FullOpen	false
ShowHelp	false
SolidColorOnly	false

これらのプロパティの値は、各プロパティを個別に呼び出して変更できます。

プラットフォーム

バージョン情報

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

参照

関連項目
ColorDialog クラス
ColorDialog メンバ
System.Windows.Forms 名前空間

ColorDialog プロパティ

パブリックプロパティパブリックプロパティ

( プロテクトプロパティも参照)

	名前	説明
	AllowFullOpen	ユーザーがダイアログボックスを使用してカスタムカラーを定義できるかどうかを示す値を取得または設定します。
	AnyColor	使用可能なすべての色を基本色セットとしてダイアログボックスに表示するかどうかを示す値を取得または設定します。
	Color	ユーザーが選択した色を取得または設定します。
	Container	Component を格納している IContainer を取得します。 ( Component から継承されます。)
	CustomColors	ダイアログボックスに表示されるカスタムカラーセットを取得または設定します。
	FullOpen	ダイアログボックスが開かれたときに、カスタムカラーの作成用のコントロールを表示するかどうかを示す値を取得または設定します。
	ShowHelp	カラーダイアログボックスに [?] ボタンを表示するかどうかを示す値を取得または設定します。
	Site	Component の ISite を取得または設定します。 ( Component から継承されます。)
	SolidColorOnly	ダイアログボックスでユーザーが選択できる色を純色だけに制限するかどうかを示す値を取得または設定します。
	Tag	コントロールに関するデータを格納するオブジェクトを取得または設定します。 ( CommonDialog から継承されます。)

プロテクトプロパティ

	名前	説明
	CanRaiseEvents	コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。 ( Component から継承されます。)
	DesignMode	Component が現在デザインモードかどうかを示す値を取得します。 ( Component から継承されます。)
	Events	Component に結び付けられているイベントハンドラのリストを取得します。 ( Component から継承されます。)
	Instance	基になるウィンドウのインスタンスハンドル (HINSTANCE) を取得します。
	Options	ColorDialog を初期化するための値を取得します。

参照

ColorDialog メソッド

パブリックメソッドパブリックメソッド

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

	名前	説明
	CreateObjRef	リモートオブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 ( MarshalByRefObject から継承されます。)
	Dispose	オーバーロードされます。 Component によって使用されているリソースを解放します。 ( Component から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービスオブジェクトを取得します。 ( MarshalByRefObject から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	InitializeLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、有効期間サービスオブジェクトを取得します。 ( MarshalByRefObject から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	Reset	オーバーライドされます。すべてのオプションを既定値に、最後に選択した色を黒に、カスタムカラーを既定値にリセットします。
	ShowDialog	オーバーロードされます。コモンダイアログボックスを実行します。 ( CommonDialog から継承されます。)
	ToString	オーバーライドされます。 ColorDialog を表す文字列を返します。

プロテクトメソッド

	名前	説明
	Dispose	オーバーロードされます。 Component によって使用されているリソースを解放します。 ( Component から継承されます。)
	Finalize	Component がガベージコレクションによってクリアされる前に、アンマネージリソースを解放し、その他のクリーンアップ操作を実行します。 ( Component から継承されます。)
	GetService	Component またはその Container で提供されるサービスを表すオブジェクトを返します。 ( Component から継承されます。)
	HookProc	コモンダイアログボックスに特定の機能を追加するためにオーバーライドされる、コモンダイアログボックスのフックプロシージャを定義します。 ( CommonDialog から継承されます。)
	MemberwiseClone	オーバーロードされます。 ( MarshalByRefObject から継承されます。)
	OnHelpRequest	HelpRequest イベントを発生させます。 ( CommonDialog から継承されます。)
	OwnerWndProc	コモンダイアログボックスに特定の機能を追加するためにオーバーライドされる、オーナーウィンドウプロシージャを定義します。 ( CommonDialog から継承されます。)
	RunDialog	オーバーライドされます。

参照

ColorDialog メンバ

使用できる一連の色と、ユーザーがカスタムカラーを定義するために使用できるコントロールを表示するコモンダイアログボックスを表します。

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

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

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

パブリックプロパティ

( プロテクトプロパティも参照)

	名前	説明
	AllowFullOpen	ユーザーがダイアログボックスを使用してカスタムカラーを定義できるかどうかを示す値を取得または設定します。
	AnyColor	使用可能なすべての色を基本色セットとしてダイアログボックスに表示するかどうかを示す値を取得または設定します。
	Color	ユーザーが選択した色を取得または設定します。
	Container	Component を格納している IContainer を取得します。(Component から継承されます。)
	CustomColors	ダイアログボックスに表示されるカスタムカラーセットを取得または設定します。
	FullOpen	ダイアログボックスが開かれたときに、カスタムカラーの作成用のコントロールを表示するかどうかを示す値を取得または設定します。
	ShowHelp	カラーダイアログボックスに [?] ボタンを表示するかどうかを示す値を取得または設定します。
	Site	Component の ISite を取得または設定します。(Component から継承されます。)
	SolidColorOnly	ダイアログボックスでユーザーが選択できる色を純色だけに制限するかどうかを示す値を取得または設定します。
	Tag	コントロールに関するデータを格納するオブジェクトを取得または設定します。 (CommonDialog から継承されます。)

プロテクトプロパティ

	名前	説明
	CanRaiseEvents	コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。(Component から継承されます。)
	DesignMode	Component が現在デザインモードかどうかを示す値を取得します。(Component から継承されます。)
	Events	Component に結び付けられているイベントハンドラのリストを取得します。(Component から継承されます。)
	Instance	基になるウィンドウのインスタンスハンドル (HINSTANCE) を取得します。
	Options	ColorDialog を初期化するための値を取得します。

パブリックメソッド

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

	名前	説明
	CreateObjRef	リモートオブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 (MarshalByRefObject から継承されます。)
	Dispose	オーバーロードされます。 Component によって使用されているリソースを解放します。 (Component から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービスオブジェクトを取得します。 (MarshalByRefObject から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	InitializeLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、有効期間サービスオブジェクトを取得します。 (MarshalByRefObject から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	Reset	オーバーライドされます。すべてのオプションを既定値に、最後に選択した色を黒に、カスタムカラーを既定値にリセットします。
	ShowDialog	オーバーロードされます。コモンダイアログボックスを実行します。 (CommonDialog から継承されます。)
	ToString	オーバーライドされます。 ColorDialog を表す文字列を返します。

プロテクトメソッド

	名前	説明
	Dispose	オーバーロードされます。 Component によって使用されているリソースを解放します。 (Component から継承されます。)
	Finalize	Component がガベージコレクションによってクリアされる前に、アンマネージリソースを解放し、その他のクリーンアップ操作を実行します。 (Component から継承されます。)
	GetService	Component またはその Container で提供されるサービスを表すオブジェクトを返します。 (Component から継承されます。)
	HookProc	コモンダイアログボックスに特定の機能を追加するためにオーバーライドされる、コモンダイアログボックスのフックプロシージャを定義します。 (CommonDialog から継承されます。)
	MemberwiseClone	オーバーロードされます。 ( MarshalByRefObject から継承されます。)
	OnHelpRequest	HelpRequest イベントを発生させます。 (CommonDialog から継承されます。)
	OwnerWndProc	コモンダイアログボックスに特定の機能を追加するためにオーバーライドされる、オーナーウィンドウプロシージャを定義します。 (CommonDialog から継承されます。)
	RunDialog	オーバーライドされます。

パブリックイベント

	名前	説明
	Disposed	コンポーネントの Disposed イベントを待機するイベントハンドラを追加します。(Component から継承されます。)
	HelpRequest	ユーザーがコモンダイアログボックスの [?] ボタンをクリックすると発生します。(CommonDialog から継承されます。)

参照

ColorDialogとは？わかりやすく解説

ColorDialog イベント

関連項目

ColorDialog クラス

ColorDialog コンストラクタ

ColorDialog プロパティ

関連項目

ColorDialog メソッド

関連項目

ColorDialog メンバ

関連項目

「ColorDialog」の関連用語


	© 2025 Microsoft.All rights reserved.

ColorDialogとは？ わかりやすく解説

ColorDialog イベント

関連項目

ColorDialog クラス

ColorDialog コンストラクタ

ColorDialog プロパティ

関連項目

ColorDialog メソッド

関連項目

ColorDialog メンバ

関連項目

急上昇のことば

「ColorDialog」の関連用語

ColorDialogとは？わかりやすく解説