Поделиться через


ListView.ListViewItemCollection.Add Метод

Определение

Добавляет элемент в коллекцию элементов.

Перегрузки

Add(String)

Создает элемент с заданным текстом и добавляет его в коллекцию.

Add(ListViewItem)

Добавляет существующий ListViewItem в коллекцию.

Add(String, Int32)

Создает элемент с заданным текстом и изображением и добавляет его в коллекцию.

Add(String, String)

Создает элемент с заданным текстом и изображением и добавляет его в коллекцию.

Add(String, String, Int32)

Создает элемент с заданным ключом, текстом и изображением и добавляет этот элемент в коллекцию.

Add(String, String, String)

Создает элемент с заданным ключом, текстом и изображением и добавляет этот элемент в коллекцию.

Add(String)

Создает элемент с заданным текстом и добавляет его в коллекцию.

public:
 virtual System::Windows::Forms::ListViewItem ^ Add(System::String ^ text);
public virtual System.Windows.Forms.ListViewItem Add (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

Текст, отображаемый для элемента.

Возвращаемое значение

Объект ListViewItem, добавленный в коллекцию.

Комментарии

Эту версию метода можно использовать для Add создания нового ListViewItem объекта для добавления в ListView элемент управления . Текст нового ListViewItem объекта, добавленного в элемент управления , основан на параметре text . Если вы хотите указать изображение для элемента, используйте версию Add метода , которая принимает индекс изображения в качестве параметра. Если у вас есть объект ListViewItem , который вы хотите добавить в коллекцию, используйте версию Add метода , которая принимает в ListViewItem качестве параметра .

Если свойству ListView.Sorting присвоено значение, отличное SortOrder.None от или если ListViewItemSorter свойство задано, список сортируется после добавления элемента. В противном случае элемент вставляется в конец списка. Если список не отсортирован, можно использовать метод для Insert вставки элемента в ListView объект в определенной позиции. Чтобы добавить набор элементов в элемент управления за одну операцию, используйте AddRange метод . Если вы хотите использовать Add метод для добавления большого количества элементов в элемент управления, используйте BeginUpdate метод и EndUpdate , чтобы предотвратить ListView перерисовку до тех пор, пока не будут добавлены все элементы. При добавлении элементов в ListViewэффективнее сначала отсортировать элементы, а затем добавить новые.

См. также раздел

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

Add(ListViewItem)

Добавляет существующий ListViewItem в коллекцию.

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 для добавления в коллекцию.

Возвращаемое значение

Объект ListViewItem, добавленный в коллекцию.

Комментарии

Эту версию метода можно использовать для Add добавления существующего ListViewItem объекта в коллекцию. Эта версия метода обычно используется для повторного Add использования элементов из других ListView элементов управления или, если ListViewItem объект был создан вручную перед добавлением его в коллекцию. Если вы хотите создать новый ListViewItem , а не использовать существующий элемент, используйте другие версии Add метода .

Если свойству ListView.Sorting присвоено значение, отличное SortOrder.None от или если ListViewItemSorter свойство задано, список сортируется после добавления элемента. В противном случае элемент вставляется в конец списка. Если список не отсортирован, можно использовать метод для Insert вставки элемента в ListView объект в определенной позиции. Чтобы добавить набор элементов в элемент управления за одну операцию, используйте AddRange метод . Если вы хотите использовать Add метод для добавления большого количества элементов в элемент управления, используйте BeginUpdate метод и EndUpdate , чтобы предотвратить ListView перерисовку до тех пор, пока не будут добавлены все элементы. При добавлении элементов в ListViewэффективнее сначала отсортировать элементы, а затем добавить новые.

Эта версия Add метода также используется для назначения ListViewItemListViewGroup.

См. также раздел

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

Add(String, Int32)

Создает элемент с заданным текстом и изображением и добавляет его в коллекцию.

public:
 virtual System::Windows::Forms::ListViewItem ^ Add(System::String ^ text, int imageIndex);
public virtual System.Windows.Forms.ListViewItem Add (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

Текст данного элемента.

imageIndex
Int32

Индекс изображения для данного элемента.

Возвращаемое значение

Объект ListViewItem, добавленный в коллекцию.

Комментарии

Эту версию метода можно использовать для Add создания нового ListViewItem объекта для добавления в ListView элемент управления . Текст нового ListViewItem объекта, добавленного в элемент управления , основан на параметре text . Вы также можете указать изображение для элемента, передав индекс свойствам ImageListListView.LargeImageList и ListView.SmallImageListimageIndex в параметр . (Как правило, ListView.LargeImageList свойства и используют одни и ListView.SmallImageList те же позиции индекса для отображения связанных изображений.) Если вы не хотите указывать индекс изображения для элемента, используйте версию Add метода , которая принимает в качестве параметра только строку. Если у вас есть объект ListViewItem , который вы хотите добавить в коллекцию, используйте версию Add метода , которая принимает в ListViewItem качестве параметра .

Если свойству ListView.Sorting присвоено значение, отличное SortOrder.None от или если ListViewItemSorter свойство задано, список сортируется после добавления элемента. В противном случае элемент вставляется в конец списка. Если список не отсортирован, можно использовать метод для Insert вставки элемента в ListView объект в определенной позиции. Чтобы добавить набор элементов в элемент управления за одну операцию, используйте AddRange метод . Если вы хотите использовать Add метод для добавления большого количества элементов в элемент управления, используйте BeginUpdate метод и EndUpdate , чтобы предотвратить ListView перерисовку до тех пор, пока не будут добавлены все элементы. При добавлении элементов в ListViewэффективнее сначала отсортировать элементы, а затем добавить новые.

См. также раздел

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

Add(String, String)

Создает элемент с заданным текстом и изображением и добавляет его в коллекцию.

public:
 virtual System::Windows::Forms::ListViewItem ^ Add(System::String ^ text, System::String ^ imageKey);
public virtual System.Windows.Forms.ListViewItem Add (string text, 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

Текст данного элемента.

imageKey
String

Ключ изображения для данного элемента.

Возвращаемое значение

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

Комментарии

ListView Если объект отсортирован, элемент добавляется в правильном порядке сортировки; в противном случае он добавляется в конец коллекции.

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

Add(String, String, Int32)

Создает элемент с заданным ключом, текстом и изображением и добавляет этот элемент в коллекцию.

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);
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

Имя элемента.

text
String

Текст данного элемента.

imageIndex
Int32

Индекс изображения для данного элемента.

Возвращаемое значение

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

Исключения

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

Комментарии

ListView Если объект отсортирован, элемент добавляется в правильном порядке сортировки; в противном случае он добавляется в конец коллекции. Свойство Name соответствует ключу для в ListViewItemListView.ListViewItemCollection.

Метод Add задает для Name свойства указанный ключ, чтобы элемент можно было получить по индексу или ключу.

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

Add(String, String, String)

Создает элемент с заданным ключом, текстом и изображением и добавляет этот элемент в коллекцию.

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);
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

Имя элемента.

text
String

Текст данного элемента.

imageKey
String

Ключ изображения для данного элемента.

Возвращаемое значение

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

Комментарии

Свойство Name соответствует ключу для в ListViewItemListView.ListViewItemCollection.

ListView Если объект отсортирован, элемент добавляется в правильном порядке сортировки; в противном случае он добавляется в конец коллекции. Метод Add задает Name для свойства элемента указанный ключ, чтобы элемент можно было получить по индексу или ключу.

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