ToolStripItem.ImageIndex 속성

정의

네임스페이스:

System.Windows.Forms

어셈블리:

System.Windows.Forms.dll

Source:

ToolStripItem.cs

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

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로 설정됩니다. 또는 속성을 ImageIndex 설정 ImageKey 하면 자동으로 빈 문자열("")로 설정됩니다.

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

이미지 크기 조정은 ToolStrip와 ToolStripItem의 속성 간 상호 작용에 의해 다음과 같이 결정됩니다.

• ImageScalingSize 는 이미지의 ImageScaling 설정과 컨테이너의 AutoSize 설정의 조합으로 최종 이미지의 크기를 결정합니다.

  • AutoSize가 true(기본값)이고 ToolStripItemImageScaling이 SizeToFit인 경우에는 이미지 크기 조정이 일어나지 않으며, ToolStrip의 크기는 가장 큰 항목의 크기이거나 사전 지정된 최소 크기가 됩니다.

  • AutoSize가 false이고 ToolStripItemImageScaling이 None인 경우, 이미지 또는 ToolStrip 스케일링이 발생하지 않습니다.

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