ListView.ListViewItemCollection.Add Método

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Adiciona um item à coleção de itens.

Sobrecargas

Add(String)	Cria um item com o texto especificado e o adiciona à coleção.
Add(ListViewItem)	Adiciona um ListViewItem existente à coleção.
Add(String, Int32)	Cria um item com o texto e imagem especificados e o adiciona à coleção.
Add(String, String)	Cria um item com o texto e imagem especificados e o adiciona à coleção.
Add(String, String, Int32)	Cria um item com a chave, o texto e a imagem especificados e adiciona um item à coleção.
Add(String, String, String)	Cria um item com a chave, o texto e a imagem especificados e o adiciona à coleção.

Add(String)

Cria um item com o texto especificado e o adiciona à coleção.

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.

Retornos

ListViewItem

O ListViewItem adicionado à coleção.

Comentários

Você pode usar essa versão do Add método para criar um novo ListViewItem para adicionar a um ListView controle. O texto do novo ListViewItem adicionado ao controle baseia-se no text parâmetro. Se você quiser especificar uma imagem para o item, use a versão do Add método que aceita um índice de imagem como parâmetro. Se você tiver um existente ListViewItem que deseja adicionar à coleção, use a versão do Add método que aceita um ListViewItem como parâmetro.

Se a ListView.Sorting propriedade for definida como um valor diferente SortOrder.None ou se a ListViewItemSorter propriedade estiver definida, a lista será classificada após a adição do item. Caso contrário, o item será inserido no final da lista. Se a lista não estiver classificada, você poderá usar o Insert método para inserir um item em ListView uma posição específica. Para adicionar um conjunto de itens ao controle em uma única operação, use o AddRange método. Se você quiser usar o Add método para adicionar um grande número de itens ao controle, use os métodos e EndUpdate os BeginUpdate métodos para impedir a ListView repintação até que todos os itens sejam adicionados. Ao adicionar itens a um ListView, é mais eficiente classificar os itens primeiro e, em seguida, adicionar novos itens.

Confira também

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

Add(ListViewItem)

Adiciona um ListViewItem existente à coleção.

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.

Retornos

ListViewItem

O ListViewItem adicionado à coleção.

Comentários

Você pode usar essa versão do Add método para adicionar um existente ListViewItem à coleção. Essa versão do Add método normalmente é usada para reutilizar itens de outros ListView controles ou se o ListViewItem foi criado manualmente antes de adicioná-lo à coleção. Se você quiser criar um novo ListViewItem em vez de usar um item existente, use as outras versões do Add método.

Se a ListView.Sorting propriedade for definida como um valor diferente SortOrder.None ou se a ListViewItemSorter propriedade estiver definida, a lista será classificada após a adição do item. Caso contrário, o item será inserido no final da lista. Se a lista não estiver classificada, você poderá usar o Insert método para inserir um item em ListView uma posição específica. Para adicionar um conjunto de itens ao controle em uma única operação, use o AddRange método. Se você quiser usar o Add método para adicionar um grande número de itens ao controle, use os métodos e EndUpdate os BeginUpdate métodos para impedir a ListView repintação até que todos os itens sejam adicionados. Ao adicionar itens a um ListView, é mais eficiente classificar os itens primeiro e, em seguida, adicionar novos itens.

Essa versão do Add método também é usada para atribuir um ListViewItem a um ListViewGroup.

Confira também

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

Add(String, Int32)

Cria um item com o texto e imagem especificados e o adiciona à coleção.

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.

imageIndex

Int32

O índice da imagem a ser exibida para o item.

Retornos

ListViewItem

O ListViewItem adicionado à coleção.

Comentários

Você pode usar essa versão do Add método para criar um novo ListViewItem para adicionar ao ListView controle. O texto do novo ListViewItem adicionado ao controle baseia-se no text parâmetro. Você também pode especificar uma imagem para o item passando o índice do ImageList atribuído e ListView.LargeImageList ListView.SmallImageList as propriedades para o imageIndex parâmetro. (Normalmente, as propriedades e ListView.SmallImageList as ListView.LargeImageList propriedades 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 Add método que aceita apenas uma cadeia de caracteres como um parâmetro. Se você tiver um existente ListViewItem que deseja adicionar à coleção, use a versão do Add método que aceita um ListViewItem como parâmetro.

Se a ListView.Sorting propriedade for definida como um valor diferente SortOrder.None ou se a ListViewItemSorter propriedade estiver definida, a lista será classificada após a adição do item. Caso contrário, o item será inserido no final da lista. Se a lista não estiver classificada, você poderá usar o Insert método para inserir um item em ListView uma posição específica. Para adicionar um conjunto de itens ao controle em uma única operação, use o AddRange método. Se você quiser usar o Add método para adicionar um grande número de itens ao controle, use os métodos e EndUpdate os BeginUpdate métodos para impedir a ListView repintação até que todos os itens sejam adicionados. Ao adicionar itens a um ListView, é mais eficiente classificar os itens primeiro e, em seguida, adicionar novos itens.

Confira também

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

Add(String, String)

Cria um item com o texto e imagem especificados e o adiciona à coleção.

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.

imageKey

String

A chave da imagem a ser exibida para o item.

Retornos

ListViewItem

O ListViewItem adicionado à coleção.

Comentários

Se o ListView item for classificado, o item será adicionado na ordem classificada corretamente; caso contrário, ele será adicionado ao final da coleção.

Add(String, String, Int32)

Cria um item com a chave, o texto e a imagem especificados e adiciona um item à coleção.

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.

text

String

O texto do item.

imageIndex

Int32

O índice da imagem a ser exibida para o item.

Retornos

ListViewItem

O ListViewItem adicionado à coleção.

Exceções

InvalidOperationException

O ListView recipiente está no modo virtual.

Comentários

Se o ListView item for classificado, o item será adicionado na ordem classificada corretamente; caso contrário, ele será adicionado ao final da coleção. A Name propriedade corresponde à chave de um ListViewItem no ListView.ListViewItemCollection.

O Add método define a Name propriedade como a chave especificada, para que o item possa ser recuperado por seu índice ou por chave.

Add(String, String, String)

Cria um item com a chave, o texto e a imagem especificados e o adiciona à coleção.

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.

text

String

O texto do item.

imageKey

String

A chave da imagem a ser exibida para o item.

Retornos

ListViewItem

O ListViewItem adicionado à coleção.

Comentários

A Name propriedade corresponde à chave de um ListViewItem no ListView.ListViewItemCollection.

Se o ListView item for classificado, o item será adicionado na ordem classificada corretamente; caso contrário, ele será adicionado ao final da coleção. O Add método define a Name propriedade do item como a chave especificada, de modo que o item possa ser recuperado por seu índice ou por chave.