ListViewItem.ImageIndex 속성

정의

항목에 표시되는 이미지의 인덱스를 가져오거나 설정합니다.Gets or sets the index of the image that is displayed for the item.

public:
 property int ImageIndex { int get(); void set(int value); };
[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.NoneExcludedImageIndexConverter))]
[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

속성 값

ImageList에서 항목에 표시되는 이미지의 인덱스(0부터 시작)입니다.The zero-based index of the image in the ImageList that is displayed for the item. 기본값은 -1입니다.The default is -1.

특성

예외

지정된 값이 -1보다 작습니다.The value specified is less than -1.

설명

값에 따라이 속성의 값을 ImageList 속성입니다.The value of this property depends on the value of the ImageList property. 현재 값에 따라를 View 의 속성을 ListView 항목과 연결 된 컨트롤은 ImageList 지정할 수 있습니다 하나에서 항목에서 사용를 LargeImageList 속성 또는 SmallImageList 속성을 ListView컨트롤입니다.Depending on the current value of the View property of the ListView control associated with the item, the ImageList used by the item could be one specified in the LargeImageList property or the SmallImageList property of the ListView control. 경우는 View 속성이로 설정 되어 LargeIcon, ImageList 에 지정 된를 LargeImageList 속성은 사용 하지 않으면를 ImageList 에 지정 된는 SmallImageList 속성을 사용 합니다.If the View property is set to LargeIcon, the ImageList specified in the LargeImageList property is used; otherwise, the ImageList specified in the SmallImageList property is used. 에 정의 된 이미지를 ImageList 에 지정 된를 SmallImageList 이미지와 동일한 인덱스 위치에 있어야 합니다 ImageList 에 지정 된는 LargeImageList 속성.The images defined in the ImageList specified in the SmallImageList should have the same index positions as the images in the ImageList specified in the LargeImageList property. 인덱스 위치를 둘 다에 대해 동일한 경우 ImageList 컨트롤에 대 한 단일 인덱스 값을 설정할 수 있습니다를 ImageIndex 속성 및 적절 한 이미지의 값에 관계 없이 표시 됩니다는 View 의 속성을 ListView 컨트롤입니다.If the index positions are the same for both ImageList controls, you can set a single index value for the ImageIndex property and the appropriate image will be displayed regardless of the value of the View property of the ListView control. 합니다 ImageKeyImageIndex 속성은 상호 배타적 이며 나머지는 무시, 설정 된 경우를 의미 합니다.The ImageKey and ImageIndex properties are mutually exclusive, meaning if one is set, the other is ignored. 또한 설정 하는 경우는 ImageKey 속성을 ImageIndex 속성이-1로 자동 설정 됩니다.Furthermore, if you set the ImageKey property, the ImageIndex property is automatically set to -1. 또는 설정 하는 경우는 ImageIndex 속성을 ImageKey 빈 문자열을 자동으로 설정 됩니다 ("").Alternatively, if you set the ImageIndex property, the ImageKey is automatically set to an empty string ("").

적용 대상

추가 정보