ColorDialog 類別

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

表示會顯示可用色彩的通用對話方塊，其附帶的控制項可讓使用者定義自訂色彩。

public ref class ColorDialog : System::Windows::Forms::CommonDialog

public class ColorDialog : System.Windows.Forms.CommonDialog

type ColorDialog = class
    inherit CommonDialog

Public Class ColorDialog
Inherits CommonDialog

繼承

Object

MarshalByRefObject

Component

CommonDialog

ColorDialog

範例

下列範例說明如何建立新的 ColorDialog 。 這個範例會要求從現有表單內呼叫 方法，該表單中具有 TextBox 並 Button 置於該表單上。

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() == ::System::Windows::Forms::DialogResult::OK )
      {
         textBox1->ForeColor = MyDialog->Color;
      }
   }

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 Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button1.Click
    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() = Windows.Forms.DialogResult.OK) Then
        TextBox1.ForeColor = MyDialog.Color
    End If
End Sub

備註

必須叫用繼承的成員 ShowDialog ，才能建立這個特定的通用對話方塊。 HookProc 可以覆寫以實作特定的對話方塊勾點功能。 用來 Color 擷取使用者選取的色彩。

當您建立 的 ColorDialog 實例時，某些讀取/寫入屬性會設定為初始值。 如需這些值的清單，請參閱建 ColorDialog 構函式。

建構函式

ColorDialog()

初始化 ColorDialog 類別的新執行個體。

屬性

AllowFullOpen	取得或設定值，指出使用者是否可以使用對話方塊來定義自訂色彩。
AnyColor	取得或設定值，指出對話方塊是否顯示基本色彩集中的所有可用色彩。
CanRaiseEvents	取得值，指出元件是否能引發事件。 (繼承來源 Component)
Color	取得或設定使用者所選取的色彩。
Container	取得包含 IContainer 的 Component。 (繼承來源 Component)
CustomColors	取得或設定對話方塊中顯示的自訂色彩集。
DesignMode	取得值，指出 Component 目前是否處於設計模式。 (繼承來源 Component)
Events	取得附加在這個 Component 上的事件處理常式清單。 (繼承來源 Component)
FullOpen	取得或設定值，指出開啟對話方塊時，是否可以看到用來建立自訂色彩的控制項。
Instance	取得基礎視窗執行個體控制代碼 (HINSTANCE)。
Options	取得值來初始化 ColorDialog。
ShowHelp	取得或設定值，指出是否在色彩對話方塊中顯示 [說明] 按鈕。
Site	取得或設定 Component 的 ISite。 (繼承來源 Component)
SolidColorOnly	取得或設定值，指出對話方塊是否限制使用者只能選取純色。
Tag	取得或設定包含控制項相關資料的物件。 (繼承來源 CommonDialog)

方法

CreateObjRef(Type)	建立包含所有相關資訊的物件，這些資訊是產生用來與遠端物件通訊的所需 Proxy。 (繼承來源 MarshalByRefObject)
Dispose()	釋放 Component 所使用的所有資源。 (繼承來源 Component)
Dispose(Boolean)	釋放 Component 所使用的 Unmanaged 資源，並選擇性地釋放 Managed 資源。 (繼承來源 Component)
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetLifetimeService()	擷取控制這個執行個體存留期 (Lifetime) 原則的目前存留期服務物件。 (繼承來源 MarshalByRefObject)
GetService(Type)	傳回表示 Component 或其 Container 所提供之服務的物件。 (繼承來源 Component)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)	定義為了將特定功能加入通用對話方塊中而覆寫的通用對話方塊攔截程序。 (繼承來源 CommonDialog)
InitializeLifetimeService()	取得存留期服務物件，以控制這個執行個體的存留期原則。 (繼承來源 MarshalByRefObject)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
MemberwiseClone(Boolean)	建立目前 MarshalByRefObject 物件的淺層複本。 (繼承來源 MarshalByRefObject)
OnHelpRequest(EventArgs)	引發 HelpRequest 事件。 (繼承來源 CommonDialog)
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)	定義為了將特定功能加入通用對話方塊中而覆寫的主控視窗 (Owner Window) 程序。 (繼承來源 CommonDialog)
Reset()	重設所有選項為其預設值、最後選取的色彩為黑色，以及自訂色彩為其預設值。
RunDialog(IntPtr)	在衍生類別中覆寫時，指定通用對話方塊。
ShowDialog()	以預設的擁有人來執行通用對話方塊。 (繼承來源 CommonDialog)
ShowDialog(IWin32Window)	以指定的擁有人來執行通用對話方塊。 (繼承來源 CommonDialog)
ToString()	傳回表示 ColorDialog 的字串。

事件

Disposed	當 Dispose() 方法的呼叫處置元件時，就會發生。 (繼承來源 Component)
HelpRequest	發生於使用者按一下通用對話方塊上的 [說明] 按鈕時。 (繼承來源 CommonDialog)

另請參閱

• CommonDialog