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.

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

Valeur de propriété

Boolean

true si le contrôle ajuste sa largeur pour correspondre étroitement à son contenu ; sinon, false. En cas d'ajout à un formulaire à l'aide du concepteur, la valeur par défaut est true. En cas d'instanciation de code, la valeur par défaut est false.

Attributs

Exemples

L’exemple de code suivant illustre la AutoSize propriété. Pour exécuter cet exemple, collez le code suivant dans un formulaire et appelez la méthode à partir du constructeur ou Load de la InitializeLabel méthode du formulaire.

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

Lorsque cette propriété est définie sur true, la Label largeur ajuste sa largeur pour afficher son contenu entier. Cette propriété est généralement définie true lorsque vous utilisez un Label contrôle pour afficher différentes longueurs de texte, telles que l’état d’un processus d’application. 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 dans Windows.

Important

Si la police est plus haute que la hauteur du Label texte et AutoEllipsis est true, vous devez définir AutoSize la valeur pour false que le texte soit dessiné.

S’applique à

Voir aussi