ListViewItem.StateImageIndex 속성

정의

네임스페이스:

System.Windows.Forms

어셈블리:

System.Windows.Forms.dll

항목에 대해 표시되는 상태 이미지의 인덱스를 가져오거나 설정합니다. 상태 이미지는 선택된 확인란이나 선택이 취소된 확인란처럼 항목의 상태를 나타내는 이미지입니다.

public:
 property int StateImageIndex { int get(); void set(int value); };

[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ImageIndexConverter))]
public int StateImageIndex { get; set; }

[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.NoneExcludedImageIndexConverter))]
[System.Windows.Forms.RelatedImageList("ListView.StateImageList")]
public int StateImageIndex { get; set; }

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ImageIndexConverter))>]
member this.StateImageIndex : int with get, set

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.NoneExcludedImageIndexConverter))>]
[<System.Windows.Forms.RelatedImageList("ListView.StateImageList")>]
member this.StateImageIndex : int with get, set

Public Property StateImageIndex As Integer

속성 값

Int32

ImageList에서 항목에 표시되는 상태 이미지의 인덱스(0부터 시작)입니다.

특성

TypeConverterAttribute RelatedImageListAttribute

예외

ArgumentOutOfRangeException

이 속성에 지정된 값이 -1보다 작은 경우

또는

이 속성에 지정된 값이 14보다 큰 경우

설명

이 속성을 사용하면 항목 왼쪽에 ImageList 표시할 StateImageList 상태 이미지가 저장되는 연결된 컨트롤의 속성에 할당된 ListView 인덱스를 지정할 수 있습니다. 일반적으로 상태 이미지는 선택되거나 지워진 확인란이거나 항목에 대해 선택되거나 지워진 상태를 나타내기 위한 이미지입니다. 속성에 대해 StateImageList 값이 지정되지 않은 경우 컨트롤의 ListView 속성을 설정하면 컨트롤에 기본 선택 또는 선택 취소 확인란 CheckBoxes 이 true표시됩니다.

참고

ImageList 속성에 StateImageList 지정된 이미지 StateImageIndex 의 개수에 관계없이 속성을 14보다 작거나 같은 값으로 설정할 수 있지만 인덱스 위치 0과 1의 이미지만 상태 이미지로 표시됩니다.

추가 정보

• StateImageList