Label.AutoSize Label.AutoSize Label.AutoSize Label.AutoSize Property

Определение

Получает или задает значение, указывающее, изменяются ли размеры элемента управления автоматически для отображения всего его содержимого.Gets or sets a value indicating whether the control is automatically resized to display its entire contents.

public:
 virtual property bool AutoSize { bool get(); void set(bool value); };
[System.ComponentModel.Browsable(true)]
public override bool AutoSize { get; set; }
member this.AutoSize : bool with get, set
Public Overrides Property AutoSize As Boolean

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

Значение true, если размеры элемента управления подгоняются под ширину его содержимого; в противном случае — false.true if the control adjusts its width to closely fit its contents; otherwise, false.

При добавлении в форму с использованием конструктора значение по умолчанию —true.When added to a form using the designer, the default value is true. При создании экземпляра из кода значение по умолчанию — false.When instantiated from code, the default value is false.

Примеры

В следующем примере кода показано AutoSize свойство.The following code example demonstrates the AutoSize property. Чтобы выполнить этот пример, вставьте следующий код в форму и вызовите InitializeLabel метод из конструктора или Load метода формы.To run this example, paste the following code in a form and call the InitializeLabel method from the form's constructor or Load method.

   // 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 то параметр изменяет ширину для вывода всего содержимого.When this property is set to true, the Label adjusts its width to display its entire contents. Обычно это свойство имеет значение true при Label использовании элемента управления для вывода различной длины текста, например состояния процесса приложения.This property is typically set to true when you use a Label control to display various lengths of text, such as the status of an application process. Это свойство также можно использовать, когда приложение будет отображать текст на различных языках, а размер текста может увеличиваться или уменьшаться в зависимости от языковых параметров в Windows.You can also use this property when the application will display text in various languages, and the size of the text might increase or decrease based on the language settings in Windows.

Важно!

Label Если шрифт превышает высоту объекта и AutoEllipsis имеет trueзначение, то для отображения текста необходимо задать AutoSize false параметр.If the font is taller than the height of the Label and AutoEllipsis is true, you must set AutoSize to false for text to be drawn.

Применяется к

Дополнительно