ListViewItem.ImageIndex 속성
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
항목에 표시되는 이미지의 인덱스를 가져오거나 설정합니다.
public:
property int ImageIndex { int get(); void set(int value); };[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ImageIndexConverter))]
public int ImageIndex { get; set; }[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.NoneExcludedImageIndexConverter))]
public int ImageIndex { get; set; }[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ImageIndexConverter))>]
member this.ImageIndex : int with get, set[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.NoneExcludedImageIndexConverter))>]
member this.ImageIndex : int with get, setPublic Property ImageIndex As Integer속성 값
ImageList에서 항목에 표시되는 이미지의 인덱스(0부터 시작)입니다. 기본값은 -1입니다.
- 특성
예외
value이 -1보다 작습니다.
설명
이 속성의 값은 속성의 ImageList 값에 따라 다릅니다. 항목과 연결 된 컨트롤의 속성의 View ListView 현재 값에 따라 항목 ImageList 에 사용 되는 속성 또는 SmallImageList 컨트롤의 ListView 속성에 LargeImageList 지정 된 것 일 수 있습니다. View 속성을 설정 ImageList LargeIcon하면 속성에 LargeImageList 지정된 속성이 사용되고, ImageList 그렇지 않으면 속성에 SmallImageList 지정된 속성이 사용됩니다. 속성에 지정된 이미지에 ImageList 정의된 이미지는 속성에 SmallImageList 지정된 이미지 ImageList LargeImageList 와 동일한 인덱스 위치를 가져야 합니다. 인덱스 위치가 두 컨트롤에 ImageList 대해 동일한 경우 속성에 대해 ImageIndex 단일 인덱스 값을 설정할 수 있으며 컨트롤의 View 속성 ListView 값에 관계없이 적절한 이미지가 표시됩니다.
ImageKey 는 ImageIndex 상호 배타적입니다. 즉, 한 값이 설정되면 다른 값은 잘못된 값으로 설정되고 무시됩니다. 속성을 설정 ImageKey 하면 속성이 ImageIndex 자동으로 -1로 설정됩니다. 또는 속성을 ImageKey 설정하는 ImageIndex 경우 자동으로 빈 문자열("")로 설정됩니다.
속성 값이 ImageList 변경 null된 경우 속성은 ImageIndex 기본값 -1을 반환합니다. 그러나 할당된 ImageIndex 값은 내부적으로 유지되며 다른 ImageList 개체가 속성에 ImageList 할당될 때 사용됩니다. 속성에 ImageList 할당된 새 ImageList 속성 ImageList.ImageCollection.Count 값이 속성에 할당된 ImageIndex 값에서 1을 뺀 값보다 작거나 같은 경우(컬렉션이 0부터 시작하는 인덱 ImageIndex 스인 경우) 속성 값이 속성 값보다 Count 작은 값으로 조정됩니다.
예를 들어 세 개의 이미지가 있고 ImageIndex 속성이 ImageList 2로 설정된 단추 컨트롤을 생각해 보세요. 단추에 두 개의 이미지만 있는 새 ImageList 이미지가 할당되면 값이 ImageIndex 1로 변경됩니다.