ButtonBase.ImageList 속성

정의

단추 컨트롤에 표시된 ImageList를 포함하는 Image를 가져오거나 설정합니다.Gets or sets the ImageList that contains the Image displayed on a button control.

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입니다.An ImageList. 기본값은 null입니다.The default value is null.

예제

다음 코드 예제에서는 파생 클래스 Button 사용 하 고 ImageListImageIndex 속성을 설정 합니다.The following code example uses the derived class, Button and sets the ImageList and ImageIndex properties. 이 코드를 사용 하려면 ImageList를 만들고 최소한 하나의 Image를 할당 해야 합니다.This code requires that an ImageList has been created and a minimum of one Image has been assigned to it. 또한이 코드에는 C:\Graphics 디렉터리에 저장 된 MyBitMap.bmp 이라는 비트맵 이미지가 있어야 합니다.This code also requires that you have a bitmap image named MyBitMap.bmp stored in the C:\Graphics directory.

private:
   void AddMyImage()
   {
      // Assign an image to the imageList.
      imageList1->Images->Add( Image::FromFile( "C:\\Graphics\\MyBitmap.bmp" ) );
      // Assign the imageList to the button control.
      button1->ImageList = imageList1;
      // Select the image from the ImageList (using the ImageIndex property).
      button1->ImageIndex = 0;
   }
private void AddMyImage()
 {
    // Assign an image to the ImageList.
    ImageList1.Images.Add(Image.FromFile("C:\\Graphics\\MyBitmap.bmp"));
    // Assign the ImageList to the button control.   
    button1.ImageList = ImageList1;
    // Select the image from the ImageList (using the ImageIndex property).    
    button1.ImageIndex = 0;
 }
 
Private Sub AddMyImage()
    ' Assign an image to the ImageList.
    ImageList1.Images.Add(Image.FromFile("C:\Graphics\MyBitmap.bmp"))
    ' Assign the ImageList to the button control.   
    button1.ImageList = ImageList1
    ' Select the image from the ImageList (using the ImageIndex property).    
    button1.ImageIndex = 0
End Sub

설명

ImageList 또는 ImageIndex 속성을 설정 하면 Image 속성이 기본값인 null설정 됩니다.When the ImageList or ImageIndex property is set, the Image property is set null, which is its default value.

참고

ImageList 속성 값이 null으로 변경 된 경우 ImageIndex 속성은 기본값-1을 반환 합니다.If the ImageList property value is changed to null, the ImageIndex property returns its default value, -1. 그러나 할당 된 ImageIndex 값은 내부적으로 유지 되 고 다른 ImageList ImageList 속성에 할당 될 때 사용 됩니다.However, the assigned ImageIndex value is retained internally and used when another ImageList is assigned to the ImageList property. ImageList 속성에 할당 된 새 ImageListImageIndex 속성에 할당 된 값 보다 작거나 같은 ImageList.ImageCollection.Count 속성 값이 있는 경우 (컬렉션이 0부터 시작 하는 인덱스 이기 때문에) ImageIndex 속성 값은 Count 속성 값 보다 1 작은 값으로 조정 됩니다.If the new ImageList assigned to the ImageList property has an ImageList.ImageCollection.Count property value that is less than or equal to the value assigned to the ImageIndex property minus one (because the collection is a zero-based index), the ImageIndex property value is adjusted to one less than the Count property value. 예를 들어 ImageList 이미지가 3 개이고 ImageIndex 속성이 2로 설정 되어 있는 단추 컨트롤을 가정해 봅니다.For example, consider a button control whose ImageList has three images and whose ImageIndex property is set to 2. 이미지를 두 개만 포함 하는 새 ImageList 단추에 할당 되 면 ImageIndex 값이 1로 변경 됩니다.If a new ImageList that has only two images is assigned to the button, the ImageIndex value changes to 1.

적용 대상

추가 정보