Label.AutoSize Eigenschaft

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Ruft einen Wert ab, der angibt, ob die Größe des Steuerelements automatisch an dessen Inhalt angepasst wird, oder legt diesen fest.

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

Eigenschaftswert

Boolean

true, wenn das Steuerelement seine Breite dem Inhalt möglichst genau anpasst, andernfalls false. Beim Hinzufügen zu einem Formular mithilfe des Designers ist der Standardwert true. Bei der Instanziierung von Code ist der Standardwert false.

Attribute
BrowsableAttribute

Beispiele

Im folgenden Codebeispiel wird die AutoSize Eigenschaft veranschaulicht. Um dieses Beispiel auszuführen, fügen Sie den folgenden Code in ein Formular ein, und rufen Sie die Methode aus dem Konstruktor oder Load der InitializeLabel Methode des Formulars auf.

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

Hinweise

Wenn diese Eigenschaft auf true"" festgelegt ist, passt die Label Breite an, um den gesamten Inhalt anzuzeigen. Diese Eigenschaft wird normalerweise festgelegt true , wenn Sie ein Label Steuerelement verwenden, um verschiedene Textlängen anzuzeigen, z. B. den Status eines Anwendungsprozesses. Sie können diese Eigenschaft auch verwenden, wenn die Anwendung Text in verschiedenen Sprachen anzeigt, und die Größe des Texts kann basierend auf den Spracheinstellungen in Windows erhöht oder verkleinert werden.

Wichtig

Wenn die Schriftart größer als die Höhe des Label Und AutoEllipsis ist true, müssen Sie festlegen AutoSize , dass false Text gezeichnet werden soll.

Gilt für

Siehe auch