ColumnHeader.ImageIndex 屬性

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

取得或設定顯示在 ColumnHeader 中影像的索引。

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

[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ImageIndexConverter))]
public int ImageIndex { get; set; }

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ImageIndexConverter))>]
member this.ImageIndex : int with get, set

Public Property ImageIndex As Integer

屬性值

Int32

顯示在 ColumnHeader 中影像的索引。

屬性

TypeConverterAttribute

例外狀況

ArgumentOutOfRangeException

value 小於 -1。

備註

屬性 ImageIndex 是指 包含 之 屬性 ListViewColumnHeader 所 SmallImageList 指定的影像索引。 如果包含 ListView 的 上沒有 SmallImageList 設定，則 ImageIndex 屬性會傳回 -1。 資料行中顯示的影像通常用來指出資料行中專案的狀態。

ImageKey 和 ImageIndex 互斥，這表示如果設定其中一個，另一個會設定為不正確值並忽略。 如果您設定 ImageKey 屬性，屬性 ImageIndex 會自動設定為 -1。 或者，如果您設定 ImageIndex 屬性，會自動 ImageKey 將 設定為空字串 (「」) 。

ImageList如果屬性值變更為 null ，則 ImageIndex 屬性會傳回其預設值 -1。 不過，指派 ImageIndex 的值會在內部保留，並在另一個 ImageList 物件指派給 ImageList 屬性時使用。 如果指派給 ImageList 屬性的新 ImageList 具有 ImageList.ImageCollection.Count 小於或等於指派給 ImageIndex 屬性的值減一 (，以將集合視為以零起始的索引) ， ImageIndex 屬性值會調整為小於屬性值的 Count 一個。 例如，假設有三個影像且屬性設定為 2 的 ImageIndex 按鈕控制項 ImageList 。 如果只有兩個影像的新 ImageList 指派給按鈕，則 ImageIndex 值會變更為 1。