ListView.ListViewItemCollection.Insert Metode

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Menyisipkan item ke dalam koleksi pada indeks yang ditentukan.

Overload

Nama	Deskripsi
Insert(Int32, String, String, String)	Membuat item baru dengan kunci, teks, dan gambar yang ditentukan, dan menambahkannya ke koleksi pada indeks yang ditentukan.
Insert(Int32, String, String, Int32)	Membuat item baru dengan kunci, teks, dan gambar yang ditentukan, dan menyisipkannya dalam koleksi pada indeks yang ditentukan.
Insert(Int32, String, String)	Membuat item baru dengan teks dan gambar yang ditentukan dan menyisipkannya ke dalam koleksi pada indeks yang ditentukan.
Insert(Int32, ListViewItem)	Menyisipkan yang ada ListViewItem ke dalam koleksi pada indeks yang ditentukan.
Insert(Int32, String)	Membuat item baru dan menyisipkannya ke dalam koleksi pada indeks yang ditentukan.
Insert(Int32, String, Int32)	Membuat item baru dengan indeks gambar yang ditentukan dan menyisipkannya ke dalam koleksi pada indeks yang ditentukan.

Insert(Int32, String, String, String)

Sumber:

ListView.ListViewItemCollection.cs

Membuat item baru dengan kunci, teks, dan gambar yang ditentukan, dan menambahkannya ke koleksi pada indeks yang ditentukan.

public:
 virtual System::Windows::Forms::ListViewItem ^ Insert(int index, System::String ^ key, System::String ^ text, System::String ^ imageKey);

public virtual System.Windows.Forms.ListViewItem Insert(int index, string? key, string? text, string? imageKey);

abstract member Insert : int * string * string * string -> System.Windows.Forms.ListViewItem
override this.Insert : int * string * string * string -> System.Windows.Forms.ListViewItem

Public Overridable Function Insert (index As Integer, key As String, text As String, imageKey As String) As ListViewItem

Parameter

index

Int32

Lokasi indeks berbasis nol tempat item disisipkan.

key

String

Item Name .

text

String

Teks item.

imageKey

String

Kunci gambar yang akan ditampilkan untuk item.

Mengembalikan

ListViewItem

Ditambahkan ListViewItem ke koleksi.

Pengecualian

ArgumentOutOfRangeException

Parameter index kurang dari 0 atau lebih besar dari Count nilai properti dari ListView.ListViewItemCollection.

Keterangan

Metode Insert mengatur Name properti item ke kunci yang ditentukan, sehingga item dapat diambil oleh indeksnya atau dengan kunci.

Insert(Int32, String, String, Int32)

Sumber:

ListView.ListViewItemCollection.cs

Membuat item baru dengan kunci, teks, dan gambar yang ditentukan, dan menyisipkannya dalam koleksi pada indeks yang ditentukan.

public:
 virtual System::Windows::Forms::ListViewItem ^ Insert(int index, System::String ^ key, System::String ^ text, int imageIndex);

public virtual System.Windows.Forms.ListViewItem Insert(int index, string? key, string? text, int imageIndex);

abstract member Insert : int * string * string * int -> System.Windows.Forms.ListViewItem
override this.Insert : int * string * string * int -> System.Windows.Forms.ListViewItem

Public Overridable Function Insert (index As Integer, key As String, text As String, imageIndex As Integer) As ListViewItem

Parameter

index

Int32

Lokasi indeks berbasis nol tempat item disisipkan.

key

String

Item Name .

text

String

Teks item.

imageIndex

Int32

Indeks gambar yang akan ditampilkan untuk item.

Mengembalikan

ListViewItem

Ditambahkan ListViewItem ke koleksi.

Pengecualian

ArgumentOutOfRangeException

Parameter index kurang dari 0 atau lebih besar dari Count nilai properti dari ListView.ListViewItemCollection.

Keterangan

Metode Insert mengatur Name properti item ke kunci yang ditentukan, sehingga item dapat diambil oleh indeksnya atau dengan kunci.

Insert(Int32, String, String)

Sumber:

ListView.ListViewItemCollection.cs

Membuat item baru dengan teks dan gambar yang ditentukan dan menyisipkannya ke dalam koleksi pada indeks yang ditentukan.

public:
 System::Windows::Forms::ListViewItem ^ Insert(int index, System::String ^ text, System::String ^ imageKey);

public System.Windows.Forms.ListViewItem Insert(int index, string? text, string? imageKey);

member this.Insert : int * string * string -> System.Windows.Forms.ListViewItem

Public Function Insert (index As Integer, text As String, imageKey As String) As ListViewItem

Parameter

index

Int32

Lokasi indeks berbasis nol tempat item disisipkan.

text

String

Teks .ListViewItem

imageKey

String

Kunci gambar yang akan ditampilkan untuk item.

Mengembalikan

ListViewItem

Ditambahkan ListViewItem ke koleksi.

Pengecualian

ArgumentOutOfRangeException

Parameter index kurang dari 0 atau lebih besar dari Count nilai properti dari ListView.ListViewItemCollection.

Insert(Int32, ListViewItem)

Sumber:

ListView.ListViewItemCollection.cs

Menyisipkan yang ada ListViewItem ke dalam koleksi pada indeks yang ditentukan.

public:
 System::Windows::Forms::ListViewItem ^ Insert(int index, System::Windows::Forms::ListViewItem ^ item);

public System.Windows.Forms.ListViewItem Insert(int index, System.Windows.Forms.ListViewItem item);

member this.Insert : int * System.Windows.Forms.ListViewItem -> System.Windows.Forms.ListViewItem

Public Function Insert (index As Integer, item As ListViewItem) As ListViewItem

Parameter

index

Int32

Lokasi indeks berbasis nol tempat item disisipkan.

item

ListViewItem

ListViewItem yang mewakili item yang akan disisipkan.

Mengembalikan

ListViewItem

Yang ListViewItem disisipkan ke dalam koleksi.

Pengecualian

ArgumentOutOfRangeException

Parameter index kurang dari 0 atau lebih besar dari Count nilai properti dari ListView.ListViewItemCollection.

Keterangan

Versi Insert metode ini memungkinkan Anda menyisipkan yang ada ListViewItem pada posisi tertentu di ListView.ListViewItemCollection.

Nota

ListView.Sorting Jika properti diatur ke nilai selain SortOrder.None atau jika ListViewItemSorter properti diatur, daftar diurutkan setelah item disisipkan.

Untuk menambahkan item tanpa menentukan posisi tertentu dalam koleksi untuk menambahkan item, gunakan Add metode . Jika Anda ingin menambahkan array item ke koleksi, gunakan metode .AddRange Anda dapat menggunakan metode ini jika Anda ingin menyisipkan item baru ke dalam kumpulan item yang sudah ada.

Lihat juga

• Add(String)
• AddRange(ListViewItem[])

Insert(Int32, String)

Sumber:

ListView.ListViewItemCollection.cs

Membuat item baru dan menyisipkannya ke dalam koleksi pada indeks yang ditentukan.

public:
 System::Windows::Forms::ListViewItem ^ Insert(int index, System::String ^ text);

public System.Windows.Forms.ListViewItem Insert(int index, string? text);

member this.Insert : int * string -> System.Windows.Forms.ListViewItem

Public Function Insert (index As Integer, text As String) As ListViewItem

Parameter

index

Int32

Lokasi indeks berbasis nol tempat item disisipkan.

text

String

Teks yang akan ditampilkan untuk item.

Mengembalikan

ListViewItem

Yang ListViewItem disisipkan ke dalam koleksi.

Pengecualian

ArgumentOutOfRangeException

Parameter index kurang dari 0 atau lebih besar dari Count nilai properti dari ListView.ListViewItemCollection.

Keterangan

Versi Insert metode ini memungkinkan Anda menyisipkan item baru pada posisi tertentu di ListView.ListViewItemCollection. Teks yang ditentukan dalam text parameter digunakan untuk membuat baru ListViewItem yang kemudian disisipkan ke dalam ListView.ListViewItemCollection di lokasi yang ditentukan.

Nota

ListView.Sorting Jika properti diatur ke nilai selain SortOrder.None atau jika ListViewItemSorter properti diatur, daftar diurutkan setelah item disisipkan.

Untuk menambahkan item tanpa menentukan posisi tertentu dalam koleksi, gunakan Add metode . Jika Anda ingin menambahkan array item ke koleksi, gunakan metode .AddRange Anda dapat menggunakan metode ini jika Anda ingin menyisipkan item baru ke dalam kumpulan item yang sudah ada.

Lihat juga

• Add(String)
• AddRange(ListViewItem[])

Insert(Int32, String, Int32)

Sumber:

ListView.ListViewItemCollection.cs

Membuat item baru dengan indeks gambar yang ditentukan dan menyisipkannya ke dalam koleksi pada indeks yang ditentukan.

public:
 System::Windows::Forms::ListViewItem ^ Insert(int index, System::String ^ text, int imageIndex);

public System.Windows.Forms.ListViewItem Insert(int index, string? text, int imageIndex);

member this.Insert : int * string * int -> System.Windows.Forms.ListViewItem

Public Function Insert (index As Integer, text As String, imageIndex As Integer) As ListViewItem

Parameter

index

Int32

Lokasi indeks berbasis nol tempat item disisipkan.

text

String

Teks yang akan ditampilkan untuk item.

imageIndex

Int32

Indeks gambar yang akan ditampilkan untuk item.

Mengembalikan

ListViewItem

Yang ListViewItem disisipkan ke dalam koleksi.

Pengecualian

ArgumentOutOfRangeException

Parameter index kurang dari 0 atau lebih besar dari Count nilai properti dari ListView.ListViewItemCollection.

Keterangan

Versi Insert metode ini memungkinkan Anda menyisipkan item baru pada posisi tertentu di ListView.ListViewItemCollection. Teks yang ditentukan dalam text parameter digunakan untuk membuat baru ListViewItem yang kemudian disisipkan ke dalam ListView.ListViewItemCollection di lokasi yang ditentukan.

Nota

ListView.Sorting Jika properti diatur ke nilai selain SortOrder.None atau jika ListViewItemSorter properti diatur, daftar diurutkan setelah item disisipkan.

Anda juga dapat menggunakan versi Insert metode ini untuk menentukan gambar untuk item dengan meneruskan indeks yang ImageList ditetapkan ke ListView.LargeImageList properti dan ListView.SmallImageList ke imageIndex parameter . (Biasanya, ListView.LargeImageList properti dan ListView.SmallImageList menggunakan posisi indeks yang sama untuk menampilkan gambar terkait.) Jika Anda tidak ingin menentukan indeks gambar untuk item tersebut, gunakan versi Insert metode lain yang menerima string sebagai parameter.

Untuk menambahkan item tanpa menentukan posisi tertentu dalam koleksi, gunakan Add metode . Jika Anda ingin menambahkan array item ke koleksi, gunakan metode .AddRange

Lihat juga

• Add(String)
• AddRange(ListViewItem[])