ListViewItem.ImageIndex Properti

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Sumber:

ListViewItem.cs

Mendapatkan atau mengatur indeks gambar yang ditampilkan untuk item.

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

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

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

Public Property ImageIndex As Integer

Nilai Properti

Int32

Indeks gambar berbasis nol dalam ImageList yang ditampilkan untuk item. Defaultnya adalah -1.

Atribut

TypeConverterAttribute

Pengecualian

ArgumentOutOfRangeException

value kurang dari -1.

Keterangan

Nilai properti ini tergantung pada nilai ImageList properti . Bergantung pada nilai View properti kontrol saat ini yang ListView terkait dengan item, ImageList item yang digunakan dapat berupa yang ditentukan dalam LargeImageList properti atau SmallImageList properti ListView kontrol. View Jika properti diatur ke LargeIcon, ImageList yang ditentukan dalam LargeImageList properti digunakan; jika tidak, ImageList yang ditentukan dalam SmallImageList properti digunakan. Gambar yang ditentukan dalam ImageListSmallImageList properti harus memiliki posisi indeks yang sama dengan gambar dalam ImageList yang ditentukan dalam LargeImageList properti . Jika posisi indeks sama untuk kedua ImageList kontrol, Anda dapat mengatur nilai indeks tunggal untuk ImageIndex properti dan gambar yang sesuai akan ditampilkan terlepas dari View nilai properti ListView kontrol.

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.

Lihat juga

• View
• SmallImageList
• LargeImageList