ColumnHeader.ImageIndex 속성

정의

네임스페이스:

System.Windows.Forms

어셈블리:

System.Windows.Forms.dll

ColumnHeader에 표시되는 이미지의 인덱스를 가져오거나 설정합니다.

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.ImageIndexConverter))>]
member this.ImageIndex : int with get, set

Public Property ImageIndex As Integer

속성 값

Int32

ColumnHeader에 표시되는 이미지의 인덱스입니다.

특성

TypeConverterAttribute

예외

ArgumentOutOfRangeException

value이 -1보다 작습니다.

설명

속성이 ImageIndex 포함 된 속성에 의해 SmallImageList 지정 된 이미지의 ListView 인덱스를 참조 합니다 ColumnHeader. ImageIndex 포함에 설정된 항목이 없 SmallImageList 으면 속성이 -1을 반환합니다ListView. 열에 표시되는 이미지는 일반적으로 열에 있는 항목의 상태를 나타내는 데 사용됩니다.

ImageKeyImageIndex 은 상호 배타적입니다. 즉, 한 값이 설정된 경우 다른 값은 잘못된 값으로 설정되고 무시됩니다. 속성을 설정 ImageKey 하면 속성이 ImageIndex 자동으로 -1로 설정됩니다. 또는 속성을 ImageKey 설정하는 ImageIndex 경우 자동으로 빈 문자열("")로 설정됩니다.

속성 값이 ImageList 변경 null되면 속성은 ImageIndex 기본값 -1을 반환합니다. 그러나 할당된 ImageIndex 값은 내부적으로 유지되며 다른 ImageList 개체가 속성에 ImageList 할당될 때 사용됩니다. 속성에 ImageList 할당된 새 ImageList 속성 ImageList.ImageCollection.Count 값이 속성에 할당된 ImageIndex 값보다 작거나 같은 경우(컬렉션이 0부터 시작하는 인덱 ImageIndex 스인 경우) 속성 값이 속성 값보다 Count 작은 값으로 조정됩니다. 예를 들어 세 개의 이미지가 있고 ImageIndex 속성이 ImageList 2로 설정된 단추 컨트롤을 고려해 보세요. 두 개의 이미지만 있는 새 ImageList 이미지가 단추에 할당되면 값이 ImageIndex 1로 변경됩니다.