ButtonBase.ImageIndex 속성

정의

단추 컨트롤에 표시된 이미지의 이미지 목록 인덱스 값을 가져오거나 설정합니다.Gets or sets the image list index value of the image displayed on the button control.

public:
 property int ImageIndex { int get(); void set(int value); };
[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ImageIndexConverter))]
public int ImageIndex { get; set; }
member this.ImageIndex : int with get, set
Public Property ImageIndex As Integer

속성 값

0부터 시작하는 인덱스이며, ImageList에서 이미지의 위치를 나타냅니다.A zero-based index, which represents the image position in an ImageList. 기본값은 -1입니다.The default is -1.

특성

예외

할당된 값이 ImageIndex의 하한값보다 작은 경우The assigned value is less than the lower bounds of the ImageIndex.

예제

다음 코드 예제에서는 파생 클래스 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

설명

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

참고

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 object 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 (to account for the collection being 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.

적용 대상

추가 정보