ToolStripItem.ImageIndex 속성

정의

네임스페이스:

System.Windows.Forms

어셈블리:

System.Windows.Forms.dll

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

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입니다.

특성

BrowsableAttribute TypeConverterAttribute RelatedImageListAttribute

예외

ArgumentOutOfRangeException

value이 -1보다 작습니다.

설명

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

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

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

• ImageScalingSize 이미지의 조합으로 결정 된 최종 이미지의 소수 자릿수 ImageScaling 설정 및 컨테이너의 AutoSize 설정 합니다.

  • true isAutoSize(기본값)이면 ToolStripItemImageScaling SizeToFit이미지 크기 조정이 발생하지 않으며 ToolStrip 크기는 가장 큰 항목 또는 지정된 최소 크기의 크기입니다.

  • 있는 Nonefalse ToolStripItemImageScaling 경우 AutoSize 이미지나 ToolStrip 크기 조정이 발생하지 않습니다.

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