Label.AutoSize Свойство

Определение

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

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

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

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

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

Boolean

Значение true, если размеры элемента управления подгоняются под ширину его содержимого; в противном случае — false. При добавлении в форму с использованием конструктора значение по умолчанию —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, необходимо задать для false AutoSize trueрисования текста.

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

• Text
• PreferredHeight
• PreferredWidth
• AutoEllipsis