Control.CreateParams Propriedade

Definição

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

protected virtual System.Windows.Forms.CreateParams CreateParams { get; }

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.

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;
    }
}

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

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

Confira também