Compartilhar via

Control.CreateParams Propriedade

  • Referência

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

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

Valor da propriedade

CreateParams

Um CreateParams que contém os parâmetros de criação necessários quando a alça de controle é criada.

Exemplos

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

Comentários

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.

Notas aos Herdeiros

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.

Aplica-se a

Confira também