Control.CreateParams Propriedade
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém os parâmetros de criação necessários quando a alça de controle é criada.
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
Um CreateParams que contém os parâmetros de criação necessários quando a alça de controle é criada.
O exemplo de código a seguir estende a CreateParams propriedade de uma Button classe derivada. A CreateParams.Style propriedade é alterada, o que faz com que o botão exiba um Icon em vez de um Image. Este exemplo exige que você tenha uma classe herdada da Button classe.
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
{
// 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
A CreateParams propriedade não deve ser substituída e usada para ajustar as propriedades do controle derivado. Propriedades como o CreateParams.Caption, CreateParams.Widthe CreateParams.Height devem ser definidas pelas propriedades correspondentes em seu controle, como Control.Text, Control.Width e Control.Height. O CreateParams deve ser estendido somente quando você estiver encapsulando uma classe de controle padrão do Windows ou para definir estilos não fornecidos pelo namespace Windows Forms. Para obter mais informações sobre como criar parâmetros de controle, consulte a documentação e CreateWindowEx
as CreateWindow
funções e a estrutura CREATETRUCT.
Ao substituir a CreateParams propriedade em uma classe derivada, use a propriedade da CreateParams classe base para estender a implementação base. Caso contrário, você deve fornecer toda a implementação.
Produto | Versões |
---|---|
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8 |
Windows Desktop | 3.0, 3.1, 5, 6, 7 |