ColorDialog 类
表示一个通用对话框,该对话框显示可用的颜色以及允许用户定义自定义颜色的控件。
**命名空间:**System.Windows.Forms
**程序集:**System.Windows.Forms(在 system.windows.forms.dll 中)
语法
声明
Public Class ColorDialog
Inherits CommonDialog
用法
Dim instance As ColorDialog
public class ColorDialog : CommonDialog
public ref class ColorDialog : public CommonDialog
public class ColorDialog extends CommonDialog
public class ColorDialog extends CommonDialog
备注
必须调用继承的成员 ShowDialog 才能创建此特定的通用对话框。可重写 HookProc 以实现特定的对话框挂钩功能。使用 Color 可检索用户选定的颜色。
在创建 ColorDialog 的实例时,一些读/写属性被设置为初始值。有关这些值的列表,请参见 ColorDialog 构造函数。
示例
下面的示例阐释如何创建新的 ColorDialog。此示例要求从一个现有窗体调用该方法,且该窗体上须有一个 TextBox 和 Button。
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;
}
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
线程安全
此类型的任何公共静态(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