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 ListViewItem

Representa um item em um ListView controle.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (em System.Windows.Forms.dll)
[SerializableAttribute]
[TypeConverterAttribute(typeof(ListViewItemConverter))]
public class ListViewItem : ICloneable, 
	ISerializable

The ListView controle é semelhante a um ListBox no que ele exibe uma lista de itens. A principal diferença é que o ListView o controle fornece que um número de itens de maneiras diferentes pode ser exibido por usuário. The ListViewItem classe define a aparência, comportamento e dados associados a um item é exibido na ListView controle. ListViewItem objetos podem ser exibidos na ListView controle em um dos quatro diferentes modos de exibição. Itens podem ser exibidos sistema autônomo ícones grandes ou pequenos ou sistema autônomo ícones pequenos em uma lista vertical. Itens também podem ter subitens que contêm informações relacionadas ao item pai. O quarto estilo de exibição, visualização de detalhes, permite que você para exibir o item e seus subitens em uma grade com cabeçalhos de colunas que podem ser usados para identificar as informações sejam exibidas em um subitem.

Maioria das propriedades do ListViewItem classe fornecem maneiras de alterar a exibição do item a ListView controle que está associado. The BackColor, ForeColor, e Font propriedades permitem que você altere como o texto do item é exibido na ListView controle. The ImageIndex propriedade permite que você especifique a imagem para carregar a partir do ImageList que está atribuído a ListView controle (definindo a LargeImageList ou SmallImageList propriedades das ListView). Itens podem exibir caixas de seleção para obter opções de item do usuário de maneira semelhante a um CheckedListBox controle. Você pode usar o Checked propriedade para determinar se um item está marcado, ou para marcar ou desmarcar a caixa de seleção em time de execução. Itens podem exibir qualquer número de subitems quando o View propriedade do associado ListView o controle é conjunto para Details e colunas estão definidas no ListView.ColumnHeaderCollection da ListView controle. Você pode adicionar subitens a um item chamando o Add método para o ListViewItem.ListViewSubItemCollection classe. The SubItems propriedade permite que você acessar o ListViewItem.ListViewSubItemCollection classe e seus membros.

Algumas das propriedades e métodos do ListViewItem classe são versões específicas de itens de propriedades e métodos na ListView controle. Por exemplo, a EnsureVisible método é semelhante do ListView versão do método, mas o ListViewItem versão afeta somente o item corrente.

The ListViewItem classe também fornece métodos que não são as versões do ListView métodos. The BeginEdit método coloca o texto do item no modo de edição para que o usuário possa alterar o texto do item (quando o LabelEdit propriedade das ListView controle estiver definida como true). The Clone método lhe permite criar cópias de existente ListViewItem objetos para reutilização em outros ListView controles.

O exemplo de código a seguir cria um ListView controlar com três ListViewItem objetos especificados e três ListViewItem.ListViewSubItem objetos especificados para cada item. O exemplo também cria ColumnHeader objetos para exibir os subitens no modo de exibição de detalhes. Two ImageList objetos também são criados no exemplo de código para fornecer imagens para o ListViewItem objetos. Esses ImageList os objetos são adicionados para o LargeImageList e SmallImageList Propriedades. O exemplo utiliza as seguintes propriedades na criação de ListView controle:

Você precisa adicionar o código para um Form e chame o método criado no exemplo de construtor ou outro método no formulário. O exemplo requer que imagens nomeada MySmallImage1, MySmallImage2, MyLargeImage1, e MyLargeImage2 localizado no diretório raiz da unidade C.

privatevoid CreateMyListView()
		{
			// Create a new ListView control.
			ListView listView1 = new ListView();
			listView1.Bounds = new Rectangle(new Point(10,10), new Size(300,200));

			// Set the view to show details.
			listView1.View = View.Details;
			// Allow the user to edit item text.
			listView1.LabelEdit = true;
			// Allow the user to rearrange columns.
			listView1.AllowColumnReorder = true;
			// Display check boxes.
			listView1.CheckBoxes = true;
			// Select the item and subitems when selection is made.
			listView1.FullRowSelect = true;
			// Display grid lines.
			listView1.GridLines = true;
			// Sort the items in the list in ascending order.
			listView1.Sorting = SortOrder.Ascending;
            			
			// Create three items and three sets of subitems for each item.
			ListViewItem item1 = new ListViewItem("item1",0);
			// Place a check mark next to the item.
			item1.Checked = true;
			item1.SubItems.Add("1");
			item1.SubItems.Add("2");
			item1.SubItems.Add("3");
			ListViewItem item2 = new ListViewItem("item2",1);
			item2.SubItems.Add("4");
			item2.SubItems.Add("5");
			item2.SubItems.Add("6");
			ListViewItem item3 = new ListViewItem("item3",0);
			// Place a check mark next to the item.
			item3.Checked = true;
			item3.SubItems.Add("7");
			item3.SubItems.Add("8");
			item3.SubItems.Add("9");

			// Create columns for the items and subitems.
			listView1.Columns.Add("Item Column", -2, HorizontalAlignment.Left);
			listView1.Columns.Add("Column 2", -2, HorizontalAlignment.Left);
			listView1.Columns.Add("Column 3", -2, HorizontalAlignment.Left);
			listView1.Columns.Add("Column 4", -2, HorizontalAlignment.Center);

			//Add the items to the ListView.
            		listView1.Items.AddRange(new ListViewItem[]{item1,item2,item3});

			// Create two ImageList objects.
			ImageList imageListSmall = new ImageList();
			ImageList imageListLarge = new ImageList();

			// Initialize the ImageList objects with bitmaps.
			imageListSmall.Images.Add(Bitmap.FromFile("C:\\MySmallImage1.bmp"));
			imageListSmall.Images.Add(Bitmap.FromFile("C:\\MySmallImage2.bmp"));
			imageListLarge.Images.Add(Bitmap.FromFile("C:\\MyLargeImage1.bmp"));
			imageListLarge.Images.Add(Bitmap.FromFile("C:\\MyLargeImage2.bmp"));

			//Assign the ImageList objects to the ListView.
			listView1.LargeImageList = imageListLarge;
			listView1.SmallImageList = imageListSmall;

			// Add the ListView to the control collection.this.Controls.Add(listView1);
		}


private void CreateMyListView()
{
    // Create a new ListView control.
    ListView listView1 = new ListView();
    listView1.set_Bounds(new Rectangle(new Point(10, 10), 
        new Size(300, 200)));

    // Set the view to show details.
    listView1.set_View(View.Details);

    // Allow the user to edit item text.
    listView1.set_LabelEdit(true);

    // Allow the user to rearrange columns.
    listView1.set_AllowColumnReorder(true);

    // Display check boxes.
    listView1.set_CheckBoxes(true);

    // Select the item and subitems when selection is made.
    listView1.set_FullRowSelect(true);

    // Display grid lines.
    listView1.set_GridLines(true);

    // Sort the items in the list in ascending order.
    listView1.set_Sorting(SortOrder.Ascending);

    // Create three items and three sets of subitems for each item.
    ListViewItem item1 = new ListViewItem("item1", 0);

    // Place a check mark next to the item.
    item1.set_Checked(true);

    item1.get_SubItems().Add("1");
    item1.get_SubItems().Add("2");
    item1.get_SubItems().Add("3");

    ListViewItem item2 = new ListViewItem("item2", 1);
    item2.get_SubItems().Add("4");
    item2.get_SubItems().Add("5");
    item2.get_SubItems().Add("6");

    ListViewItem item3 = new ListViewItem("item3", 0);

    // Place a check mark next to the item.
    item3.set_Checked(true);

    item3.get_SubItems().Add("7");
    item3.get_SubItems().Add("8");
    item3.get_SubItems().Add("9");

    // Create columns for the items and subitems.
    listView1.get_Columns().Add("Item Column", -2, 
        HorizontalAlignment.Left);
    listView1.get_Columns().Add("Column 2", -2, HorizontalAlignment.Left);
    listView1.get_Columns().Add("Column 3", -2, HorizontalAlignment.Left);
    listView1.get_Columns().Add("Column 4", -2, HorizontalAlignment.Center);

    //Add the items to the ListView.
    listView1.get_Items().AddRange(new ListViewItem[] { item1, item2, 
        item3 });

    // Create two ImageList objects.
    ImageList imageListSmall = new ImageList();
    ImageList imageListLarge = new ImageList();

    // Initialize the ImageList objects with bitmaps.
    imageListSmall.get_Images().Add(Bitmap.FromFile(
        "C:\\MySmallImage1.bmp"));
    imageListSmall.get_Images().Add(Bitmap.FromFile(
        "C:\\MySmallImage2.bmp"));
    imageListLarge.get_Images().Add(Bitmap.FromFile(
        "C:\\MyLargeImage1.bmp"));
    imageListLarge.get_Images().Add(Bitmap.FromFile(
        "C:\\MyLargeImage2.bmp"));

    //Assign the ImageList objects to the ListView.
    listView1.set_LargeImageList(imageListLarge);
    listView1.set_SmallImageList(imageListSmall);

    // Add the ListView to the control collection.
    this.get_Controls().Add(listView1);
} //CreateMyListView


System.Object
  System.Windows.Forms.ListViewItem
Quaisquer membros static (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC

o.NET Framework e.NET Compact Framework não oferecem suporte a todas as versões de cada plataforma. Para obter uma lista de versões suportadas, consulte Requisitos de sistema do .NET framework.

.NET Framework

Compatível com: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Compatível com: 3.5, 2.0, 1.0
Isso foi útil para você?
(1500 caracteres restantes)
Conteúdo da Comunidade Adicionar