Compartilhar via


ListViewItem Classe

Definição

Representa um item em um controle ListView.

public ref class ListViewItem : ICloneable, System::Runtime::Serialization::ISerializable
[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ListViewItemConverter))]
[System.Serializable]
public class ListViewItem : ICloneable, System.Runtime.Serialization.ISerializable
[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ListViewItemConverter))>]
[<System.Serializable>]
type ListViewItem = class
    interface ICloneable
    interface ISerializable
Public Class ListViewItem
Implements ICloneable, ISerializable
Herança
ListViewItem
Atributos
Implementações

Exemplos

O exemplo de código a seguir cria um ListView controle 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 subitems na exibição de detalhes. Dois ImageList objetos também são criados no exemplo de código para fornecer imagens para os ListViewItem objetos. Esses ImageList objetos são adicionados às LargeImageList propriedades e SmallImageList . O exemplo usa as seguintes propriedades na criação do ListView controle :

Você precisa adicionar o código a um Form e chamar o método criado no exemplo do construtor ou outro método no formulário. O exemplo requer que as imagens chamadas MySmallImage1, MySmallImage2, MyLargeImage1e MyLargeImage2 estejam localizadas no diretório raiz da unidade C.

private:
   void CreateMyListView()
   {
      // Create a new ListView control.
      ListView^ listView1 = gcnew ListView;
      listView1->Bounds = Rectangle(Point(10,10),System::Drawing::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 = gcnew 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 = gcnew ListViewItem( "item2",1 );
      item2->SubItems->Add( "4" );
      item2->SubItems->Add( "5" );
      item2->SubItems->Add( "6" );
      ListViewItem^ item3 = gcnew 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.
      // Width of -2 indicates auto-size.
      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.
      array<ListViewItem^>^temp1 = {item1,item2,item3};
      listView1->Items->AddRange( temp1 );

      // Create two ImageList objects.
      ImageList^ imageListSmall = gcnew ImageList;
      ImageList^ imageListLarge = gcnew 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.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.
    // Width of -2 indicates auto-size.
    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 Sub CreateMyListView()
    ' Create a new ListView control.
    Dim listView1 As 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.
    Dim item1 As 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")
    Dim item2 As New ListViewItem("item2", 1)
    item2.SubItems.Add("4")
    item2.SubItems.Add("5")
    item2.SubItems.Add("6")
    Dim item3 As 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.
    ' Width of -2 indicates auto-size.
    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.
    Dim imageListSmall As New ImageList()
    Dim imageListLarge As 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.
    Me.Controls.Add(listView1)
End Sub

Comentários

O ListView controle é semelhante a um ListBox em que exibe uma lista de itens. A principal diferença é que o ListView controle fornece várias maneiras diferentes pelas quais os itens podem ser exibidos pelo usuário. A ListViewItem classe define a aparência, o comportamento e os dados associados a um item exibido no ListView controle . ListViewItem objetos podem ser exibidos no ListView controle em uma das quatro exibições diferentes. Os itens podem ser exibidos como ícones grandes ou pequenos ou como ícones pequenos em uma lista vertical. Os itens também podem ter subitens que contêm informações relacionadas ao item pai. O quarto estilo de exibição, exibição de detalhes, permite exibir o item e seus subitens em uma grade com cabeçalhos de coluna que podem ser usados para identificar as informações que estão sendo exibidas em um subitem.

A maioria das propriedades da ListViewItem classe fornece maneiras de alterar a exibição do item no ListView controle ao qual ele está associado. As BackColorpropriedades , ForeColore Font permitem que você altere como o texto do item é exibido no ListView controle . A ImageIndex propriedade permite que você especifique a imagem a ser carregada do ImageList atribuído ao ListView controle (definindo as LargeImageList propriedades ou SmallImageList do ListView). Os 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 a Checked propriedade para determinar se um item está marcado ou para marcar ou desmarcar a caixa de seleção em tempo de execução. Os itens podem exibir qualquer número de subitens quando a View propriedade do controle associado ListView é definida Details como e as colunas são definidas no ListView.ColumnHeaderCollection do ListView controle . Você pode adicionar subitens a um item chamando o Add método da ListViewItem.ListViewSubItemCollection classe . A SubItems propriedade permite que você obtenha acesso à ListViewItem.ListViewSubItemCollection classe e seus membros.

Algumas das propriedades e métodos da ListViewItem classe são versões específicas do item de propriedades e métodos no ListView controle . Por exemplo, o EnsureVisible método é semelhante à ListView versão do método , mas a ListViewItem versão afeta apenas o item atual.

A ListViewItem classe também fornece métodos que não são versões de ListView métodos. O 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 a LabelEdit propriedade do ListView controle for definida truecomo ). O Clone método permite que você crie cópias de objetos existentes ListViewItem para reutilizar em outros ListView controles.

Construtores

ListViewItem()

Inicializa uma nova instância da classe ListViewItem com valores padrão.

ListViewItem(ListViewGroup)

Inicializa uma nova instância da classe ListViewItem e a atribui ao grupo especificado.

ListViewItem(ListViewItem+ListViewSubItem[], Int32)

Inicializa uma nova instância da classe ListViewItem com a posição de índice da imagem do ícone do item e uma matriz de objetos ListViewItem.ListViewSubItem.

ListViewItem(ListViewItem+ListViewSubItem[], Int32, ListViewGroup)

Inicializa uma nova instância da classe ListViewItem com a posição de índice da imagem do ícone do item e uma matriz de objetos ListViewItem.ListViewSubItem, além de atribuir o item ao grupo especificado.

ListViewItem(ListViewItem+ListViewSubItem[], String)

Inicializa uma nova instância da classe ListViewItem com os subitens e a imagem especificados.

ListViewItem(ListViewItem+ListViewSubItem[], String, ListViewGroup)

Inicializa uma nova instância da classe ListViewItem com os subitens, a imagem e o grupo especificados.

ListViewItem(SerializationInfo, StreamingContext)

Inicializa uma nova instância da classe ListViewItem com as informações de serialização e contexto de fluxo.

ListViewItem(String)

Inicializa uma nova instância da classe ListViewItem com o item de texto especificado.

ListViewItem(String, Int32)

Inicializa uma nova instância da classe ListViewItem com o texto do item especificado e a posição de índice da imagem do ícone do item.

ListViewItem(String, Int32, ListViewGroup)

Inicializa uma nova instância da classe ListViewItem com o texto do item especificado e a posição de índice da imagem do ícone do item, além de atribuir o item ao grupo especificado.

ListViewItem(String, ListViewGroup)

Inicializa uma nova instância da classe ListViewItem com o texto do item especificado e a atribui ao grupo especificado.

ListViewItem(String, String)

Inicializa uma nova instância da classe ListViewItem com o texto e a imagem especificados.

ListViewItem(String, String, ListViewGroup)

Inicializa uma nova instância da classe ListViewItem com o texto, a imagem e o grupo especificados.

ListViewItem(String[])

Inicializa uma nova instância da classe ListViewItem com uma matriz de cadeias de caracteres que representam os subitens.

ListViewItem(String[], Int32)

Inicializa uma nova instância da classe ListViewItem com a posição de índice da imagem do ícone do item e uma matriz de objetos representando subitens.

ListViewItem(String[], Int32, Color, Color, Font)

Inicializa uma nova instância da classe ListViewItem com a posição do índice de imagem do ícone do item; a cor de primeiro plano, cor da tela de fundo e fonte do item; e uma matriz de cadeias de caracteres representando os subitens.

ListViewItem(String[], Int32, Color, Color, Font, ListViewGroup)

Inicializa uma nova instância da classe ListViewItem com a posição do índice de imagem do ícone do item; a cor de primeiro plano, cor da tela de fundo e fonte do item; e uma matriz de cadeias de caracteres representando os subitens. Atribui o item ao grupo especificado.

ListViewItem(String[], Int32, ListViewGroup)

Inicializa uma nova instância da classe ListViewItem com a posição de índice da imagem do ícone do item e uma matriz de objetos representando subitens, além de atribuir o item ao grupo especificado.

ListViewItem(String[], ListViewGroup)

Inicializa uma nova instância da classe ListViewItem com uma matriz de cadeias de caracteres que representam os subitens, além de atribuir o item ao grupo especificado.

ListViewItem(String[], String)

Inicializa uma nova instância da classe ListViewItem com o item especificado e o texto e a imagem do subitem.

ListViewItem(String[], String, Color, Color, Font)

Inicializa uma nova instância da classe ListViewItem com os subitens contendo o texto, a imagem, as cores e a fonte especificados.

ListViewItem(String[], String, Color, Color, Font, ListViewGroup)

Inicializa uma nova instância da classe ListViewItem com os subitens contendo o texto, a imagem, as cores, a fonte e o grupo especificados.

ListViewItem(String[], String, ListViewGroup)

Inicializa uma nova instância da classe ListViewItem com subitens contendo o texto, a imagem e o grupo especificados.

Propriedades

BackColor

Obtém ou define a cor da tela de fundo do texto do item.

Bounds

Obtém o retângulo delimitador do item, incluindo subitens.

Checked

Obtém ou define um valor que indica se o item está selecionado.

Focused

Obtém ou define um valor que indica se o item tem o foco dentro do controle ListView.

Font

Obtém ou define a fonte do texto exibido pelo item.

ForeColor

Obtém ou define a cor de primeiro plano do texto do item.

Group

Obtém ou define o grupo ao qual o item está atribuído.

ImageIndex

Obtém ou define o índice da imagem que é exibido para o item.

ImageKey

Obtém ou define a chave para a imagem que é exibida para o item.

ImageList

Obtém a ImageList que contém a imagem exibida com o item.

IndentCount

Obtém ou define o número de pequenas larguras de imagem segundo as quais recuar o ListViewItem.

Index

Obtém o índice baseado em zero do item no controle ListView.

ListView

Obtém o controle ListView que contém o item.

Name

Obtém ou define o nome associado a este ListViewItem.

Position

Obtém ou define a posição do canto superior esquerdo do ListViewItem.

Selected

Obtém ou define um valor que indica se o item está selecionado.

StateImageIndex

Obtém ou define o índice da imagem do estado (uma imagem como uma caixa de seleção marcada ou desmarcada que indica o estado do item) que é exibido para o item.

SubItems

Obtém uma coleção que contém todos os subitens do item.

Tag

Obtém ou define um objeto que contém dados a serem associados ao item.

Text

Obtém ou define o texto do item.

ToolTipText

Obtém ou define o texto exibido quando o ponteiro do mouse fica sobre o ListViewItem.

UseItemStyleForSubItems

Obtém ou define um valor que indica se as propriedades Font, ForeColor e BackColor do item são usadas para todos os seus subitens.

Métodos

BeginEdit()

Coloca o texto do item no modo de edição.

Clone()

Cria uma cópia idêntica do item.

Deserialize(SerializationInfo, StreamingContext)

Desserializa o item.

EnsureVisible()

Garante que o item esteja visível no controle, rolando o conteúdo do controle, se necessário.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
FindNearestItem(SearchDirectionHint)

Localiza o próximo item partindo do ListViewItem, pesquisando na direção especificada.

GetBounds(ItemBoundsPortion)

Recupera a parte especificada do retângulo delimitador do item.

GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetSubItemAt(Int32, Int32)

Retorna o subitem do ListViewItem em coordenadas especificadas.

GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
Remove()

Remove o item de seu controle ListView associado.

Serialize(SerializationInfo, StreamingContext)

Serializa o item.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

Implantações explícitas de interface

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Serializa o item.

Aplica-se a

Confira também