ColumnHeader.ImageIndex Properti

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Sumber:

ColumnHeader.cs

Mendapatkan atau mengatur indeks gambar yang ditampilkan di 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

Nilai Properti

Int32

Indeks gambar yang ditampilkan di ColumnHeader.

Atribut

TypeConverterAttribute

Pengecualian

ArgumentOutOfRangeException

value kurang dari -1.

Keterangan

Properti ImageIndex mengacu pada indeks gambar yang ditentukan oleh SmallImageList properti ListView yang berisi ColumnHeader. Properti ImageIndex mengembalikan -1 jika tidak SmallImageList ada yang diatur pada yang berisi ListView. Gambar yang ditampilkan dalam kolom biasanya digunakan untuk menunjukkan status item dalam kolom.

ImageKey dan ImageIndex saling eksklusif, yang berarti jika satu diatur, yang lain diatur ke nilai yang tidak valid dan diabaikan. Jika Anda mengatur ImageKey properti , ImageIndex properti secara otomatis diatur ke -1. Atau, jika Anda mengatur ImageIndex properti , ImageKey secara otomatis diatur ke string kosong ("").

ImageList Jika nilai properti diubah menjadi null, ImageIndex properti mengembalikan nilai defaultnya, -1. Namun, nilai yang ditetapkan ImageIndex dipertahankan secara internal dan digunakan ketika objek lain ImageList ditetapkan ke ImageList properti . Jika yang baru ImageList ditetapkan ke ImageList properti memiliki ImageList.ImageCollection.Count nilai properti yang kurang dari atau sama dengan nilai yang ditetapkan ke ImageIndex properti dikurangi satu (untuk memperhitungkan koleksi menjadi indeks berbasis nol), ImageIndex nilai properti disesuaikan menjadi satu kurang dari Count nilai properti. Misalnya, pertimbangkan kontrol tombol yang ImageList memiliki tiga gambar dan yang propertinya ImageIndex diatur ke 2. Jika baru ImageList yang hanya memiliki dua gambar ditetapkan ke tombol , nilai berubah ImageIndex menjadi 1.