Label.AutoSize Свойство

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Исходный код:

Label.cs

Возвращает или задает значение, указывающее, изменяется ли элемент управления автоматически для отображения всего содержимого.

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

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

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

Public Overrides Property AutoSize As Boolean

Значение свойства

Boolean

Значение в противном случае . При добавлении в форму с помощью конструктора значение по умолчанию равно true. При создании экземпляра из кода используется falseзначение по умолчанию.

Атрибуты

BrowsableAttribute

Примеры

В следующем примере кода демонстрируется AutoSize свойство. Чтобы запустить этот пример, вставьте следующий код в форму и вызовите InitializeLabel метод из конструктора или Load метода формы.

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

Комментарии

Если для этого свойства задано trueзначение, Label ширина настраивается для отображения всего содержимого. Обычно это свойство устанавливается true при использовании Label элемента управления для отображения различных длин текста, например состояния процесса приложения. Это свойство также можно использовать, если приложение будет отображать текст на различных языках, а размер текста может увеличиваться или уменьшаться на основе параметров языка в Windows.

Это важно

Если шрифт выше высоты и AutoEllipsis имеет высотуLabel, необходимо задать AutoSize для falsetrueрисования текста.

См. также раздел

• Text
• PreferredHeight
• PreferredWidth
• AutoEllipsis