Label.AutoSize Propriété

Définition

Obtient ou définit une valeur indiquant si le contrôle est automatiquement redimensionné pour afficher l'ensemble de son contenu.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 virtual bool AutoSize { get; set; }
member this.AutoSize : bool with get, set
Public Overridable Property AutoSize As Boolean

Valeur de propriété

true si le contrôle ajuste sa largeur pour correspondre étroitement à son contenu ; sinon, false.true if the control adjusts its width to closely fit its contents; otherwise, false.


En cas d'ajout à un formulaire à l'aide du concepteur, la valeur par défaut est true.When added to a form using the designer, the default value is true. En cas d'instanciation de code, la valeur par défaut est false.When instantiated from code, the default value is false.

Attributs

Exemples

L’exemple de code suivant illustre la propriété AutoSize.The following code example demonstrates the AutoSize property. Pour exécuter cet exemple, collez le code suivant dans un formulaire et appelez la méthode InitializeLabel à partir du constructeur du formulaire ou de la méthode 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

Remarques

Quand cette propriété a la valeur true, la Label ajuste sa largeur pour afficher tout son contenu.When this property is set to true, the Label adjusts its width to display its entire contents. Cette propriété est généralement définie sur true lorsque vous utilisez un contrôle Label pour afficher différentes longueurs de texte, telles que l’état d’un processus d’application.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. Vous pouvez également utiliser cette propriété lorsque l’application affiche du texte dans différentes langues et que la taille du texte peut augmenter ou diminuer en fonction des paramètres de langue définis dans 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.

Important

Si la police est supérieure à la hauteur de la Label et que AutoEllipsis est true, vous devez définir AutoSize sur false pour le texte à dessiner.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.

S’applique à

Voir aussi