ButtonBase.ImageIndex ButtonBase.ImageIndex ButtonBase.ImageIndex ButtonBase.ImageIndex Property

정의

단추 컨트롤에 표시된 이미지의 이미지 목록 인덱스 값을 가져오거나 설정합니다.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. 이 코드는 명명 된 bitmapimage 있다고도 필요 MyBitMap.bmp 에 저장 된 C:\Graphics 디렉터리입니다.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 에 할당 합니다 ImageList 속성이 ImageList.ImageCollection.Count 속성 값에 할당 된 값 보다 작거나는 ImageIndex 속성 (인덱스는 0부터 시작 되는 컬렉션에 대 한 계정)에 1을 뺀 값 합니다 ImageIndex속성 값이 하나에 조정 됩니다 보다 작은 Count 속성 값입니다.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 있고 세 개의 이미지가 있는 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.

적용 대상

추가 정보