TreeNode.StateImageIndex 屬性

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

來源:

TreeNode.cs

取得或設定影像的索引，用以表示當父TreeView屬性設定CheckBoxes為 false時的狀態TreeNode。

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。

備註

此屬性回傳的影像索引包含於 StateImageList 父 TreeView 控制項的屬性中。

若TreeView父節點啟用勾選框，StateImageIndex節點會忽略該選項，節點會在父TreeView節點上顯示該集合中StateImageList的第一或第二個影像，分別表示未勾選或已勾選狀態。 切換屬性 Checked 不會影響 的價值 StateImageIndex。

如果沒有設定，回報 StateImageIndex 會 -1。 StateImageKey和 StateImageIndex 屬性互斥，意即若其中一者被設定，另一者則被忽略。 如果你設定了屬性 StateImageKey ，屬性 StateImageIndex 會自動設為 -1。 或者，如果你設定 StateImageIndex，則 StateImageKey 會自動設定為空字串（“”）。

另請參閱

• StateImageKey