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

Add(String)	Belirtilen metinle bir öğe oluşturur ve öğeyi koleksiyona ekler.
Add(ListViewItem)	Var olanı ListViewItem koleksiyona ekler.
Add(String, Int32)	Belirtilen metin ve görüntüyle bir öğe oluşturur ve öğeyi koleksiyona ekler.
Add(String, String)	Belirtilen metin ve görüntüyle bir öğe oluşturur ve öğeyi koleksiyona ekler.
Add(String, String, Int32)	Belirtilen anahtar, metin ve görüntüyle 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)

Belirtilen metinle bir öğe oluşturur ve öğeyi 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. Denetime tek bir işlemde öğe kümesi eklemek için yöntemini kullanın AddRange . Denetime çok sayıda öğe eklemek için yöntemini kullanmak Add 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 verimlidir.

Ayrıca bkz.

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

Add(ListViewItem)

Var olanı ListViewItem koleksiyona 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 öğesini seçin.

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. Var olan bir öğeyi kullanmak yerine yeni ListViewItem bir öğe oluşturmak istiyorsanız, yönteminin 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. Denetime tek bir işlemde öğe kümesi eklemek için yöntemini kullanın AddRange . Denetime çok sayıda öğe eklemek için yöntemini kullanmak Add 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 verimlidir.

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

Ayrıca bkz.

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

Add(String, Int32)

Belirtilen metin ve görüntüyle bir öğe oluşturur ve öğeyi 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.LargeImageList ListView.SmallImageList geçirerek öğe için bir görüntü belirtebilirsiniz. (Ve özellikleri genellikle ListView.LargeImageList ListView.SmallImageList ilgili 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 yalnızca bir dizeyi Add 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. Denetime tek bir işlemde öğe kümesi eklemek için yöntemini kullanın AddRange . Denetime çok sayıda öğe eklemek için yöntemini kullanmak Add 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 verimlidir.

Ayrıca bkz.

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

Add(String, String)

Belirtilen metin ve görüntüyle bir öğe oluşturur ve öğeyi 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 koleksiyona eklendi.

Açıklamalar

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

Add(String, String, Int32)

Belirtilen anahtar, metin ve görüntüyle 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 koleksiyona 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 için ListViewItem anahtarına ListView.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)

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 koleksiyona eklendi.

Açıklamalar

Name özelliği içindeki için ListViewItem anahtarına ListView.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.