ListView.ListViewItemCollection.Add Metode

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Menambahkan item ke kumpulan item.

Overload

Nama	Deskripsi
Add(String)	Membuat item dengan teks yang ditentukan dan menambahkannya ke koleksi.
Add(ListViewItem)	Menambahkan yang sudah ada ListViewItem ke koleksi.
Add(String, Int32)	Membuat item dengan teks dan gambar yang ditentukan dan menambahkannya ke koleksi.
Add(String, String)	Membuat item dengan teks dan gambar yang ditentukan dan menambahkannya ke koleksi.
Add(String, String, Int32)	Membuat item dengan kunci, teks, dan gambar yang ditentukan dan menambahkan item ke koleksi.
Add(String, String, String)	Membuat item dengan kunci, teks, dan gambar yang ditentukan, dan menambahkannya ke koleksi.

Add(String)

Sumber:

ListView.ListViewItemCollection.cs

Membuat item dengan teks yang ditentukan dan menambahkannya ke koleksi.

public:
 virtual System::Windows::Forms::ListViewItem ^ Add(System::String ^ text);

public virtual System.Windows.Forms.ListViewItem Add(string? text);

abstract member Add : string -> System.Windows.Forms.ListViewItem
override this.Add : string -> System.Windows.Forms.ListViewItem

Public Overridable Function Add (text As String) As ListViewItem

Parameter

text

String

Teks yang akan ditampilkan untuk item.

Mengembalikan

ListViewItem

Yang ListViewItem ditambahkan ke koleksi.

Keterangan

Anda dapat menggunakan versi Add metode ini untuk membuat yang baru ListViewItem untuk ditambahkan ke ListView kontrol. Teks yang baru ListViewItem ditambahkan ke kontrol didasarkan pada text parameter . Jika Anda ingin menentukan gambar untuk item, gunakan versi Add metode yang menerima indeks gambar sebagai parameter. Jika Anda memiliki yang sudah ada ListViewItem yang ingin Anda tambahkan ke koleksi, gunakan versi Add metode yang menerima ListViewItem sebagai parameternya.

ListView.Sorting Jika properti diatur ke nilai selain SortOrder.None atau jika ListViewItemSorter properti diatur, daftar diurutkan setelah item ditambahkan. Jika tidak, item disisipkan di akhir daftar. Jika daftar tidak diurutkan, Anda dapat menggunakan Insert metode untuk menyisipkan item ke ListView dalam pada posisi tertentu. Untuk menambahkan sekumpulan item ke kontrol dalam satu operasi, gunakan AddRange metode . Jika Anda ingin menggunakan Add metode untuk menambahkan sejumlah besar item ke kontrol, gunakan BeginUpdate metode dan EndUpdate untuk mencegah ListView pengecatan ulang hingga semua item ditambahkan. Saat menambahkan item ke ListView, lebih efisien untuk mengurutkan item terlebih dahulu lalu menambahkan item baru.

Lihat juga

• AddRange(ListViewItem[])
• Insert(Int32, ListViewItem)
• Sorting

Add(ListViewItem)

Sumber:

ListView.ListViewItemCollection.cs

Menambahkan yang sudah ada ListViewItem ke koleksi.

public:
 virtual System::Windows::Forms::ListViewItem ^ Add(System::Windows::Forms::ListViewItem ^ value);

public virtual System.Windows.Forms.ListViewItem Add(System.Windows.Forms.ListViewItem value);

abstract member Add : System.Windows.Forms.ListViewItem -> System.Windows.Forms.ListViewItem
override this.Add : System.Windows.Forms.ListViewItem -> System.Windows.Forms.ListViewItem

Public Overridable Function Add (value As ListViewItem) As ListViewItem

Parameter

value

ListViewItem

untuk ListViewItem ditambahkan ke koleksi.

Mengembalikan

ListViewItem

Yang ListViewItem ditambahkan ke koleksi.

Keterangan

Anda dapat menggunakan versi Add metode ini untuk menambahkan yang sudah ada ListViewItem ke koleksi. Versi Add metode ini biasanya digunakan untuk menggunakan kembali item dari kontrol lain ListView atau jika ListViewItem dibuat secara manual sebelum menambahkannya ke koleksi. Jika Anda ingin membuat baru ListViewItem alih-alih menggunakan item yang sudah ada, gunakan versi metode lainnya Add .

ListView.Sorting Jika properti diatur ke nilai selain SortOrder.None atau jika ListViewItemSorter properti diatur, daftar diurutkan setelah item ditambahkan. Jika tidak, item disisipkan di akhir daftar. Jika daftar tidak diurutkan, Anda dapat menggunakan Insert metode untuk menyisipkan item ke ListView dalam pada posisi tertentu. Untuk menambahkan sekumpulan item ke kontrol dalam satu operasi, gunakan AddRange metode . Jika Anda ingin menggunakan Add metode untuk menambahkan sejumlah besar item ke kontrol, gunakan BeginUpdate metode dan EndUpdate untuk mencegah ListView pengecatan ulang hingga semua item ditambahkan. Saat menambahkan item ke ListView, lebih efisien untuk mengurutkan item terlebih dahulu lalu menambahkan item baru.

Versi Add metode ini juga digunakan untuk menetapkan ListViewItem ke ListViewGroup.

Lihat juga

• AddRange(ListViewItem[])
• Insert(Int32, ListViewItem)
• Sorting

Add(String, Int32)

Sumber:

ListView.ListViewItemCollection.cs

Membuat item dengan teks dan gambar yang ditentukan dan menambahkannya ke koleksi.

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

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

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

Public Overridable Function Add (text As String, imageIndex As Integer) As ListViewItem

Parameter

text

String

Teks item.

imageIndex

Int32

Indeks gambar yang akan ditampilkan untuk item.

Mengembalikan

ListViewItem

Yang ListViewItem ditambahkan ke koleksi.

Keterangan

Anda dapat menggunakan versi Add metode ini untuk membuat yang baru ListViewItem untuk ditambahkan ke ListView kontrol. Teks yang baru ListViewItem ditambahkan ke kontrol didasarkan pada text parameter . Anda juga dapat 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 Add metode yang hanya menerima string sebagai parameter. Jika Anda memiliki yang sudah ada ListViewItem yang ingin Anda tambahkan ke koleksi, gunakan versi Add metode yang menerima ListViewItem sebagai parameternya.

ListView.Sorting Jika properti diatur ke nilai selain SortOrder.None atau jika ListViewItemSorter properti diatur, daftar diurutkan setelah item ditambahkan. Jika tidak, item disisipkan di akhir daftar. Jika daftar tidak diurutkan, Anda dapat menggunakan Insert metode untuk menyisipkan item ke ListView dalam pada posisi tertentu. Untuk menambahkan sekumpulan item ke kontrol dalam satu operasi, gunakan AddRange metode . Jika Anda ingin menggunakan Add metode untuk menambahkan sejumlah besar item ke kontrol, gunakan BeginUpdate metode dan EndUpdate untuk mencegah ListView pengecatan ulang hingga semua item ditambahkan. Saat menambahkan item ke ListView, lebih efisien untuk mengurutkan item terlebih dahulu lalu menambahkan item baru.

Lihat juga

• AddRange(ListViewItem[])
• Insert(Int32, ListViewItem)
• Sorting

Add(String, String)

Sumber:

ListView.ListViewItemCollection.cs

Membuat item dengan teks dan gambar yang ditentukan dan menambahkannya ke koleksi.

public:
 virtual System::Windows::Forms::ListViewItem ^ Add(System::String ^ text, System::String ^ imageKey);

public virtual System.Windows.Forms.ListViewItem Add(string? text, string? imageKey);

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

Public Overridable Function Add (text As String, imageKey As String) As ListViewItem

Parameter

text

String

Teks item.

imageKey

String

Kunci gambar yang akan ditampilkan untuk item.

Mengembalikan

ListViewItem

Ditambahkan ListViewItem ke koleksi.

Keterangan

ListView Jika diurutkan, item ditambahkan dalam urutan yang diurutkan dengan benar; jika tidak, item ditambahkan ke akhir koleksi.

Add(String, String, Int32)

Sumber:

ListView.ListViewItemCollection.cs

Membuat item dengan kunci, teks, dan gambar yang ditentukan dan menambahkan item ke koleksi.

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

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

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

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

Parameter

key

String

Nama barang.

text

String

Teks item.

imageIndex

Int32

Indeks gambar yang akan ditampilkan untuk item.

Mengembalikan

ListViewItem

Ditambahkan ListViewItem ke koleksi.

Pengecualian

InvalidOperationException

Yang terkandung ListView dalam mode virtual.

Keterangan

ListView Jika diurutkan, item ditambahkan dalam urutan yang diurutkan dengan benar; jika tidak, item ditambahkan ke akhir koleksi. Properti Name sesuai dengan kunci untuk ListViewItem di ListView.ListViewItemCollection.

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

Add(String, String, String)

Sumber:

ListView.ListViewItemCollection.cs

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

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

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

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

Public Overridable Function Add (key As String, text As String, imageKey As String) As ListViewItem

Parameter

key

String

Nama barang.

text

String

Teks item.

imageKey

String

Kunci gambar yang akan ditampilkan untuk item.

Mengembalikan

ListViewItem

Ditambahkan ListViewItem ke koleksi.

Keterangan

Properti Name sesuai dengan kunci untuk ListViewItem di ListView.ListViewItemCollection.

ListView Jika diurutkan, item ditambahkan dalam urutan yang diurutkan dengan benar; jika tidak, item ditambahkan ke akhir koleksi. Metode Add mengatur Name properti item ke kunci yang ditentukan, sehingga item dapat diambil oleh indeksnya atau dengan kunci.