ColorDialog.AnyColor 属性

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

获取或设置一个值，该值指示对话框是否显示基本颜色集中可用的所有颜色。

public virtual bool AnyColor { get; set; }

属性值

Boolean

如果对话框显示基本颜色集中可用的所有颜色，则为 true；否则为 false。 默认值是 false。

示例

下面的代码示例演示如何初始化 ColorDialog 设置 AnyColor， AllowFullOpen 属性。 ColorDialog不允许用户设置自定义颜色，但它允许显示完整的基本颜色集。 将 属性设置为 SolidColorOnlyfalse时，它允许在具有 256 种或更少颜色的系统上显示其他颜色组合的颜色。 该示例还演示了设置 ShowHelp 属性和处理 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 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.");
}

适用于

另请参阅

• CustomColors