Label.ImageList 속성

정의

네임스페이스:

System.Windows.Forms

어셈블리:

System.Windows.Forms.dll

Source:

Label.cs

컨트롤에 ImageList 표시 Label 할 이미지가 포함된 이미지를 가져오거나 설정합니다.

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

속성 값

ImageList

ImageList 개체 컬렉션을 저장하는 항목입니다Image. 기본값은 null입니다.

예제

다음 코드 예제에서는 3 차원 테두리와 이미지 및 속성을 사용 하 여 표시 되는 컨트롤을 ImageListImageIndex 만드는 Label 방법을 보여 줍니다. 또한 컨트롤에는 니모닉 문자가 지정된 캡션이 있습니다. 예제 코드는 및 PreferredWidth 속성을 사용하여 PreferredHeight 컨트롤이 표시되는 폼의 Label 컨트롤 크기를 적절하게 조정합니다. 이 예제에서는 ImageList imageList1을 만들고 명명하고 두 개의 이미지를 로드해야 합니다. 또한 이 예제에서는 코드에 네임스페이 System.Drawing 스가 추가된 양식 내에 코드가 있어야 합니다.

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

설명

ImageIndex 속성과 ImageList 속성을 동시에 Image 사용할 수 없습니다. ImageIndex 속성과 ImageList 속성을 사용하여 이미지를 Image 표시하면 속성이 .로 null설정됩니다.

메모

Label 가비지는 다른 곳에서 계속 참조되는 경우 ImageList 수집되지 않습니다. ImageList 효율적인 가비지 수집을 Label 사용하도록 설정하려면 null 해당 속성이 설정됩니다.

추가 정보

• Image
• ImageAlign
• ImageIndex
• ImageList