Label.PreferredHeight Özellik

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Denetimin tercih edilen yüksekliğini alır.

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

Özellik Değeri

Int32

Tek bir metin satırının görüntülendiği varsayılarak denetimin yüksekliği (piksel cinsinden).

Öznitelikler

BrowsableAttribute

Örnekler

Aşağıdaki kod örneği, üç boyutlu kenarlık Label ve ve ImageIndex özellikleri kullanılarak görüntülenen bir görüntüye sahip bir denetimin ImageList nasıl oluşturulacağını gösterir. Denetimin ayrıca, belirtilen bir anımsatıcı karakteri olan bir resim yazısı vardır. Örnek kod, denetimi görüntülendiği formda düzgün boyutlandırmak Label için ve PreferredWidth özelliklerini kullanırPreferredHeight. Bu örnek için bir ImageList oluşturulup imageList1 olarak adlandırılmış olması ve iki görüntü yüklemesi gerekir. Örnek ayrıca kodun ad alanının koduna System.Drawing eklendiği bir formda olmasını gerektirir.

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

Açıklamalar

Bu özellik, denetime atanan yazı tipine bağlı olarak metni düzgün bir şekilde görüntülemek için denetimin yüksekliğini döndürür. Denetimdeki Label metnin düzgün görüntülendiğinden PreferredWidth emin olmak için özelliğiyle birlikte bu özelliği kullanabilirsiniz. özelliğini kullanarak denetimin AutoSize yüksekliğini ve genişliğini Label metin ve yazı tipi boyutuna göre otomatik olarak ayarlayabilirsiniz.

Not

Denetimin BorderStyle Label özelliği olarak BorderStyle.Noneayarlanırsa, özellik tarafından PreferredHeight döndürülen değer kenarlıkların olmaması nedeniyle daha büyük olur.

Ayrıca bkz.

• PreferredWidth
• AutoSize