Label.ImageList Özellik

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kaynak:

Label.cs

Denetimde ImageListLabel görüntülenecek görüntüleri içeren öğesini alır veya ayarlar.

public:
 property System::Windows::Forms::ImageList ^ ImageList { System::Windows::Forms::ImageList ^ get(); void set(System::Windows::Forms::ImageList ^ value); };

public System.Windows.Forms.ImageList? ImageList { get; set; }

member this.ImageList : System.Windows.Forms.ImageList with get, set

Public Property ImageList As ImageList

Özellik Değeri

ImageList

ImageList Nesne koleksiyonunu Image depolayan. Varsayılan değer null değeridir.

Örnekler

Aşağıdaki kod örneği, ve özellikleri kullanılarak üç boyutlu kenarlık ve görüntü görüntü içeren bir denetimin ImageListImageIndex nasıl oluşturulacağını Label gösterir. Denetimin ayrıca, belirtilen bir anımsatıcı karakteri olan bir resim yazısı da vardır. Örnek kod, denetimin görüntülendiği formda düzgün şekilde boyutlandırılmalarını Label sağlamak için ve PreferredWidth özelliklerini kullanırPreferredHeight. Bu örnek, bir ImageList öğesinin oluşturulmasını ve imageList1 olarak adlandırıldığını ve iki görüntü yüklemiş olmasını gerektirir. Örnek ayrıca kodun ad alanının koduna eklendiği bir formda System.Drawing 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

ImageIndex ve ImageList özellikleri özelliğiyle aynı anda Image kullanılamaz. ImageIndex Bir görüntüyü görüntülemek için özellik ve ImageList özellikler kullanıldığında, Image özelliği olarak nullayarlanır.

Uyarı

başka Label bir yerde başvurulmaya devam ederse ImageList çöp toplanmaz. ImageList Verimli çöp toplamayı etkinleştirmek için null öğesinin Label özelliğini olarak ayarlayın.

Ayrıca bkz.

• Image
• ImageAlign
• ImageIndex
• ImageList