다음을 통해 공유


ToolStripItem.ImageIndex 속성

정의

항목에 표시되는 이미지의 인덱스 값을 가져오거나 설정합니다.

public:
 property int ImageIndex { int get(); void set(int value); };
[System.ComponentModel.Browsable(false)]
[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.NoneExcludedImageIndexConverter))]
[System.Windows.Forms.RelatedImageList("Owner.ImageList")]
public int ImageIndex { get; set; }
[<System.ComponentModel.Browsable(false)>]
[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.NoneExcludedImageIndexConverter))>]
[<System.Windows.Forms.RelatedImageList("Owner.ImageList")>]
member this.ImageIndex : int with get, set
Public Property ImageIndex As Integer

속성 값

Int32

ImageList에서 항목에 표시되는 이미지의 인덱스(0부터 시작)입니다. 기본값은 빈 이미지 목록을 나타내는 -1입니다.

특성

예외

value이 -1보다 작습니다.

설명

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

합니다 Image, ImageAlignImageIndex, ImageKey, 및 ImageScaling 다양 한 이미지 처리와 관련 된 속성입니다. 이러한 속성을 직접 설정하거나 런타임 전용 ImageList 속성을 설정하여 컨트롤에서 이미지를 ToolStrip 사용합니다.

둘 다에서 속성의 상호 작용에 의해 결정 됩니다 이미지 크기 조정 ToolStripToolStripItem다음과 같이 합니다.

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

적용 대상