ListView.ListViewItemCollection.Add Метод

Определение

Добавляет элемент в коллекцию элементов.Adds an item to the collection of items.

Перегрузки

Add(String)

Создает элемент с заданным текстом и добавляет его в коллекцию.Creates an item with the specified text and adds it to the collection.

Add(ListViewItem)

Добавляет существующий ListViewItem в коллекцию.Adds an existing ListViewItem to the collection.

Add(String, Int32)

Создает элемент с заданным текстом и изображением и добавляет его в коллекцию.Creates an item with the specified text and image and adds it to the collection.

Add(String, String)

Создает элемент с заданным текстом и изображением и добавляет его в коллекцию.Creates an item with the specified text and image and adds it to the collection.

Add(String, String, Int32)

Создает элемент с заданным ключом, текстом и изображением и добавляет этот элемент в коллекцию.Creates an item with the specified key, text, and image and adds an item to the collection.

Add(String, String, String)

Создает элемент с заданным ключом, текстом и изображением и добавляет этот элемент в коллекцию.Creates an item with the specified key, text, and image, and adds it to the collection.

Add(String)

Создает элемент с заданным текстом и добавляет его в коллекцию.Creates an item with the specified text and adds it to the collection.

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

Параметры

text
String

Текст, отображаемый для элемента.The text to display for the item.

Возвраты

Объект ListViewItem, добавленный в коллекцию.The ListViewItem that was added to the collection.

Комментарии

Эту версию Add метода можно использовать для создания нового ListViewItem объекта для добавления в ListView элемент управления.You can use this version of the Add method to create a new ListViewItem to add to a ListView control. Текст нового ListViewItem элемента, добавленного в элемент управления, основан text на параметре.The text of the new ListViewItem added to the control is based on the text parameter. Если необходимо указать изображение для элемента, используйте версию Add метода, который принимает индекс изображения в качестве параметра.If you want to specify an image for the item, use the version of the Add method that accepts an image index as a parameter. Если у вас есть существующий ListViewItem объект, который необходимо добавить в коллекцию, используйте версию Add метода, принимающего в ListViewItem качестве параметра.If you have an existing ListViewItem that you want to add to the collection, use the version of the Add method that accepts a ListViewItem as its parameter.

Если свойству присвоено значение, отличное от SortOrder.None , или если ListViewItemSorter свойство задано, список сортируется после добавления элемента. ListView.SortingIf the ListView.Sorting property is set to a value other than SortOrder.None or if the ListViewItemSorter property is set, the list is sorted after the item is added. В противном случае элемент вставляется в конец списка.Otherwise, the item is inserted at the end of the list. Если список не отсортирован, можно использовать Insert метод для вставки элемента ListView в заданную позицию.If the list is not sorted, you can use the Insert method to insert an item into the ListView at a specific position. Чтобы добавить набор элементов в элемент управления за одну операцию, используйте AddRange метод.To add a set of items to the control in a single operation, use the AddRange method. Если вы хотите Add использовать метод для добавления большого количества элементов в элемент управления, BeginUpdate используйте методы и EndUpdate , чтобы предотвратить перерисовку, ListView пока не будут добавлены все элементы.If you want to use the Add method to add a large number of items to the control, use the BeginUpdate and EndUpdate methods to prevent the ListView from repainting until all items are added. При добавлении элементов в ListView, более эффективно сортировать элементы сначала, а затем добавлять новые элементы.When adding items to a ListView, it is more efficient to sort the items first and then add new items.

Дополнительно

Add(ListViewItem)

Добавляет существующий ListViewItem в коллекцию.Adds an existing ListViewItem to the collection.

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

Параметры

value
ListViewItem

Параметр ListViewItem для добавления в коллекцию.The ListViewItem to add to the collection.

Возвраты

Объект ListViewItem, добавленный в коллекцию.The ListViewItem that was added to the collection.

Комментарии

Эту версию Add метода можно использовать для добавления существующего ListViewItem объекта в коллекцию.You can use this version of the Add method to add an existing ListViewItem to the collection. Эта версия Add метода обычно используется для повторного использования элементов из других ListView элементов управления или, если ListViewItem объект был создан вручную перед его добавлением в коллекцию.This version of the Add method is typically used to reuse items from other ListView controls or if the ListViewItem was created manually before adding it to the collection. Если вы хотите создать новый ListViewItem вместо использования существующего элемента, используйте другие версии Add метода.If you want to create a new ListViewItem instead of using an existing item, use the other versions of the Add method.

Если свойству присвоено значение, отличное от SortOrder.None , или если ListViewItemSorter свойство задано, список сортируется после добавления элемента. ListView.SortingIf the ListView.Sorting property is set to a value other than SortOrder.None or if the ListViewItemSorter property is set, the list is sorted after the item is added. В противном случае элемент вставляется в конец списка.Otherwise, the item is inserted at the end of the list. Если список не отсортирован, можно использовать Insert метод для вставки элемента ListView в заданную позицию.If the list is not sorted, you can use the Insert method to insert an item into the ListView at a specific position. Чтобы добавить набор элементов в элемент управления за одну операцию, используйте AddRange метод.To add a set of items to the control in a single operation, use the AddRange method. Если вы хотите Add использовать метод для добавления большого количества элементов в элемент управления, BeginUpdate используйте методы и EndUpdate , чтобы предотвратить перерисовку, ListView пока не будут добавлены все элементы.If you want to use the Add method to add a large number of items to the control, use the BeginUpdate and EndUpdate methods to prevent the ListView from repainting until all items are added. При добавлении элементов в ListView, более эффективно сортировать элементы сначала, а затем добавлять новые элементы.When adding items to a ListView, it is more efficient to sort the items first and then add new items.

Эта версия Add метода также используется для ListViewItem присвоения значения ListViewGroup.This version of the Add method is also used to assign a ListViewItem to a ListViewGroup.

Дополнительно

Add(String, Int32)

Создает элемент с заданным текстом и изображением и добавляет его в коллекцию.Creates an item with the specified text and image and adds it to the collection.

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

Параметры

text
String

Текст данного элемента.The text of the item.

imageIndex
Int32

Индекс изображения для данного элемента.The index of the image to display for the item.

Возвраты

Объект ListViewItem, добавленный в коллекцию.The ListViewItem that was added to the collection.

Комментарии

Эту версию Add метода можно использовать для создания нового ListViewItem объекта для добавления в ListView элемент управления.You can use this version of the Add method to create a new ListViewItem to add to the ListView control. Текст нового ListViewItem элемента, добавленного в элемент управления, основан text на параметре.The text of the new ListViewItem added to the control is based on the text parameter. Можно также указать изображение для элемента, ImageList передав индекс объекта, назначенного ListView.LargeImageList свойствам и ListView.SmallImageList , в imageIndex параметр.You can also specify an image for the item by passing the index of the ImageList assigned to the ListView.LargeImageList and ListView.SmallImageList properties to the imageIndex parameter. (Как правило, ListView.LargeImageList свойства ListView.SmallImageList и используют одинаковые позиции индекса для вывода связанных изображений.) Если не нужно указывать индекс изображения для элемента, используйте версию Add метода, принимающую в качестве параметра только строку.(Typically, the ListView.LargeImageList and ListView.SmallImageList properties use the same index positions to display related images.) If you do not want to specify an image index for the item, use the version of the Add method that accepts only a string as a parameter. Если у вас есть существующий ListViewItem объект, который необходимо добавить в коллекцию, используйте версию Add метода, принимающего в ListViewItem качестве параметра.If you have an existing ListViewItem that you want to add to the collection, use the version of the Add method that accepts a ListViewItem as its parameter.

Если свойству присвоено значение, отличное от SortOrder.None , или если ListViewItemSorter свойство задано, список сортируется после добавления элемента. ListView.SortingIf the ListView.Sorting property is set to a value other than SortOrder.None or if the ListViewItemSorter property is set, the list is sorted after the item is added. В противном случае элемент вставляется в конец списка.Otherwise, the item is inserted at the end of the list. Если список не отсортирован, можно использовать Insert метод для вставки элемента ListView в заданную позицию.If the list is not sorted, you can use the Insert method to insert an item into the ListView at a specific position. Чтобы добавить набор элементов в элемент управления за одну операцию, используйте AddRange метод.To add a set of items to the control in a single operation, use the AddRange method. Если вы хотите Add использовать метод для добавления большого количества элементов в элемент управления, BeginUpdate используйте методы и EndUpdate , чтобы предотвратить перерисовку, ListView пока не будут добавлены все элементы.If you want to use the Add method to add a large number of items to the control, use the BeginUpdate and EndUpdate methods to prevent the ListView from repainting until all items are added. При добавлении элементов в ListView, более эффективно сортировать элементы сначала, а затем добавлять новые элементы.When adding items to a ListView, it is more efficient to sort the items first and then add new items.

Дополнительно

Add(String, String)

Создает элемент с заданным текстом и изображением и добавляет его в коллекцию.Creates an item with the specified text and image and adds it to the collection.

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

Параметры

text
String

Текст данного элемента.The text of the item.

imageKey
String

Ключ изображения для данного элемента.The key of the image to display for the item.

Возвраты

Атрибут ListViewItem, добавленный в коллекцию.The ListViewItem added to the collection.

Комментарии

ListView Если сортируется, элемент добавляется в правильном порядке сортировки. в противном случае он добавляется в конец коллекции.If the ListView is sorted, the item is added in the correctly sorted order; otherwise, it is added to the end of the collection.

Add(String, String, Int32)

Создает элемент с заданным ключом, текстом и изображением и добавляет этот элемент в коллекцию.Creates an item with the specified key, text, and image and adds an item to the collection.

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

Параметры

key
String

Имя элемента.The name of the item.

text
String

Текст данного элемента.The text of the item.

imageIndex
Int32

Индекс изображения для данного элемента.The index of the image to display for the item.

Возвраты

Атрибут ListViewItem, добавленный в коллекцию.The ListViewItem added to the collection.

Исключения

Содержащий объект ListView находится в виртуальном режиме.The containing ListView is in virtual mode.

Комментарии

ListView Если сортируется, элемент добавляется в правильном порядке сортировки. в противном случае он добавляется в конец коллекции.If the ListView is sorted, the item is added in the correctly sorted order; otherwise, it is added to the end of the collection. Свойство соответствует ключу ListViewItem для в ListView.ListViewItemCollection. NameThe Name property corresponds to the key for a ListViewItem in the ListView.ListViewItemCollection.

Add Метод задаетдлясвойствауказанныйключ,поэтомуэлементможетбытьизвлеченпоегоName индексу или ключу.The Add method sets the Name property to the specified key, so the item can be retrieved by its index or by key.

Add(String, String, String)

Создает элемент с заданным ключом, текстом и изображением и добавляет этот элемент в коллекцию.Creates an item with the specified key, text, and image, and adds it to the collection.

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

Параметры

key
String

Имя элемента.The name of the item.

text
String

Текст данного элемента.The text of the item.

imageKey
String

Ключ изображения для данного элемента.The key of the image to display for the item.

Возвраты

Атрибут ListViewItem, добавленный в коллекцию.The ListViewItem added to the collection.

Комментарии

Свойство соответствует ключу ListViewItem для в ListView.ListViewItemCollection. NameThe Name property corresponds to the key for a ListViewItem in the ListView.ListViewItemCollection.

ListView Если сортируется, элемент добавляется в правильном порядке сортировки. в противном случае он добавляется в конец коллекции.If the ListView is sorted, the item is added in the correctly sorted order; otherwise, it is added to the end of the collection. Add Метод задаетдлясвойстваэлементауказанныйключ,поэтомуэлементможетбытьизвлеченпоегоName индексу или ключу.The Add method sets the Name property of the item to the specified key, so the item can be retrieved by its index or by key.

Применяется к