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.ListViewItemPublic 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.ListViewItemPublic 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.ListViewItemPublic 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.ListViewItemPublic 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.ListViewItemPublic 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.ListViewItemPublic 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 для свойства элемента указанный ключ, чтобы элемент можно было получить по индексу или ключу.
