Label.AutoSize Proprietà

Riferimento

Definizione

Spazio dei nomi:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Ottiene o imposta un valore che indica se il controllo viene automaticamente ridimensionato per visualizzare tutto il contenuto.

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

public virtual bool AutoSize { get; set; }

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

member this.AutoSize : bool with get, set

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

Public Overridable Property AutoSize As Boolean

Public Overrides Property AutoSize As Boolean

Valore della proprietà

Boolean

true se la larghezza del controllo viene regolata in base al contenuto; in caso contrario, false. Quando viene aggiunto a un form tramite la finestra di progettazione, il valore predefinito è true. Quando ne viene creata un'istanza dal codice, il valore predefinito è false.

Attributi: BrowsableAttribute

Esempio

Nell'esempio di codice seguente viene illustrata la AutoSize proprietà . Per eseguire questo esempio, incollare il codice seguente in un modulo e chiamare il InitializeLabel metodo dal costruttore o Load dal metodo del modulo.

   // 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

Commenti

Quando questa proprietà è impostata su true, la Label regola la relativa larghezza per visualizzarne l'intero contenuto. Questa proprietà è in genere impostata su true quando si usa un controllo per visualizzare varie lunghezze di testo, ad esempio lo stato di un Label processo dell'applicazione. È anche possibile usare questa proprietà quando l'applicazione visualizzerà il testo in varie lingue e le dimensioni del testo potrebbero aumentare o diminuire in base alle impostazioni della lingua in Windows.

Importante

Se il tipo di carattere è più alto dell'altezza di Label e AutoEllipsis è true, è necessario impostare AutoSize su false per il testo da disegnare.

Si applica a

Prodotto	Versioni
.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

Condividi tramite