ColorDialog ColorDialog ColorDialog ColorDialog Class

정의

사용자가 사용자 지정 색을 정의하는 데 사용할 수 있는 컨트롤과 함께 사용 가능한 색을 표시하는 일반 대화 상자를 나타냅니다.Represents a common dialog box that displays available colors along with controls that enable the user to define custom colors.

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
상속

예제

다음 예제를 만드는 새 ColorDialog합니다.The following example illustrates the creation of new ColorDialog. 이 예제에서는 메서드에 있는 기존 폼 내에서 호출 되는 한 TextBoxButton 배치 합니다.This example requires that the method is called from within an existing form that has a TextBox and Button placed on it.

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 만들기이 특정 공용 대화 상자를 호출 해야 합니다.The inherited member ShowDialog must be invoked to create this specific common dialog box. HookProc 특정 대화 상자 후크 기능을 구현 하도록 재정의할 수 있습니다.HookProc can be overridden to implement specific dialog box hook functionality. 사용 하 여 Color 에 사용자가 선택한 색을 검색 합니다.Use Color to retrieve the color selected by the user.

인스턴스를 만들면 ColorDialog, 읽기/쓰기 속성 중 일부를 초기 값으로 설정 됩니다.When you create an instance of ColorDialog, some of the read/write properties are set to initial values. 이러한 값의 목록을 보려면 참조는 ColorDialog 생성자입니다.For a list of these values, see the ColorDialog constructor.

생성자

ColorDialog() ColorDialog() ColorDialog() ColorDialog()

ColorDialog 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the ColorDialog class.

속성

AllowFullOpen AllowFullOpen AllowFullOpen AllowFullOpen

대화 상자를 사용하여 사용자 지정 색을 정의할 수 있는지를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating whether the user can use the dialog box to define custom colors.

AnyColor AnyColor AnyColor AnyColor

대화 상자에서 기본 색 집합에 있는 색 중 사용 가능한 색이 모두 표시되는지를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating whether the dialog box displays all available colors in the set of basic colors.

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

구성 요소가 이벤트를 발생시킬 수 있는지 여부를 나타내는 값을 가져옵니다.Gets a value indicating whether the component can raise an event.

(Inherited from Component)
Color Color Color Color

선택한 색을 가져오거나 설정합니다.Gets or sets the color selected by the user.

Container Container Container Container

IContainer가 포함된 Component를 가져옵니다.Gets the IContainer that contains the Component.

(Inherited from Component)
CustomColors CustomColors CustomColors CustomColors

대화 상자에 표시된 사용자 지정 색 집합을 가져오거나 설정합니다.Gets or sets the set of custom colors shown in the dialog box.

DesignMode DesignMode DesignMode DesignMode

Component가 현재 디자인 모드인지 여부를 나타내는 값을 가져옵니다.Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
Events Events Events Events

Component에 연결된 이벤트 처리기의 목록을 가져옵니다.Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
FullOpen FullOpen FullOpen FullOpen

대화 상자가 열려 있을 때 사용자 지정 색을 만드는 데 사용되는 컨트롤을 볼 수 있는지를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating whether the controls used to create custom colors are visible when the dialog box is opened

Instance Instance Instance Instance

내부 창 인스턴스 핸들(HINSTANCE)을 가져옵니다.Gets the underlying window instance handle (HINSTANCE).

Options Options Options Options

ColorDialog를 초기화할 값을 가져옵니다.Gets values to initialize the ColorDialog.

ShowHelp ShowHelp ShowHelp ShowHelp

도움말 단추가 색 대화 상자에 표시되는지를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating whether a Help button appears in the color dialog box.

Site Site Site Site

ComponentISite를 가져오거나 설정합니다.Gets or sets the ISite of the Component.

(Inherited from Component)
SolidColorOnly SolidColorOnly SolidColorOnly SolidColorOnly

대화 상자에서 단색만 선택할 수 있는지를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating whether the dialog box will restrict users to selecting solid colors only.

Tag Tag Tag Tag

컨트롤에 대한 데이터가 들어 있는 개체를 가져오거나 설정합니다.Gets or sets an object that contains data about the control.

(Inherited from CommonDialog)

메서드

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

원격 개체와 통신하는 데 사용되는 프록시 생성에 필요한 모든 관련 정보가 들어 있는 개체를 만듭니다.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

Component에서 사용하는 모든 리소스를 해제합니다.Releases all resources used by the Component.

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Component에서 사용하는 관리되지 않는 리소스를 해제하고, 관리되는 리소스를 선택적으로 해제할 수 있습니다.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Inherited from Component)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

지정한 개체와 현재 개체가 같은지 여부를 확인합니다.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

이 인스턴스의 수명 정책을 제어하는 현재의 수명 서비스 개체를 검색합니다.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Component 또는 해당 Container에서 제공하는 서비스를 나타내는 개체를 반환합니다.Returns an object that represents a service provided by the Component or by its Container.

(Inherited from Component)
GetType() GetType() GetType() GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(Inherited from Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr) HookProc(IntPtr, Int32, IntPtr, IntPtr) HookProc(IntPtr, Int32, IntPtr, IntPtr) HookProc(IntPtr, Int32, IntPtr, IntPtr)

일반 대화 상자에 특정 기능을 추가하도록 재정의된 일반 대화 상자의 후크 프로시저를 정의합니다.Defines the common dialog box hook procedure that is overridden to add specific functionality to a common dialog box.

(Inherited from CommonDialog)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

이 인스턴스의 수명 정책을 제어하는 수명 서비스 개체를 가져옵니다.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

현재 MarshalByRefObject 개체의 단순 복사본을 만듭니다.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
OnHelpRequest(EventArgs) OnHelpRequest(EventArgs) OnHelpRequest(EventArgs) OnHelpRequest(EventArgs)

HelpRequest 이벤트를 발생시킵니다.Raises the HelpRequest event.

(Inherited from CommonDialog)
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr) OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr) OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr) OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)

일반 대화 상자에 특정 기능을 추가하도록 재정의된 소유자 창 프로시저를 정의합니다.Defines the owner window procedure that is overridden to add specific functionality to a common dialog box.

(Inherited from CommonDialog)
Reset() Reset() Reset() Reset()

모든 옵션을 해당 기본값으로, 마지막으로 선택한 색을 검정으로, 사용자 지정 색을 해당 기본값으로 다시 설정합니다.Resets all options to their default values, the last selected color to black, and the custom colors to their default values.

RunDialog(IntPtr) RunDialog(IntPtr) RunDialog(IntPtr) RunDialog(IntPtr)

파생 클래스에서 재정의된 경우 일반 대화 상자를 지정합니다.When overridden in a derived class, specifies a common dialog box.

ShowDialog() ShowDialog() ShowDialog() ShowDialog()

기본 소유자로 일반 대화 상자를 실행합니다.Runs a common dialog box with a default owner.

(Inherited from CommonDialog)
ShowDialog(IWin32Window) ShowDialog(IWin32Window) ShowDialog(IWin32Window) ShowDialog(IWin32Window)

지정된 소유자로 일반 대화 상자를 실행합니다.Runs a common dialog box with the specified owner.

(Inherited from CommonDialog)
ToString() ToString() ToString() ToString()

ColorDialog를 나타내는 문자열을 반환합니다.Returns a string that represents the ColorDialog.

이벤트

Disposed Disposed Disposed Disposed

Dispose() 메서드를 호출하여 구성 요소가 삭제되는 경우 발생합니다.Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)
HelpRequest HelpRequest HelpRequest HelpRequest

일반 대화 상자의 도움말 단추를 클릭하면 발생합니다.Occurs when the user clicks the Help button on a common dialog box.

(Inherited from CommonDialog)

적용 대상

추가 정보