TextBoxBase.AutoSize Propriedade

Referência

Definição

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

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 ou define um valor que indica se a altura do controle é ajustada automaticamente quando a fonte atribuída ao controle é alterada.

public:
 virtual property bool AutoSize { bool get(); void set(bool value); };

public virtual bool AutoSize { get; set; }

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

member this.AutoSize : bool with get, set

[<System.ComponentModel.Browsable(false)>]
member this.AutoSize : bool with get, set

Public Overridable Property AutoSize As Boolean

Public Overrides Property AutoSize As Boolean

Valor da propriedade

Boolean

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

Atributos: BrowsableAttribute

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

Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button1.Click

    Me.TextBox1.AutoSize = True
    Me.TextBox1.Text = "Hello world!"
    Me.TextBox1.Font = New System.Drawing.Font("Arial", 10, FontStyle.Regular)

    Me.TextBox2.AutoSize = False
    Me.TextBox2.Text = "Hello world!"
    Me.TextBox2.Font = New System.Drawing.Font("Arial", 10, FontStyle.Regular)
End Sub


Private Sub Button2_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button2.Click

    Me.TextBox1.AutoSize = True
        Me.TextBox1.Text = "Goodbye world!"
    Me.TextBox1.Font = New System.Drawing.Font("ArialBlack", 14, FontStyle.Regular)

    Me.TextBox2.AutoSize = False
        Me.TextBox2.Text = "Goodbye world!"
    Me.TextBox2.Font = New System.Drawing.Font("ArialBlack", 14, FontStyle.Regular)
End Sub

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

Compartilhar via