TextBoxBase.AutoSize Propriedade

Definição

Obtém ou define um valor que indica se a altura do controle é ajustada automaticamente quando a fonte atribuída ao controle é alterada.

public virtual bool AutoSize { get; set; }
[System.ComponentModel.Browsable(false)]
public override bool AutoSize { get; set; }

Valor da propriedade

true se a altura do controle é ajustada automaticamente quando a fonte é alterada; caso contrário, false. O padrão é true.

Atributos

Exemplos

Este exemplo pressupõe que você tenha um formulário com duas caixas de texto, dois botões e eventos de clique para cada um dos botões. O exemplo demonstra a propriedade definindo-a AutoSizetrue como para uma caixa de texto e false para a outra. Quando você clica em um botão, as caixas de texto são preenchidas com um texto menor e, quando você clica no outro botão, as caixas de texto são preenchidas com texto maior. A caixa de texto que foi AutoSize definida como true se expande em altura para acomodar o texto maior. A largura não é alterada.

private void button1_Click(object sender, EventArgs e)
{
    this.textBox1.AutoSize = true;
    this.textBox1.Text = "Hello world!";
    this.textBox1.Font = new System.Drawing.Font("Arial", 10, FontStyle.Regular);

    this.textBox2.AutoSize = false;
    this.textBox2.Text = "Hello world!";
    this.textBox2.Font = new System.Drawing.Font("Arial", 10, FontStyle.Regular);
}

private void button2_Click(object sender, EventArgs e)
{
    this.textBox1.AutoSize = true;
    this.textBox1.Text = "Goodbye world!";
    this.textBox1.Font = new System.Drawing.Font("ArialBlack", 14, FontStyle.Regular);

    this.textBox2.AutoSize = false;
    this.textBox2.Text = "Goodbye world!";
    this.textBox2.Font = new System.Drawing.Font("ArialBlack", 14, FontStyle.Regular);
}

Comentários

Quando você define a AutoSize propriedade true como para um TextBox, quando o Font é alterado, o TextBox expande ou contrai o Height para acomodar o texto maior ou menor. O Width do TextBox não é alterado.

Se você quiser alterar o tamanho do controle à medida que o usuário inserir texto, poderá usar um RichTextBox controle e usar seu ContentsResized evento para alterar seu tamanho.

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, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9