ListView.ListViewItemCollection.Add Método

Definição

Adiciona um item à coleção de itens.Adds an item to the collection of items.

Sobrecargas

Add(String)

Cria um item com o texto especificado e o adiciona à coleção.Creates an item with the specified text and adds it to the collection.

Add(ListViewItem)

Adiciona um ListViewItem existente à coleção.Adds an existing ListViewItem to the collection.

Add(String, Int32)

Cria um item com o texto e imagem especificados e o adiciona à coleção.Creates an item with the specified text and image and adds it to the collection.

Add(String, String)

Cria um item com o texto e imagem especificados e o adiciona à coleção.Creates an item with the specified text and image and adds it to the collection.

Add(String, String, Int32)

Cria um item com a chave, o texto e a imagem especificados e adiciona um item à coleção.Creates an item with the specified key, text, and image and adds an item to the collection.

Add(String, String, String)

Cria um item com a chave, o texto e a imagem especificados e o adiciona à coleção.Creates an item with the specified key, text, and image, and adds it to the collection.

Add(String)

Cria um item com o texto especificado e o adiciona à coleção.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

Parâmetros

text
String

O texto a ser exibido para o item.The text to display for the item.

Retornos

O ListViewItem adicionado à coleção.The ListViewItem that was added to the collection.

Comentários

Você pode usar esta versão do método Add para criar um novo ListViewItem a ser adicionado a um controle de ListView.You can use this version of the Add method to create a new ListViewItem to add to a ListView control. O texto do novo ListViewItem adicionado ao controle é baseado no parâmetro text.The text of the new ListViewItem added to the control is based on the text parameter. Se você quiser especificar uma imagem para o item, use a versão do método Add que aceita um índice de imagem como um parâmetro.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. Se você tiver um ListViewItem existente que deseja adicionar à coleção, use a versão do método Add que aceita uma ListViewItem como seu parâmetro.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.

Se a propriedade ListView.Sorting for definida com um valor diferente de SortOrder.None ou se a propriedade ListViewItemSorter for definida, a lista será classificada depois que o item for adicionado.If 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. Caso contrário, o item será inserido no final da lista.Otherwise, the item is inserted at the end of the list. Se a lista não estiver classificada, você poderá usar o método Insert para inserir um item no ListView em uma posição específica.If the list is not sorted, you can use the Insert method to insert an item into the ListView at a specific position. Para adicionar um conjunto de itens ao controle em uma única operação, use o método AddRange.To add a set of items to the control in a single operation, use the AddRange method. Se você quiser usar o método Add para adicionar um grande número de itens ao controle, use os métodos BeginUpdate e EndUpdate para impedir que o ListView seja redesenhado até que todos os itens sejam adicionados.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. Ao adicionar itens a um ListView, é mais eficiente classificar os itens primeiro e, em seguida, adicionar novos itens.When adding items to a ListView, it is more efficient to sort the items first and then add new items.

Veja também

Add(ListViewItem)

Adiciona um ListViewItem existente à coleção.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

Parâmetros

value
ListViewItem

O ListViewItem a adicionar à coleção.The ListViewItem to add to the collection.

Retornos

O ListViewItem adicionado à coleção.The ListViewItem that was added to the collection.

Comentários

Você pode usar esta versão do método Add para adicionar um ListViewItem existente à coleção.You can use this version of the Add method to add an existing ListViewItem to the collection. Essa versão do método Add normalmente é usada para reutilizar itens de outros controles de ListView ou se o ListViewItem tiver sido criado manualmente antes de adicioná-lo à coleção.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. Se você quiser criar um novo ListViewItem em vez de usar um item existente, use as outras versões do método Add.If you want to create a new ListViewItem instead of using an existing item, use the other versions of the Add method.

Se a propriedade ListView.Sorting for definida com um valor diferente de SortOrder.None ou se a propriedade ListViewItemSorter for definida, a lista será classificada depois que o item for adicionado.If 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. Caso contrário, o item será inserido no final da lista.Otherwise, the item is inserted at the end of the list. Se a lista não estiver classificada, você poderá usar o método Insert para inserir um item no ListView em uma posição específica.If the list is not sorted, you can use the Insert method to insert an item into the ListView at a specific position. Para adicionar um conjunto de itens ao controle em uma única operação, use o método AddRange.To add a set of items to the control in a single operation, use the AddRange method. Se você quiser usar o método Add para adicionar um grande número de itens ao controle, use os métodos BeginUpdate e EndUpdate para impedir que o ListView seja redesenhado até que todos os itens sejam adicionados.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. Ao adicionar itens a um ListView, é mais eficiente classificar os itens primeiro e, em seguida, adicionar novos itens.When adding items to a ListView, it is more efficient to sort the items first and then add new items.

Essa versão do método Add também é usada para atribuir um ListViewItem a um ListViewGroup.This version of the Add method is also used to assign a ListViewItem to a ListViewGroup.

Veja também

Add(String, Int32)

Cria um item com o texto e imagem especificados e o adiciona à coleção.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

Parâmetros

text
String

O texto do item.The text of the item.

imageIndex
Int32

O índice da imagem a ser exibida para o item.The index of the image to display for the item.

Retornos

O ListViewItem adicionado à coleção.The ListViewItem that was added to the collection.

Comentários

Você pode usar esta versão do método Add para criar um novo ListViewItem para adicionar ao controle de ListView.You can use this version of the Add method to create a new ListViewItem to add to the ListView control. O texto do novo ListViewItem adicionado ao controle é baseado no parâmetro text.The text of the new ListViewItem added to the control is based on the text parameter. Você também pode especificar uma imagem para o item passando o índice do ImageList atribuído às propriedades ListView.LargeImageList e ListView.SmallImageList para o parâmetro 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. (Normalmente, as propriedades ListView.LargeImageList e ListView.SmallImageList usam as mesmas posições de índice para exibir imagens relacionadas.) Se você não quiser especificar um índice de imagem para o item, use a versão do método Add que aceita apenas uma cadeia de caracteres como um parâmetro.(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. Se você tiver um ListViewItem existente que deseja adicionar à coleção, use a versão do método Add que aceita uma ListViewItem como seu parâmetro.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.

Se a propriedade ListView.Sorting for definida com um valor diferente de SortOrder.None ou se a propriedade ListViewItemSorter for definida, a lista será classificada depois que o item for adicionado.If 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. Caso contrário, o item será inserido no final da lista.Otherwise, the item is inserted at the end of the list. Se a lista não estiver classificada, você poderá usar o método Insert para inserir um item no ListView em uma posição específica.If the list is not sorted, you can use the Insert method to insert an item into the ListView at a specific position. Para adicionar um conjunto de itens ao controle em uma única operação, use o método AddRange.To add a set of items to the control in a single operation, use the AddRange method. Se você quiser usar o método Add para adicionar um grande número de itens ao controle, use os métodos BeginUpdate e EndUpdate para impedir que o ListView seja redesenhado até que todos os itens sejam adicionados.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. Ao adicionar itens a um ListView, é mais eficiente classificar os itens primeiro e, em seguida, adicionar novos itens.When adding items to a ListView, it is more efficient to sort the items first and then add new items.

Veja também

Add(String, String)

Cria um item com o texto e imagem especificados e o adiciona à coleção.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

Parâmetros

text
String

O texto do item.The text of the item.

imageKey
String

A chave da imagem a ser exibida para o item.The key of the image to display for the item.

Retornos

O ListViewItem adicionado à coleção.The ListViewItem added to the collection.

Comentários

Se a ListView for classificada, o item será adicionado na ordem classificada corretamente; caso contrário, ele será adicionado ao final da coleção.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)

Cria um item com a chave, o texto e a imagem especificados e adiciona um item à coleção.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

Parâmetros

key
String

O nome do item.The name of the item.

text
String

O texto do item.The text of the item.

imageIndex
Int32

O índice da imagem a ser exibida para o item.The index of the image to display for the item.

Retornos

O ListViewItem adicionado à coleção.The ListViewItem added to the collection.

Exceções

O ListView recipiente está no modo virtual.The containing ListView is in virtual mode.

Comentários

Se a ListView for classificada, o item será adicionado na ordem classificada corretamente; caso contrário, ele será adicionado ao final da coleção.If the ListView is sorted, the item is added in the correctly sorted order; otherwise, it is added to the end of the collection. A propriedade Name corresponde à chave de um ListViewItem no ListView.ListViewItemCollection.The Name property corresponds to the key for a ListViewItem in the ListView.ListViewItemCollection.

O método Add define a propriedade Name para a chave especificada, de modo que o item pode ser recuperado por seu índice ou por chave.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)

Cria um item com a chave, o texto e a imagem especificados e o adiciona à coleção.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

Parâmetros

key
String

O nome do item.The name of the item.

text
String

O texto do item.The text of the item.

imageKey
String

A chave da imagem a ser exibida para o item.The key of the image to display for the item.

Retornos

O ListViewItem adicionado à coleção.The ListViewItem added to the collection.

Comentários

A propriedade Name corresponde à chave de um ListViewItem no ListView.ListViewItemCollection.The Name property corresponds to the key for a ListViewItem in the ListView.ListViewItemCollection.

Se a ListView for classificada, o item será adicionado na ordem classificada corretamente; caso contrário, ele será adicionado ao final da coleção.If the ListView is sorted, the item is added in the correctly sorted order; otherwise, it is added to the end of the collection. O método Add define a propriedade Name do item para a chave especificada, de modo que o item pode ser recuperado por seu índice ou por chave.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.

Aplica-se a