TreeNode.StateImageIndex 屬性

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

取得或設定影像的索引，用於在父代 TreeNode 的 TreeView 屬性設為 false 時，指示 CheckBoxes 的狀態。

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

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

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

Public Property StateImageIndex As Integer

屬性值

Int32

用來表示 TreeNode 狀態的影像索引。

屬性

TypeConverterAttribute RelatedImageListAttribute

例外狀況

ArgumentOutOfRangeException

指定的索引小於 -1 或大於 14。

備註

這個屬性所傳回的影像索引包含在父 TreeView 控制項的 屬性中 StateImageList 。

如果父 TreeView 系已啟用核取方塊，則會忽略 ， StateImageIndex 而且節點會在父 TreeView 代的集合中 StateImageList 顯示第一個或第二個影像，以分別指出未核取或核取的狀態。 切換 Checked 屬性不會影響 的值 StateImageIndex 。

未設定時，會 StateImageIndex 傳回 -1。 StateImageKey和 StateImageIndex 屬性互斥，這表示如果已設定，則會忽略另一個。 如果您設定 StateImageKey 屬性，屬性 StateImageIndex 會自動設定為 -1。 或者，如果您設定 StateImageIndex ， StateImageKey 會自動設定為空字串 (「」) 。

另請參閱

• StateImageKey