Label.AutoSize Propriedade

Definição

Obtém ou define um valor que indica se o controle é redimensionado automaticamente para exibir todo o seu conteúdo.Gets or sets a value indicating whether the control is automatically resized to display its entire contents.

public:
 virtual property bool AutoSize { bool get(); void set(bool value); };
[System.ComponentModel.Browsable(true)]
public override bool AutoSize { get; set; }
public virtual bool AutoSize { get; set; }
member this.AutoSize : bool with get, set
Public Overrides Property AutoSize As Boolean
Public Overridable Property AutoSize As Boolean

Valor da propriedade

true se o controle se ajusta à sua largura para que o conteúdo caiba; caso contrário, false.true if the control adjusts its width to closely fit its contents; otherwise, false.


Quando adicionado a um formulário usando o designer, o valor padrão é true.When added to a form using the designer, the default value is true. Quando uma instância for criada por meio do código, o valor padrão será false.When instantiated from code, the default value is false.

Atributos

Exemplos

O exemplo de código a seguir demonstra a propriedade AutoSize.The following code example demonstrates the AutoSize property. Para executar este exemplo, Cole o código a seguir em um formulário e chame o método InitializeLabel no construtor do formulário ou no método Load.To run this example, paste the following code in a form and call the InitializeLabel method from the form's constructor or Load method.

   // Declare a label.
internal:
   System::Windows::Forms::Label ^ Label1;

private:

   // Initialize the label.
   void InitializeLabel()
   {
      this->Label1 = gcnew Label;
      this->Label1->Location = System::Drawing::Point( 10, 10 );
      this->Label1->Name = "Label1";
      this->Label1->TabIndex = 0;
      
      // Set the label to a small size, but set the AutoSize property 
      // to true. The label will adjust its length so all the text
      // is visible, however if the label is wider than the form,
      // the entire label will not be visible.
      this->Label1->Size = System::Drawing::Size( 10, 10 );
      this->Controls->Add( this->Label1 );
      this->Label1->AutoSize = true;
      this->Label1->Text = "The text in this label is longer"
      " than the set size.";
   }
// Declare a label.
internal System.Windows.Forms.Label Label1;

// Initialize the label.
private void InitializeLabel()
{
    this.Label1 = new Label();
    this.Label1.Location = new System.Drawing.Point(10, 10);
    this.Label1.Name = "Label1";
    this.Label1.TabIndex = 0;

    // Set the label to a small size, but set the AutoSize property 
    // to true. The label will adjust its length so all the text
    // is visible, however if the label is wider than the form,
    // the entire label will not be visible.
    this.Label1.Size = new System.Drawing.Size(10, 10);
    this.Controls.Add(this.Label1);
    this.Label1.AutoSize = true;
    this.Label1.Text = "The text in this label is longer" +  
        " than the set size.";
}
' Declare a label.
Friend WithEvents Label1 As System.Windows.Forms.Label

' Initialize the label.
Private Sub InitializeLabel()
    Me.Label1 = New Label
    Me.Label1.Location = New System.Drawing.Point(10, 10)
    Me.Label1.Name = "Label1"
    Me.Label1.TabIndex = 0

    ' Set the label to a small size, but set the AutoSize property 
    ' to true. The label will adjust its length so all the text
    ' is visible, however if the label is wider than the form,
    ' the entire label will not be visible.
    Me.Label1.Size = New System.Drawing.Size(10, 10)
    Me.Controls.Add(Me.Label1)
    Me.Label1.AutoSize = True
    Me.Label1.Text = "The text in this label is longer than the set size."

End Sub

Comentários

Quando essa propriedade é definida como true, a Label ajusta sua largura para exibir todo o conteúdo.When this property is set to true, the Label adjusts its width to display its entire contents. Essa propriedade normalmente é definida como true quando você usa um controle de Label para exibir vários comprimentos de texto, como o status de um processo de aplicativo.This property is typically set to true when you use a Label control to display various lengths of text, such as the status of an application process. Você também pode usar essa propriedade quando o aplicativo exibir texto em vários idiomas, e o tamanho do texto pode aumentar ou diminuir com base nas configurações de idioma no Windows.You can also use this property when the application will display text in various languages, and the size of the text might increase or decrease based on the language settings in Windows.

Importante

Se a fonte for mais alta do que a altura do Label e AutoEllipsis for true, você deverá definir AutoSize para false para o texto a ser desenhado.If the font is taller than the height of the Label and AutoEllipsis is true, you must set AutoSize to false for text to be drawn.

Aplica-se a

Veja também