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)	원격 개체와 통신하는 데 사용되는 프록시 생성에 필요한 모든 관련 정보가 들어 있는 개체를 만듭니다. (다음에서 상속됨 MarshalByRefObject)
Dispose()	Component에서 사용하는 모든 리소스를 해제합니다. (다음에서 상속됨 Component)
Dispose(Boolean)	Component에서 사용하는 관리되지 않는 리소스를 해제하고, 관리되는 리소스를 선택적으로 해제할 수 있습니다. (다음에서 상속됨 Component)
Equals(Object)	지정된 개체가 현재 개체와 같은지 확인합니다. (다음에서 상속됨 Object)
GetHashCode()	기본 해시 함수로 작동합니다. (다음에서 상속됨 Object)
GetLifetimeService()	이 인스턴스의 수명 정책을 제어하는 현재의 수명 서비스 개체를 검색합니다. (다음에서 상속됨 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)	일반 대화 상자에 특정 기능을 추가하도록 재정의된 소유자 창 프로시저를 정의합니다. (다음에서 상속됨 CommonDialog)
Reset()	모든 옵션을 해당 기본값으로, 마지막으로 선택한 색을 검정으로, 사용자 지정 색을 해당 기본값으로 다시 설정합니다.
RunDialog(IntPtr)	파생 클래스에서 재정의된 경우 일반 대화 상자를 지정합니다.
ShowDialog()	기본 소유자로 일반 대화 상자를 실행합니다. (다음에서 상속됨 CommonDialog)
ShowDialog(IWin32Window)	지정된 소유자로 일반 대화 상자를 실행합니다. (다음에서 상속됨 CommonDialog)
ToString()	ColorDialog를 나타내는 문자열을 반환합니다.

이벤트

Disposed	Dispose() 메서드를 호출하여 구성 요소를 삭제할 때 발생합니다. (다음에서 상속됨 Component)
HelpRequest	일반 대화 상자의 도움말 단추를 클릭하면 발생합니다. (다음에서 상속됨 CommonDialog)

추가 정보

• CommonDialog