Label.PreferredHeight Propriété

  • Référence

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Obtient la hauteur préférée du contrôle.

public:
 virtual property int PreferredHeight { int get(); };
[System.ComponentModel.Browsable(false)]
public virtual int PreferredHeight { get; }
[<System.ComponentModel.Browsable(false)>]
member this.PreferredHeight : int
Public Overridable ReadOnly Property PreferredHeight As Integer

Valeur de propriété

Int32

Hauteur en pixels du contrôle, en supposant l'affichage d'une seule ligne de texte.

Attributs
BrowsableAttribute

Exemples

L’exemple de code suivant montre comment créer un Label contrôle qui a une bordure tridimensionnelle et une image affichée à l’aide des propriétés et ImageIndex des ImageList propriétés. Le contrôle a également une légende avec un caractère mnemonique spécifié. L’exemple de code utilise les propriétés et PreferredWidth les PreferredHeight propriétés pour dimensionner correctement le Label contrôle sur le formulaire sur lequel il est affiché. Cet exemple nécessite qu’une ImageList imagelist1 a été créée et nommée et qu’elle a chargé deux images. L’exemple nécessite également que le code se trouve dans un formulaire qui a ajouté l’espace System.Drawing de noms à son code.

public:
   void CreateMyLabel()
   {
      // Create an instance of a Label.
      Label^ label1 = gcnew Label;
      
      // Set the border to a three-dimensional border.
      label1->BorderStyle = System::Windows::Forms::BorderStyle::Fixed3D;
      // Set the ImageList to use for displaying an image.
      label1->ImageList = imageList1;
      // Use the second image in imageList1.
      label1->ImageIndex = 1;
      // Align the image to the top left corner.
      label1->ImageAlign = ContentAlignment::TopLeft;
      
      // Specify that the text can display mnemonic characters.
      label1->UseMnemonic = true;
      // Set the text of the control and specify a mnemonic character.
      label1->Text = "First &Name:";
      
      /* Set the size of the control based on the PreferredHeight and PreferredWidth values. */
      label1->Size = System::Drawing::Size( label1->PreferredWidth, label1->PreferredHeight );
      
      //...Code to add the control to the form...
   }

public void CreateMyLabel()
{
   // Create an instance of a Label.
   Label label1 = new Label();

   // Set the border to a three-dimensional border.
   label1.BorderStyle = System.Windows.Forms.BorderStyle.Fixed3D;
   // Set the ImageList to use for displaying an image.
   label1.ImageList = imageList1;
   // Use the second image in imageList1.
   label1.ImageIndex = 1;
   // Align the image to the top left corner.
   label1.ImageAlign = ContentAlignment.TopLeft;

   // Specify that the text can display mnemonic characters.
   label1.UseMnemonic = true;
   // Set the text of the control and specify a mnemonic character.
   label1.Text = "First &Name:";
   
   /* Set the size of the control based on the PreferredHeight and PreferredWidth values. */
   label1.Size = new Size (label1.PreferredWidth, label1.PreferredHeight);

   //...Code to add the control to the form...
}

Public Sub CreateMyLabel()
    ' Create an instance of a Label.
    Dim label1 As New Label()
       
    ' Set the border to a three-dimensional border.
    label1.BorderStyle = System.Windows.Forms.BorderStyle.Fixed3D
    ' Set the ImageList to use for displaying an image.
    label1.ImageList = imageList1
    ' Use the second image in imageList1.
    label1.ImageIndex = 1
    ' Align the image to the top left corner.
    label1.ImageAlign = ContentAlignment.TopLeft
     
    ' Specify that the text can display mnemonic characters.
    label1.UseMnemonic = True
    ' Set the text of the control and specify a mnemonic character.
    label1.Text = "First &Name:"
       
    ' Set the size of the control based on the PreferredHeight and PreferredWidth values. 
    label1.Size = New Size(label1.PreferredWidth, label1.PreferredHeight)

    '...Code to add the control to the form...
End Sub

Remarques

Cette propriété retourne la hauteur que le contrôle doit être pour afficher correctement du texte, en fonction de la police affectée au contrôle. Vous pouvez utiliser cette propriété avec la PreferredWidth propriété pour vous assurer que le texte du Label contrôle s’affiche correctement. Vous pouvez utiliser la AutoSize propriété pour ajuster automatiquement la hauteur et la largeur du contrôle, en fonction de la taille du texte et de Label la police.

Notes

Si la BorderStyle propriété du Label contrôle est définie sur BorderStyle.None, la valeur retournée par PreferredHeight la propriété sera plus grande en raison du manque de bordures.

S’applique à

Voir aussi