Label.AutoSize-Eigenschaft

Artikel
08/20/2007

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

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
<LocalizableAttribute(True)> _
Public Overrides Property AutoSize As Boolean
'Usage
Dim instance As Label
Dim value As Boolean

value = instance.AutoSize

instance.AutoSize = value

[LocalizableAttribute(true)] 
public override bool AutoSize { get; set; }

[LocalizableAttribute(true)] 
public:
virtual property bool AutoSize {
    bool get () override;
    void set (bool value) override;
}

/** @property */
public boolean get_AutoSize ()

/** @property */
public void set_AutoSize (boolean value)

public override function get AutoSize () : boolean

public override function set AutoSize (value : boolean)

Eigenschaftenwert

true, wenn das Steuerelement seine Breite dem Inhalt möglichst genau anpasst, andernfalls false. Der Standardwert ist false.

Hinweise

Wenn diese Eigenschaft auf true festgelegt ist, passt das Label die Breite so an, dass der gesamte Inhalt angezeigt wird. Üblicherweise wird diese Eigenschaft auf true festgelegt, wenn ein Label-Steuerelement zur Anzeige von Texten unterschiedlicher Länge verwendet wird, beispielsweise für den Status eines Anwendungsprozesses. Diese Eigenschaft kann auch dann verwendet werden, wenn die Anwendung Text in verschiedenen Sprachen anzeigen soll und die Länge des Texts von den für Windows gewählten Spracheinstellungen abhängt.

Wichtig

Wenn die Schrift größer ist als Label, und wenn AutoEllipsistrue ist, müssen Sie für AutoSizefalse festlegen, damit der Text gezeichnet wird.

Beispiel

Im folgenden Codebeispiel wird die AutoSize-Eigenschaft veranschaulicht. Fügen Sie folgenden Code in ein Formular ein, um dieses Beispiel auszuführen, und rufen Sie die InitializeLabel-Methode im Konstruktor des Formulars oder die Load-Methode auf.

' 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

// 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.
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.
private System.Windows.Forms.Label label1;

// Initialize the label.
private void InitializeLabel()
{
    this.label1 = new Label();
    this.label1.set_Location(new System.Drawing.Point(10, 10));
    this.label1.set_Name("label1");
    this.label1.set_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.set_Size(new System.Drawing.Size(10, 10));
    this.get_Controls().Add(this.label1);
    this.label1.set_AutoSize(true);
    this.label1.set_Text("The text in this label is longer" 
        + " than the set size.");
} //InitializeLabel

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

Label-Klasse
Label-Member
System.Windows.Forms-Namespace
Control.Text-Eigenschaft
PreferredHeight
PreferredWidth
Label.AutoEllipsis-Eigenschaft

Freigeben über