ColorDialog.SolidColorOnly プロパティ

ダイアログ ボックスでユーザーが選択できる色を純色だけに制限するかどうかを示す値を取得または設定します。

Public Overridable Property SolidColorOnly As Boolean
[C#]
public virtual bool SolidColorOnly {get; set;}
[C++]
public: __property virtual bool get_SolidColorOnly();public: __property virtual void set_SolidColorOnly(bool);
[JScript]
public function get SolidColorOnly() : Boolean;public function set SolidColorOnly(Boolean);

プロパティ値

ユーザーが純色だけを選択できる場合は true 。それ以外の場合は false 。既定値は false です。

解説

このプロパティは、表示色が 256 色以下のシステムに適用されます。これらのシステムでは、一部の色が他の色とのディザ カラーになります。

使用例

[Visual Basic, C#] ColorDialog オブジェクトを初期化するコード例を次に示します。ColorDialog オブジェクトではユーザーがカスタム カラーを設定することはできません。ただし、基本色セットはすべて表示できます。 SolidColorOnly プロパティを false に設定すると、256 色以下のシステム上の色を組み合わせた色を表示できるようになります。この例ではまた、 ShowHelp プロパティの設定方法と、ColorDialog の System.Windows.Forms.ColorDialog.HelpRequest イベントの処理方法も示します。この例を実行するには、次のコードをフォームに貼り付けて、フォームのコンストラクタまたは Load メソッドで InitializeColorDialog メソッドを呼び出します。この例は、ボタンの Click イベントが、この例で定義されているイベント処理メソッドに関連付けられていることを前提としています。

 

' This method initializes ColorDialog1 to allow any colors, 
' and combination colors on systems with 256 colors or less, 
' but will not allow the user to set custom colors.  The
' dialog will contain the help button.
Private Sub InitializeColorDialog()
    Me.ColorDialog1 = New System.Windows.Forms.ColorDialog
    Me.ColorDialog1.AllowFullOpen = False
    Me.ColorDialog1.AnyColor = True
    Me.ColorDialog1.SolidColorOnly = False
    Me.ColorDialog1.ShowHelp = True
End Sub
  

' This method opens the dialog and checks the DialogResult value. 
' If the result is OK, the text box's background color will be changed 
' to the user-selected color.
Private Sub Button1_Click(ByVal sender As System.Object,  _
    ByVal e As System.EventArgs) Handles Button1.Click
    Dim result As DialogResult = ColorDialog1.ShowDialog()
    If (result.Equals(DialogResult.OK)) Then
        TextBox1.BackColor = ColorDialog1.Color
    End If
End Sub
 
  
' This method is called when the HelpRequest event is raised, 
'which occurs when the user clicks the Help button on the ColorDialog object.
Private Sub ColorDialog1_HelpRequest(ByVal sender As Object, _ 
    ByVal e As System.EventArgs) Handles ColorDialog1.HelpRequest

    MessageBox.Show("Please select a color by clicking it." _
    & "This will change the BackColor property of the TextBox.")
End Sub

[C#] 
// This method initializes ColorDialog1 to allow any colors, 
// and combination colors on systems with 256 colors or less, 
// but will not allow the user to set custom colors.  The
// dialog will contain the help button.
private void InitializeColorDialog()
{
    this.ColorDialog1 = new System.Windows.Forms.ColorDialog();
    this.ColorDialog1.AllowFullOpen = false;
    this.ColorDialog1.AnyColor = true;
    this.ColorDialog1.SolidColorOnly = false;
    this.ColorDialog1.ShowHelp = true;
    
    // Associate the event-handling method with
    // the HelpRequest event.
    this.ColorDialog1.HelpRequest 
        += new System.EventHandler(ColorDialog1_HelpRequest);
}


// This method opens the dialog and checks the DialogResult value. 
// If the result is OK, the text box's background color will be changed 
// to the user-selected color.
private void Button1_Click(System.Object sender, System.EventArgs e)
{
    DialogResult result = ColorDialog1.ShowDialog();
    if (result.Equals(DialogResult.OK))
    {
        TextBox1.BackColor = ColorDialog1.Color;
    }
}

// This method is called when the HelpRequest event is raised, 
//which occurs when the user clicks the Help button on the ColorDialog object.
private void ColorDialog1_HelpRequest(object sender, System.EventArgs e)
{

    MessageBox.Show("Please select a color by clicking it. "
       + "This will change the BackColor property of the TextBox.");
}

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

必要条件

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

参照

ColorDialog クラス | ColorDialog メンバ | System.Windows.Forms 名前空間