Exportar (0) Imprimir
Expandir Tudo
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original
Este tópico ainda não foi avaliado como - Avalie este tópico

Classe ListView.ListViewItemCollection

Representa a coleção de itens em um ListView controlar ou atribuídos a uma ListViewGroup.

System.Object
  System.Windows.Forms.ListView.ListViewItemCollection

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (em System.Windows.Forms.dll)
[ListBindableAttribute(false)]
public class ListViewItemCollection : IList, 
	ICollection, IEnumerable

O tipo ListView.ListViewItemCollection expõe os membros a seguir.

  NomeDescrição
Método públicoListView.ListViewItemCollectionInicializa uma nova instância da classe ListView.ListViewItemCollection.
Superior
  NomeDescrição
Propriedade públicaCountObtém o número de itens na coleção.
Propriedade públicaIsReadOnlyObtém um valor que indica se a coleção é somente leitura.
Propriedade públicaItem[Int32]Obtém ou define o item no índice especificado dentro da coleção.
Propriedade públicaItem[String]Recupera o item com a chave especificada.
Superior
  NomeDescrição
Método públicoAdd(ListViewItem)Adiciona uma existente ListViewItem à coleção.
Método públicoAdd(String)Cria um item com o texto especificado e o adiciona à coleção.
Método públicoAdd(String, Int32)Cria um item com o texto especificado e a imagem e o adiciona à coleção.
Método públicoAdd(String, String)Cria um item com o texto especificado e a imagem e o adiciona à coleção.
Método públicoAdd(String, String, Int32)Cria um item com a chave especificada, texto e imagem e adiciona um item à coleção.
Método públicoAdd(String, String, String)Cria um item com a chave especificada, texto e imagem e o adiciona à coleção.
Método públicoAddRange(ListView.ListViewItemCollection)Adiciona uma coleção de itens à coleção.
Método públicoAddRange(ListViewItem[])Adiciona uma matriz de ListViewItem objetos à coleção.
Método públicoClearRemove todos os itens da coleção.
Método públicoContainsDetermina se o item especificado está localizado na coleção.
Método públicoContainsKeyDetermina se a coleção contém um item com a chave especificada.
Método públicoCopyToCopia toda a coleção para um array existente em um local especificado no array.
Método públicoEquals(Object) Verifica se o objeto especificado é igual ao objeto atual. (Herdado de Object.)
Método protegidoFinalize Permite que um objeto tente liberar recursos e executar outras operações de limpeza antes que ele seja recuperado pela coleta de lixo. (Herdado de Object.)
Método públicoFindLocaliza itens cujo nome corresponde a chave especificada, opcionalmente, pesquisando subitens.
Método públicoGetEnumeratorRetorna um enumerador para usar para iterar na coleção de item.
Método públicoGetHashCodeServe como a função de hash padrão. (Herdado de Object.)
Método públicoGetType Obtém o Type da instância atual. (Herdado de Object.)
Método públicoIndexOfRetorna o índice dentro da coleção do item especificado.
Método públicoIndexOfKeyRecupera o índice do item com a chave especificada.
Método públicoInsert(Int32, String)Cria um novo item e o insere na coleção no índice especificado.
Método públicoInsert(Int32, ListViewItem)Insere uma existente ListViewItem na coleção no índice especificado.
Método públicoInsert(Int32, String, Int32)Cria um novo item com o índice da imagem especificada e o insere na coleção no índice especificado.
Método públicoInsert(Int32, String, String)Cria um novo item com o texto especificado e a imagem e o insere na coleção no índice especificado.
Método públicoInsert(Int32, String, String, Int32)Cria um novo item com a chave especificada, texto e imagem e o insere na coleção no índice especificado.
Método públicoInsert(Int32, String, String, String)Cria um novo item com a chave especificada, texto e imagem e o adiciona à coleção no índice especificado.
Método protegidoMemberwiseCloneCria uma cópia superficial do Object atual. (Herdado de Object.)
Método públicoRemoveRemove o item especificado da coleção.
Método públicoRemoveAtRemove o item no índice especificado dentro da coleção.
Método públicoRemoveByKeyRemove o item com a chave especificada da coleção.
Método públicoToStringRetorna uma string que representa o objeto atual. (Herdado de Object.)
Superior
  NomeDescrição
Método de extensão públicoAsParallel Permite a paralelização de uma consulta. (Definido por ParallelEnumerable.)
Método de extensão públicoAsQueryableConverts an IEnumerable to an IQueryable. (Definido por Queryable.)
Método de extensão públicoCast<TResult>Converte os elementos de IEnumerable para o tipo especificado. (Definido por Enumerable.)
Método de extensão públicoOfType<TResult>Filtra os elementos de IEnumerable baseado em um tipo especificado. (Definido por Enumerable.)
Superior
  NomeDescrição
Implementação explícita da interfacePropriedade particularICollection.IsSynchronizedInfraestrutura. Obtém um valor indicando se o acesso à coleção é sincronizado (segmento seguro).
Implementação explícita da interfacePropriedade particularICollection.SyncRootInfraestrutura. Obtém um objeto que pode ser usado para sincronizar o acesso à coleção de controles.
Implementação explícita da interfaceMétodo particularIList.AddInfraestrutura. Adiciona um objeto existente à coleção.
Implementação explícita da interfaceMétodo particularIList.ContainsInfraestrutura. Determina se o item especificado está na coleção.
Implementação explícita da interfaceMétodo particularIList.IndexOfInfraestrutura. Retorna o índice dentro da coleção do item especificado.
Implementação explícita da interfaceMétodo particularIList.InsertInfraestrutura. Insere um objeto na coleção no índice especificado.
Implementação explícita da interfacePropriedade particularIList.IsFixedSizeInfraestrutura. Obtém um valor indicando se a coleção tem um tamanho fixo.
Implementação explícita da interfacePropriedade particularIList.ItemInfraestrutura. Obtém ou define o ListViewItem no índice especificado dentro da coleção.
Implementação explícita da interfaceMétodo particularIList.RemoveInfraestrutura. Remove o item especificado da coleção.
Superior

A ListView.ListViewItemCollection armazena os itens exibidos em um ListView controlar ou atribuídos a uma ListViewGroup. Há duas outras coleções definidas dentro do ListView classe permitem que você determinar quais itens estão selecionados dentro de um ListView controle. O ListView.SelectedListViewItemCollection classe fornece propriedades e métodos para determinar quais itens estão selecionados em um ListView controle, enquanto o ListView.SelectedIndexCollection classe permite que você determinar quais dentro a ListView.ListViewItemCollection de um ListView controle está selecionado. Com classes de coleção de seleção, há também duas classes que permitem que você determinar quais itens estão marcados (quando o CheckBoxes propriedade da ListView controle estiver definida como true) dentro dessa coleção.

Há várias maneiras de adicionar itens à coleção. O Add método adiciona um único item à coleção. Para adicionar um número de itens à coleção, você pode criar uma matriz dos itens e passá-lo para o AddRange método. Se você quiser inserir um item em um local específico na coleção, você pode usar o Insert método. Para remover itens, você pode usar o Remove método ou a RemoveAt método se você souber onde o item está localizado na coleção. O Clear método permite que você remover todos os itens da coleção em vez de usar o Remove método para remover um único item de cada vez.

Além de métodos e propriedades para adicionar e remover itens, para o ListView.ListViewItemCollection também fornece métodos para localizar itens na coleção. O Contains método permite que você determinar se um item é um membro da coleção. Você sabe que o item está localizado na coleção, você pode usar o IndexOf método para determinar onde o item está localizado na coleção.

O exemplo de código a seguir demonstra como adicionar itens a uma ListView.ListViewItemCollection. Observe que o Items propriedade do ListView1 é do tipo ListView.ListViewItemCollection. Para executar esse exemplo, cole o código a seguir em um formulário que contém um ListView objeto chamado ListView1 e um TextBox chamado TextBox1. Chamar o InitializeListView método do construtor do formulário ou Load manipulador de eventos.


	// This method adds two columns to the ListView, setting the Text 
	// and TextAlign, and Width properties of each ColumnHeader.  The 
	// HeaderStyle property is set to NonClickable since the ColumnClick 
	// event is not handled.  Finally the method adds ListViewItems and 
	// SubItems to each column.
	private void InitializeListView()
	{
		this.ListView1 = new System.Windows.Forms.ListView();
		this.ListView1.BackColor = System.Drawing.SystemColors.Control;
		this.ListView1.Dock = System.Windows.Forms.DockStyle.Top;
		this.ListView1.Location = new System.Drawing.Point(0, 0);
		this.ListView1.Name = "ListView1";
		this.ListView1.Size = new System.Drawing.Size(292, 130);
		this.ListView1.TabIndex = 0;
		this.ListView1.View = System.Windows.Forms.View.Details;
		this.ListView1.MultiSelect = true;
		this.ListView1.HideSelection = false;
		this.ListView1.HeaderStyle = ColumnHeaderStyle.Nonclickable;
		
		ColumnHeader columnHeader1 = new ColumnHeader();
		columnHeader1.Text = "Breakfast Item";
		columnHeader1.TextAlign = HorizontalAlignment.Left;
		columnHeader1.Width = 146;

	 	ColumnHeader columnHeader2 = new ColumnHeader();
		columnHeader2.Text = "Price Each";
		columnHeader2.TextAlign = HorizontalAlignment.Center;
		columnHeader2.Width = 142;

		this.ListView1.Columns.Add(columnHeader1);
		this.ListView1.Columns.Add(columnHeader2);

		string[] foodList = new string[]{"Juice", "Coffee", 
			"Cereal & Milk", "Fruit Plate", "Toast & Jelly", 
			"Bagel & Cream Cheese"};
		string[] foodPrice = new string[]{"1.09", "1.09", "2.19", 
			"2.49", "1.49", "1.49"};
		
		for(int count=0; count < foodList.Length; count++)
		{
			ListViewItem listItem = new ListViewItem(foodList[count]);
			listItem.SubItems.Add(foodPrice[count]);
			ListView1.Items.Add(listItem);
		}
		this.Controls.Add(ListView1);
	}
	


.NET Framework

Com suporte em: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Com suporte em: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos do sistema do .NET Framework.
Qualquer estático (Shared no Visual Basic) membro público desse tipo é thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.
Isso foi útil para você?
(1500 caracteres restantes)
Agradecemos os seus comentários

Contribuições da comunidade

ADICIONAR
A Microsoft está realizando uma pesquisa online para saber sua opinião sobre o site do MSDN. Se você optar por participar, a pesquisa online lhe será apresentada quando você sair do site do MSDN.

Deseja participar?
Mostrar:
© 2014 Microsoft. Todos os direitos reservados.