Control.CreateParams 속성

정의

컨트롤 핸들이 만들어지는 경우 필요한 작성 매개 변수를 가져옵니다.Gets the required creation parameters when the control handle is created.

protected:
 virtual property System::Windows::Forms::CreateParams ^ CreateParams { System::Windows::Forms::CreateParams ^ get(); };
protected virtual System.Windows.Forms.CreateParams CreateParams { get; }
member this.CreateParams : System.Windows.Forms.CreateParams
Protected Overridable ReadOnly Property CreateParams As CreateParams

속성 값

컨트롤 핸들을 만들 때 필요한 작성 매개 변수가 포함된 CreateParams입니다.A CreateParams that contains the required creation parameters when the handle to the control is created.

예제

다음 코드 예제에서는 Button 파생 클래스의 CreateParams 속성을 확장 합니다.The following code example extends the CreateParams property of a Button derived class. CreateParams.Style 속성이 변경 되어 단추가 Image아닌 Icon 표시 되도록 합니다.The CreateParams.Style property is changed, which causes the button to display an Icon rather than an Image. 이 예제에서는 Button 클래스에서 상속 되는 클래스가 필요 합니다.This example requires that you have a class that inherits from the Button class.

virtual System::Windows::Forms::CreateParams^ get() override
{
   
   // Extend the CreateParams property of the Button class.
   System::Windows::Forms::CreateParams^ cp = __super::CreateParams;

   // Update the button Style.
   cp->Style |= 0x00000040; // BS_ICON value
   return cp;
}
protected override CreateParams CreateParams
{
    get
    {
        new SecurityPermission(SecurityPermissionFlag.UnmanagedCode).Demand();

        // Extend the CreateParams property of the Button class.
        CreateParams cp = base.CreateParams;
        // Update the button Style.
        cp.Style |= 0x00000040; // BS_ICON value

        return cp;
    }
}

Protected Overrides ReadOnly Property CreateParams() As System.Windows.Forms.CreateParams
    Get
        Dim SecPerm As New SecurityPermission(SecurityPermissionFlag.UnmanagedCode)
        SecPerm.Demand()

        ' Extend the CreateParams property of the Button class.
        Dim cp As System.Windows.Forms.CreateParams = MyBase.CreateParams
        ' Update the button Style.
        cp.Style = cp.Style Or &H40 ' BS_ICON value

        Return cp
    End Get
End Property

설명

파생 된 컨트롤의 속성을 조정 하는 데 CreateParams 속성을 재정의 하 고 사용 하면 안 됩니다.The CreateParams property should not be overridden and used to adjust the properties of your derived control. CreateParams.Caption, CreateParams.WidthCreateParams.Height와 같은 속성은 Control.Text, Control.WidthControl.Height와 같은 컨트롤의 해당 속성으로 설정 해야 합니다.Properties such as the CreateParams.Caption, CreateParams.Width, and CreateParams.Height should be set by the corresponding properties in your control such as Control.Text, Control.Width and Control.Height. 표준 Windows 컨트롤 클래스를 래핑할 때 또는 Windows Forms 네임 스페이스에서 제공 하지 않는 스타일을 설정 하는 경우에만 CreateParams을 확장 해야 합니다.The CreateParams should only be extended when you are wrapping a standard Windows control class or to set styles not provided by the Windows Forms namespace. 컨트롤 매개 변수를 만드는 방법에 대 한 자세한 내용은 CreateWindowCreateWindowEx 함수 및 Createstruct 구조체 설명서를 참조 하세요.For more information about creating control parameters, see the CreateWindow and CreateWindowEx functions and the CREATESTRUCT structure documentation.

상속자 참고

파생 클래스에서 CreateParams 속성을 재정의 하는 경우 기본 클래스의 CreateParams 속성을 사용 하 여 기본 구현을 확장 합니다.When overriding the CreateParams property in a derived class, use the base class's CreateParams property to extend the base implementation. 그렇지 않으면 모든 구현을 제공 해야 합니다.Otherwise, you must provide all the implementation.

보안

SecurityPermission
속성 값을 가져올 때 직접 실행 호출자가 비관리 코드를 호출 하는 경우for the immediate caller to call unmanaged code when getting the property value. 연결 된 열거형: UnmanagedCodeAssociated enumeration: UnmanagedCode

적용 대상

추가 정보