ColorDialog クラス

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

この型のすべてのメンバの一覧については、ColorDialog メンバ を参照してください。

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

Public Class ColorDialog
   Inherits CommonDialog
[C#]
public class ColorDialog : CommonDialog
[C++]
public __gc class ColorDialog : public CommonDialog
[JScript]
public class ColorDialog extends CommonDialog

スレッドセーフ

この型の public static (Visual Basicでは Shared) のすべてのメンバは、マルチスレッド操作で安全に使用できます。インスタンスのメンバの場合は、スレッドセーフであるとは限りません。

解説

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

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

使用例

[Visual Basic, C#, C++] 新しい ColorDialog を作成する例を次に示します。この例では、 TextBox と Button が配置されている既存のフォームからメソッドが呼び出されることを前提としています。

 
Protected 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

[C#] 
protected 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++] 
protected:
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;
 }
    

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

名前空間: System.Windows.Forms

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

アセンブリ: System.Windows.Forms (System.Windows.Forms.dll 内)

参照

ColorDialog メンバ | System.Windows.Forms 名前空間 | CommonDialog