ListView.ListViewItemCollection.Add Yöntem

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Öğe koleksiyonuna bir öğe ekler.

Aşırı Yüklemeler

Name	Description
Add(String)	Belirtilen metinle bir öğe oluşturur ve bunu koleksiyona ekler.
Add(ListViewItem)	Koleksiyona var olan ListViewItem bir ekler.
Add(String, Int32)	Belirtilen metin ve görüntüyle bir öğe oluşturur ve bunu koleksiyona ekler.
Add(String, String)	Belirtilen metin ve görüntüyle bir öğe oluşturur ve bunu koleksiyona ekler.
Add(String, String, Int32)	Belirtilen anahtar, metin ve görüntü ile bir öğe oluşturur ve koleksiyona bir öğe ekler.
Add(String, String, String)	Belirtilen anahtar, metin ve görüntü ile bir öğe oluşturur ve bunu koleksiyona ekler.

Add(String)

Kaynak:

ListView.ListViewItemCollection.cs

Belirtilen metinle bir öğe oluşturur ve bunu koleksiyona ekler.

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

Parametreler

text

String

Öğe için görüntülenecek metin.

Döndürülenler

ListViewItem

ListViewItem Koleksiyona eklenen.

Açıklamalar

Denetime eklenecek ListView yeni ListViewItem bir oluşturmak için yönteminin Add bu sürümünü kullanabilirsiniz. Denetime eklenen yeninin ListViewItem metni parametresini text temel alır. Öğe için bir görüntü belirtmek istiyorsanız, yöntemin Add görüntü dizinini parametre olarak kabul eden sürümünü kullanın. Koleksiyona eklemek istediğiniz bir var olan ListViewItem varsa, yöntemin Add parametresi olarak kabul ListViewItem eden sürümünü kullanın.

ListView.Sorting Özellik dışında bir değere SortOrder.None ayarlanırsa veya özelliği ayarlanırsaListViewItemSorter, liste öğe eklendikten sonra sıralanır. Aksi takdirde, öğe listenin sonuna eklenir. Liste sıralanmamışsa, belirli bir konumda öğesine öğe ListView eklemek için yöntemini kullanabilirsinizInsert. Tek bir işlemde denetime bir öğe kümesi eklemek için yöntemini kullanın AddRange . Denetimine Add çok sayıda öğe eklemek için yöntemini kullanmak istiyorsanız, tüm öğeler eklenene kadar öğesinin yeniden boyanmasını ListView önlemek için ve EndUpdate yöntemlerini kullanınBeginUpdate. öğesine ListViewöğe eklerken, önce öğeleri sıralamak ve sonra yeni öğeler eklemek daha verimli olur.

Ayrıca bkz.

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

Add(ListViewItem)

Kaynak:

ListView.ListViewItemCollection.cs

Koleksiyona var olan ListViewItem bir ekler.

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

Parametreler

value

ListViewItem

ListViewItem koleksiyonuna eklenecek.

Döndürülenler

ListViewItem

ListViewItem Koleksiyona eklenen.

Açıklamalar

Yöntemin Add bu sürümünü kullanarak koleksiyona var olan ListViewItem bir öğeyi ekleyebilirsiniz. Yöntemin Add bu sürümü genellikle diğer ListView denetimlerden öğeleri yeniden kullanmak için veya koleksiyonuna eklemeden önce el ile oluşturulmuşsa ListViewItem kullanılır. Mevcut bir öğeyi kullanmak yerine yeni ListViewItem bir öğe oluşturmak istiyorsanız, yöntemin diğer sürümlerini Add kullanın.

ListView.Sorting Özellik dışında bir değere SortOrder.None ayarlanırsa veya özelliği ayarlanırsaListViewItemSorter, liste öğe eklendikten sonra sıralanır. Aksi takdirde, öğe listenin sonuna eklenir. Liste sıralanmamışsa, belirli bir konumda öğesine öğe ListView eklemek için yöntemini kullanabilirsinizInsert. Tek bir işlemde denetime bir öğe kümesi eklemek için yöntemini kullanın AddRange . Denetimine Add çok sayıda öğe eklemek için yöntemini kullanmak istiyorsanız, tüm öğeler eklenene kadar öğesinin yeniden boyanmasını ListView önlemek için ve EndUpdate yöntemlerini kullanınBeginUpdate. öğesine ListViewöğe eklerken, önce öğeleri sıralamak ve sonra yeni öğeler eklemek daha verimli olur.

Yönteminin Add bu sürümü, öğesine ListViewItem atamak için ListViewGroupde kullanılır.

Ayrıca bkz.

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

Add(String, Int32)

Kaynak:

ListView.ListViewItemCollection.cs

Belirtilen metin ve görüntüyle bir öğe oluşturur ve bunu koleksiyona ekler.

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

Parametreler

text

String

Öğenin metni.

imageIndex

Int32

Öğenin görüntüleneceği görüntünün dizini.

Döndürülenler

ListViewItem

ListViewItem Koleksiyona eklenen.

Açıklamalar

Denetime eklenecek yeni ListViewItem bir oluşturmak için yönteminin ListView bu sürümünü Add kullanabilirsiniz. Denetime eklenen yeninin ListViewItem metni parametresini text temel alır. Ayrıca ve özelliklerine imageIndex atanan dizinini ImageList parametresine ListView.LargeImageListListView.SmallImageList geçirerek öğe için bir görüntü belirtebilirsiniz. (Genellikle ve ListView.SmallImageList özellikleri ilgili ListView.LargeImageList görüntüleri görüntülemek için aynı dizin konumlarını kullanır.) Öğe için görüntü dizini belirtmek istemiyorsanız, yöntemin Add parametre olarak yalnızca bir dizeyi kabul eden sürümünü kullanın. Koleksiyona eklemek istediğiniz bir var olan ListViewItem varsa, yöntemin Add parametresi olarak kabul ListViewItem eden sürümünü kullanın.

ListView.Sorting Özellik dışında bir değere SortOrder.None ayarlanırsa veya özelliği ayarlanırsaListViewItemSorter, liste öğe eklendikten sonra sıralanır. Aksi takdirde, öğe listenin sonuna eklenir. Liste sıralanmamışsa, belirli bir konumda öğesine öğe ListView eklemek için yöntemini kullanabilirsinizInsert. Tek bir işlemde denetime bir öğe kümesi eklemek için yöntemini kullanın AddRange . Denetimine Add çok sayıda öğe eklemek için yöntemini kullanmak istiyorsanız, tüm öğeler eklenene kadar öğesinin yeniden boyanmasını ListView önlemek için ve EndUpdate yöntemlerini kullanınBeginUpdate. öğesine ListViewöğe eklerken, önce öğeleri sıralamak ve sonra yeni öğeler eklemek daha verimli olur.

Ayrıca bkz.

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

Add(String, String)

Kaynak:

ListView.ListViewItemCollection.cs

Belirtilen metin ve görüntüyle bir öğe oluşturur ve bunu koleksiyona ekler.

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

Parametreler

text

String

Öğenin metni.

imageKey

String

Öğenin görüntüleneceği görüntünün anahtarı.

Döndürülenler

ListViewItem

ListViewItem koleksiyonuna eklendi.

Açıklamalar

ListView sıralanmışsa, öğe doğru sıralanmış düzende eklenir; aksi takdirde, koleksiyonun sonuna eklenir.

Add(String, String, Int32)

Kaynak:

ListView.ListViewItemCollection.cs

Belirtilen anahtar, metin ve görüntü ile bir öğe oluşturur ve koleksiyona bir öğe ekler.

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

Parametreler

key

String

Öğenin adı.

text

String

Öğenin metni.

imageIndex

Int32

Öğenin görüntüleneceği görüntünün dizini.

Döndürülenler

ListViewItem

ListViewItem koleksiyonuna eklendi.

Özel durumlar

InvalidOperationException

içeren ListView sanal moddadır.

Açıklamalar

ListView sıralanmışsa, öğe doğru sıralanmış düzende eklenir; aksi takdirde, koleksiyonun sonuna eklenir. Name özelliği içindeki anahtarına ListViewItemListView.ListViewItemCollectionkarşılık gelir.

Add yöntemi özelliği belirtilen anahtara ayarlarName, böylece öğe dizini veya anahtar tarafından alınabilir.

Add(String, String, String)

Kaynak:

ListView.ListViewItemCollection.cs

Belirtilen anahtar, metin ve görüntü ile bir öğe oluşturur ve bunu koleksiyona ekler.

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

Parametreler

key

String

Öğenin adı.

text

String

Öğenin metni.

imageKey

String

Öğenin görüntüleneceği görüntünün anahtarı.

Döndürülenler

ListViewItem

ListViewItem koleksiyonuna eklendi.

Açıklamalar

Name özelliği içindeki anahtarına ListViewItemListView.ListViewItemCollectionkarşılık gelir.

ListView sıralanmışsa, öğe doğru sıralanmış düzende eklenir; aksi takdirde, koleksiyonun sonuna eklenir. Add yöntemi öğenin özelliğini belirtilen anahtara ayarlarName, böylece öğe dizini veya anahtarıyla alınabilir.