Partilhar via


ListViewItem Construtores

Definição

Inicializa uma nova instância da classe ListViewItem.

Sobrecargas

ListViewItem()

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

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[], 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[], 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[], 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(ListViewItem+ListViewSubItem[], String, ListViewGroup)

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

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(String[], String, ListViewGroup)

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

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, String, ListViewGroup)

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

ListViewItem(ListViewItem+ListViewSubItem[], String)

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

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 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[], 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, 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, 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(SerializationInfo, StreamingContext)

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

ListViewItem(ListViewGroup)

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

ListViewItem(String[])

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

ListViewItem(String)

Inicializa uma nova instância da classe ListViewItem com o item de texto 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()

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

public:
 ListViewItem();
public ListViewItem ();
Public Sub New ()

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 de 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

Aplica-se a

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.

public:
 ListViewItem(cli::array <System::String ^> ^ items, System::String ^ imageKey, System::Drawing::Color foreColor, System::Drawing::Color backColor, System::Drawing::Font ^ font, System::Windows::Forms::ListViewGroup ^ group);
public ListViewItem (string[] items, string imageKey, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Drawing.Font font, System.Windows.Forms.ListViewGroup group);
public ListViewItem (string[]? items, string? imageKey, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Drawing.Font? font, System.Windows.Forms.ListViewGroup? group);
new System.Windows.Forms.ListViewItem : string[] * string * System.Drawing.Color * System.Drawing.Color * System.Drawing.Font * System.Windows.Forms.ListViewGroup -> System.Windows.Forms.ListViewItem
Public Sub New (items As String(), imageKey As String, foreColor As Color, backColor As Color, font As Font, group As ListViewGroup)

Parâmetros

items
String[]

Uma matriz de cadeias de caracteres que representa o texto dos subitens do ListViewItem.

imageKey
String

O nome da imagem dentro do ImageList do ListView proprietário a ser exibido no item.

foreColor
Color

Um Color que representa a cor de primeiro plano do item.

backColor
Color

Um Color que representa a cor da tela de fundo do item.

font
Font

Um Font a ser aplicado ao texto do item.

group
ListViewGroup

O ListViewGroup ao qual atribuir o item.

Comentários

Esta versão do construtor permite que você especifique o grupo ao qual pertence um item.

O imageKey parâmetro especifica uma imagem no ImageList associado ao controle proprietário ListView , que pode ser acessado com a ImageList propriedade .

Observação

ListView os grupos só estão disponíveis no Windows XP e na família Windows Server 2003 (Windows XP Home Edition, Windows XP Professional, Windows Server 2003). Para obter mais informações, consulte o tópico de visão geral ListViewGroup.

Aplica-se a

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.

public:
 ListViewItem(cli::array <System::String ^> ^ items, int imageIndex, System::Drawing::Color foreColor, System::Drawing::Color backColor, System::Drawing::Font ^ font, System::Windows::Forms::ListViewGroup ^ group);
public ListViewItem (string[] items, int imageIndex, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Drawing.Font font, System.Windows.Forms.ListViewGroup group);
public ListViewItem (string[]? items, int imageIndex, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Drawing.Font? font, System.Windows.Forms.ListViewGroup? group);
new System.Windows.Forms.ListViewItem : string[] * int * System.Drawing.Color * System.Drawing.Color * System.Drawing.Font * System.Windows.Forms.ListViewGroup -> System.Windows.Forms.ListViewItem
Public Sub New (items As String(), imageIndex As Integer, foreColor As Color, backColor As Color, font As Font, group As ListViewGroup)

Parâmetros

items
String[]

Uma matriz de cadeias de caracteres que representa os subitens do novo item.

imageIndex
Int32

O índice baseado em zero da imagem dentro do ImageList associado ao ListView que contém o item.

foreColor
Color

Um Color que representa a cor de primeiro plano do item.

backColor
Color

Um Color que representa a cor da tela de fundo do item.

font
Font

Um Font que representa a fonte para exibir o texto do item.

group
ListViewGroup

O ListViewGroup ao qual atribuir o item.

Comentários

Esta versão do construtor permite que você especifique o grupo ao qual pertence um item.

Observação

ListView os grupos só estão disponíveis no Windows XP e na família Windows Server 2003 (Windows XP Home Edition, Windows XP Professional, Windows Server 2003). Para obter mais informações, consulte o tópico de visão geral ListViewGroup.

Confira também

Aplica-se a

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.

public:
 ListViewItem(cli::array <System::String ^> ^ items, System::String ^ imageKey, System::Drawing::Color foreColor, System::Drawing::Color backColor, System::Drawing::Font ^ font);
public ListViewItem (string[] items, string imageKey, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Drawing.Font font);
public ListViewItem (string[]? items, string? imageKey, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Drawing.Font? font);
new System.Windows.Forms.ListViewItem : string[] * string * System.Drawing.Color * System.Drawing.Color * System.Drawing.Font -> System.Windows.Forms.ListViewItem
Public Sub New (items As String(), imageKey As String, foreColor As Color, backColor As Color, font As Font)

Parâmetros

items
String[]

Uma matriz de cadeias de caracteres que representam o texto dos subitens do ListViewItem.

imageKey
String

O nome da imagem dentro do ImageList do ListView proprietário a ser exibido no item.

foreColor
Color

Um Color que representa a cor de primeiro plano do item.

backColor
Color

Um Color que representa a cor da tela de fundo do item.

font
Font

Um Font a ser aplicado ao texto do item.

Comentários

O imageKey parâmetro especifica uma imagem no ImageList associado ao controle proprietário ListView , que pode ser acessado com a ImageList propriedade .

Aplica-se a

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.

public:
 ListViewItem(cli::array <System::String ^> ^ items, int imageIndex, System::Drawing::Color foreColor, System::Drawing::Color backColor, System::Drawing::Font ^ font);
public ListViewItem (string[] items, int imageIndex, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Drawing.Font font);
public ListViewItem (string[]? items, int imageIndex, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Drawing.Font? font);
new System.Windows.Forms.ListViewItem : string[] * int * System.Drawing.Color * System.Drawing.Color * System.Drawing.Font -> System.Windows.Forms.ListViewItem
Public Sub New (items As String(), imageIndex As Integer, foreColor As Color, backColor As Color, font As Font)

Parâmetros

items
String[]

Uma matriz de cadeias de caracteres que representa os subitens do novo item.

imageIndex
Int32

O índice baseado em zero da imagem dentro do ImageList associado ao ListView que contém o item.

foreColor
Color

Um Color que representa a cor de primeiro plano do item.

backColor
Color

Um Color que representa a cor da tela de fundo do item.

font
Font

Um Font que representa a fonte para exibir o texto do item.

Exemplos

O exemplo de código a seguir cria um formulário que contém um ListView controle que classifica manualmente os itens quando uma coluna no ListView controle é clicada. O exemplo define uma classe chamada ListViewItemComparer que implementa a System.Collections.IComparer interface que executa a ListViewItem comparação. O exemplo cria uma instância de ListViewItemComparer e a usa para definir a ListViewItemSorter propriedade do ListView controle. A Sort chamada de método no ColumnClick manipulador de eventos usa os métodos definidos em ListViewItemComparer para executar o tipo de itens, com base na coluna clicada.

#using <System.dll>
#using <System.Drawing.dll>
#using <System.Windows.Forms.dll>

using namespace System;
using namespace System::Windows::Forms;
using namespace System::Drawing;
using namespace System::Collections;

// Implements the manual sorting of items by columns.
ref class ListViewItemComparer: public IComparer
{
private:
   int col;

public:
   ListViewItemComparer()
   {
      col = 0;
   }

   ListViewItemComparer( int column )
   {
      col = column;
   }

   virtual int Compare( Object^ x, Object^ y )
   {
      return String::Compare( (dynamic_cast<ListViewItem^>(x))->SubItems[ col ]->Text,
                              (dynamic_cast<ListViewItem^>(y))->SubItems[ col ]->Text );
   }
};

public ref class ListViewSortForm: public Form
{
private:
   ListView^ listView1;

public:
   ListViewSortForm()
   {
      // Create ListView items to add to the control.
      array<String^>^temp0 = {"Banana","a","b","c"};
      ListViewItem^ listViewItem1 = gcnew ListViewItem( temp0,-1,Color::Empty,Color::Yellow,nullptr );
      array<String^>^temp1 = {"Cherry","v","g","t"};
      ListViewItem^ listViewItem2 = gcnew ListViewItem( temp1,-1,Color::Empty,Color::Red,
                 gcnew System::Drawing::Font( "Microsoft Sans Serif",8.25F,FontStyle::Regular,GraphicsUnit::Point,0 ) );
      array<String^>^temp2 = {"Apple","h","j","n"};
      ListViewItem^ listViewItem3 = gcnew ListViewItem( temp2,-1,Color::Empty,Color::Lime,nullptr );
      array<String^>^temp3 = {"Pear","y","u","i"};
      ListViewItem^ listViewItem4 = gcnew ListViewItem( temp3,-1,Color::Empty,Color::FromArgb( 192, 128, 156 ),nullptr );

      //Initialize the ListView control and add columns to it.
      this->listView1 = gcnew ListView;

      // Set the initial sorting type for the ListView.
      this->listView1->Sorting = SortOrder::None;

      // Disable automatic sorting to enable manual sorting.
      this->listView1->View = View::Details;

      // Add columns and set their text.
      this->listView1->Columns->Add( gcnew ColumnHeader );
      this->listView1->Columns[ 0 ]->Text = "Column 1";
      this->listView1->Columns[ 0 ]->Width = 100;
      listView1->Columns->Add( gcnew ColumnHeader );
      listView1->Columns[ 1 ]->Text = "Column 2";
      listView1->Columns->Add( gcnew ColumnHeader );
      listView1->Columns[ 2 ]->Text = "Column 3";
      listView1->Columns->Add( gcnew ColumnHeader );
      listView1->Columns[ 3 ]->Text = "Column 4";

      // Suspend control logic until form is done configuring form.
      this->SuspendLayout();

      // Add Items to the ListView control.
      array<ListViewItem^>^temp4 = {listViewItem1,listViewItem2,listViewItem3,listViewItem4};
      this->listView1->Items->AddRange( temp4 );

      // Set the location and size of the ListView control.
      this->listView1->Location = Point(10,10);
      this->listView1->Name = "listView1";
      this->listView1->Size = System::Drawing::Size( 300, 100 );
      this->listView1->TabIndex = 0;

      // Enable editing of the items in the ListView.
      this->listView1->LabelEdit = true;

      // Connect the ListView::ColumnClick event to the ColumnClick event handler.
      this->listView1->ColumnClick += gcnew ColumnClickEventHandler( this, &ListViewSortForm::ColumnClick );

      // Initialize the form.
      this->ClientSize = System::Drawing::Size( 400, 400 );
      array<Control^>^temp5 = {this->listView1};
      this->Controls->AddRange( temp5 );
      this->Name = "ListViewSortForm";
      this->Text = "Sorted ListView Control";

      // Resume lay[Out] of* the form.
      this->ResumeLayout( false );
   }

private:

   // ColumnClick event handler.
   void ColumnClick( Object^ /*o*/, ColumnClickEventArgs^ e )
   {
      // Set the ListViewItemSorter property to a new ListViewItemComparer 
      // object. Setting this property immediately sorts the 
      // ListView using the ListViewItemComparer object.
      this->listView1->ListViewItemSorter = gcnew ListViewItemComparer( e->Column );
   }
};

[System::STAThreadAttribute]
int main()
{
   Application::Run( gcnew ListViewSortForm );
}
using System;
using System.Windows.Forms;
using System.Drawing;
using System.Collections;

namespace ListViewSortFormNamespace
{

    public class ListViewSortForm : Form
    {
        private ListView listView1;
       
        public ListViewSortForm()
        {
            // Create ListView items to add to the control.
            ListViewItem listViewItem1 = new ListViewItem(new string[] {"Banana","a","b","c"}, -1, Color.Empty, Color.Yellow, null);
            ListViewItem listViewItem2 = new ListViewItem(new string[] {"Cherry","v","g","t"}, -1, Color.Empty, Color.Red, new Font("Microsoft Sans Serif", 8.25F, FontStyle.Regular, GraphicsUnit.Point, ((System.Byte)(0))));
            ListViewItem listViewItem3 = new ListViewItem(new string[] {"Apple","h","j","n"}, -1, Color.Empty, Color.Lime, null);
            ListViewItem listViewItem4 = new ListViewItem(new string[] {"Pear","y","u","i"}, -1, Color.Empty, Color.FromArgb(((System.Byte)(192)), ((System.Byte)(128)), ((System.Byte)(156))), null);
     
            //Initialize the ListView control and add columns to it.
            this.listView1 = new ListView();

            // Set the initial sorting type for the ListView.
            this.listView1.Sorting = SortOrder.None;
            // Disable automatic sorting to enable manual sorting.
            this.listView1.View = View.Details;
            // Add columns and set their text.
            this.listView1.Columns.Add(new ColumnHeader());
            this.listView1.Columns[0].Text = "Column 1";
            this.listView1.Columns[0].Width = 100;
            listView1.Columns.Add(new ColumnHeader());
            listView1.Columns[1].Text = "Column 2";
            listView1.Columns.Add(new ColumnHeader());
            listView1.Columns[2].Text = "Column 3";
            listView1.Columns.Add(new ColumnHeader());
            listView1.Columns[3].Text = "Column 4";
            // Suspend control logic until form is done configuring form.
            this.SuspendLayout();
            // Add Items to the ListView control.
            this.listView1.Items.AddRange(new ListViewItem[] {listViewItem1,
                listViewItem2,
                listViewItem3,
                listViewItem4});
            // Set the location and size of the ListView control.
            this.listView1.Location = new Point(10, 10);
            this.listView1.Name = "listView1";
            this.listView1.Size = new Size(300, 100);
            this.listView1.TabIndex = 0;
            // Enable editing of the items in the ListView.
            this.listView1.LabelEdit = true;
            // Connect the ListView.ColumnClick event to the ColumnClick event handler.
            this.listView1.ColumnClick += new ColumnClickEventHandler(ColumnClick);
            
            // Initialize the form.
            this.ClientSize = new Size(400, 400);
            this.Controls.AddRange(new Control[] {this.listView1});
            this.Name = "ListViewSortForm";
            this.Text = "Sorted ListView Control";
            // Resume layout of the form.
            this.ResumeLayout(false);
        }

        // ColumnClick event handler.
        private void ColumnClick(object o, ColumnClickEventArgs e)
        {
            // Set the ListViewItemSorter property to a new ListViewItemComparer 
            // object. Setting this property immediately sorts the 
            // ListView using the ListViewItemComparer object.
            this.listView1.ListViewItemSorter = new ListViewItemComparer(e.Column);
        }

        [System.STAThreadAttribute()]
        public static void Main()
        {
            Application.Run(new ListViewSortForm());
        }
    }

    // Implements the manual sorting of items by columns.
    class ListViewItemComparer : IComparer
    {
        private int col;
        public ListViewItemComparer()
        {
            col = 0;
        }
        public ListViewItemComparer(int column)
        {
            col = column;
        }
        public int Compare(object x, object y)
        {
            return String.Compare(((ListViewItem)x).SubItems[col].Text, ((ListViewItem)y).SubItems[col].Text);
        }
    }
}
Imports System.Windows.Forms
Imports System.Drawing
Imports System.Collections


Namespace ListViewSortFormNamespace

    Public Class ListViewSortForm
        Inherits Form

        Private listView1 As ListView

        Public Sub New()
            ' Create ListView items to add to the control.
            Dim listViewItem1 As New ListViewItem(New String() {"Banana", "a", "b", "c"}, -1, Color.Empty, Color.Yellow, Nothing)
            Dim listViewItem2 As New ListViewItem(New String() {"Cherry", "v", "g", "t"}, -1, Color.Empty, Color.Red, New Font("Microsoft Sans Serif", 8.25F, FontStyle.Regular, GraphicsUnit.Point, CType(0, System.Byte)))
            Dim listViewItem3 As New ListViewItem(New String() {"Apple", "h", "j", "n"}, -1, Color.Empty, Color.Lime, Nothing)
            Dim listViewItem4 As New ListViewItem(New String() {"Pear", "y", "u", "i"}, -1, Color.Empty, Color.FromArgb(CType(192, System.Byte), CType(128, System.Byte), CType(156, System.Byte)), Nothing)

            'Initialize the ListView control and add columns to it.
            Me.listView1 = New ListView

            ' Set the initial sorting type for the ListView.
            Me.listView1.Sorting = SortOrder.None
            ' Disable automatic sorting to enable manual sorting.
            Me.listView1.View = View.Details
            ' Add columns and set their text.
            Me.listView1.Columns.Add(New ColumnHeader)
            Me.listView1.Columns(0).Text = "Column 1"
            Me.listView1.Columns(0).Width = 100
            listView1.Columns.Add(New ColumnHeader)
            listView1.Columns(1).Text = "Column 2"
            listView1.Columns.Add(New ColumnHeader)
            listView1.Columns(2).Text = "Column 3"
            listView1.Columns.Add(New ColumnHeader)
            listView1.Columns(3).Text = "Column 4"
            ' Suspend control logic until form is done configuring form.
            Me.SuspendLayout()
            ' Add Items to the ListView control.
            Me.listView1.Items.AddRange(New ListViewItem() {listViewItem1, listViewItem2, listViewItem3, listViewItem4})
            ' Set the location and size of the ListView control.
            Me.listView1.Location = New Point(10, 10)
            Me.listView1.Name = "listView1"
            Me.listView1.Size = New Size(300, 100)
            Me.listView1.TabIndex = 0
            ' Enable editing of the items in the ListView.
            Me.listView1.LabelEdit = True
            ' Connect the ListView.ColumnClick event to the ColumnClick event handler.
            AddHandler Me.listView1.ColumnClick, AddressOf ColumnClick

            ' Initialize the form.
            Me.ClientSize = New Size(400, 400)
            Me.Controls.AddRange(New Control() {Me.listView1})
            Me.Name = "ListViewSortForm"
            Me.Text = "Sorted ListView Control"
            ' Resume layout of the form.
            Me.ResumeLayout(False)
        End Sub


        ' ColumnClick event handler.
        Private Sub ColumnClick(ByVal o As Object, ByVal e As ColumnClickEventArgs)
            ' Set the ListViewItemSorter property to a new ListViewItemComparer 
            ' object. Setting this property immediately sorts the 
            ' ListView using the ListViewItemComparer object.
            Me.listView1.ListViewItemSorter = New ListViewItemComparer(e.Column)
        End Sub

    End Class

    ' Implements the manual sorting of items by columns.
    Class ListViewItemComparer
        Implements IComparer

        Private col As Integer

        Public Sub New()
            col = 0
        End Sub

        Public Sub New(ByVal column As Integer)
            col = column
        End Sub

        Public Function Compare(ByVal x As Object, ByVal y As Object) As Integer _
           Implements IComparer.Compare
            Return [String].Compare(CType(x, ListViewItem).SubItems(col).Text, CType(y, ListViewItem).SubItems(col).Text)
        End Function
    End Class
End Namespace

Confira também

Aplica-se a

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

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

public:
 ListViewItem(cli::array <System::Windows::Forms::ListViewItem::ListViewSubItem ^> ^ subItems, System::String ^ imageKey, System::Windows::Forms::ListViewGroup ^ group);
public ListViewItem (System.Windows.Forms.ListViewItem.ListViewSubItem[] subItems, string imageKey, System.Windows.Forms.ListViewGroup group);
public ListViewItem (System.Windows.Forms.ListViewItem.ListViewSubItem[] subItems, string? imageKey, System.Windows.Forms.ListViewGroup? group);
new System.Windows.Forms.ListViewItem : System.Windows.Forms.ListViewItem.ListViewSubItem[] * string * System.Windows.Forms.ListViewGroup -> System.Windows.Forms.ListViewItem
Public Sub New (subItems As ListViewItem.ListViewSubItem(), imageKey As String, group As ListViewGroup)

Parâmetros

subItems
ListViewItem.ListViewSubItem[]

Uma matriz de objetos ListViewItem.ListViewSubItem que representam os subitens do ListViewItem.

imageKey
String

O nome da imagem dentro do ImageList do ListView proprietário a ser exibido no item.

group
ListViewGroup

O ListViewGroup ao qual atribuir o item.

Comentários

Essa versão do construtor é útil quando você cria objetos antes de adicioná-los ListViewItem.ListViewSubItem a um ListViewItem (por exemplo, para indicar formatação especial ou para usar os subitems em vários itens). Ele também permite que você especifique o grupo ao qual pertence um item.

O imageKey parâmetro especifica uma imagem no ImageList associado ao controle proprietário ListView , que pode ser acessado com a ImageList propriedade .

Observação

ListView os grupos só estão disponíveis no Windows XP e na família Windows Server 2003 (Windows XP Home Edition, Windows XP Professional, Windows Server 2003). Para obter mais informações, consulte o tópico de visão geral ListViewGroup.

Aplica-se a

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.

public:
 ListViewItem(cli::array <System::Windows::Forms::ListViewItem::ListViewSubItem ^> ^ subItems, int imageIndex, System::Windows::Forms::ListViewGroup ^ group);
public ListViewItem (System.Windows.Forms.ListViewItem.ListViewSubItem[] subItems, int imageIndex, System.Windows.Forms.ListViewGroup group);
public ListViewItem (System.Windows.Forms.ListViewItem.ListViewSubItem[] subItems, int imageIndex, System.Windows.Forms.ListViewGroup? group);
new System.Windows.Forms.ListViewItem : System.Windows.Forms.ListViewItem.ListViewSubItem[] * int * System.Windows.Forms.ListViewGroup -> System.Windows.Forms.ListViewItem
Public Sub New (subItems As ListViewItem.ListViewSubItem(), imageIndex As Integer, group As ListViewGroup)

Parâmetros

subItems
ListViewItem.ListViewSubItem[]

Uma matriz do tipo ListViewItem.ListViewSubItem que representa os subitens do item.

imageIndex
Int32

O índice baseado em zero da imagem dentro do ImageList associado ao ListView que contém o item.

group
ListViewGroup

O ListViewGroup ao qual atribuir o item.

Comentários

Essa versão do construtor é útil quando você cria objetos antes de adicioná-los ListViewItem.ListViewSubItem a um ListViewItem objeto (por exemplo, para indicar formatação especial ou usar os subitens em vários itens). Ele também permite que você especifique o grupo ao qual pertence um item.

Observação

ListView os grupos só estão disponíveis no Windows XP e na família Windows Server 2003 (Windows XP Home Edition, Windows XP Professional, Windows Server 2003). Para obter mais informações, consulte o tópico de visão geral ListViewGroup.

Confira também

Aplica-se a

ListViewItem(String[], String, ListViewGroup)

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

public:
 ListViewItem(cli::array <System::String ^> ^ items, System::String ^ imageKey, System::Windows::Forms::ListViewGroup ^ group);
public ListViewItem (string[] items, string imageKey, System.Windows.Forms.ListViewGroup group);
public ListViewItem (string[]? items, string? imageKey, System.Windows.Forms.ListViewGroup? group);
new System.Windows.Forms.ListViewItem : string[] * string * System.Windows.Forms.ListViewGroup -> System.Windows.Forms.ListViewItem
Public Sub New (items As String(), imageKey As String, group As ListViewGroup)

Parâmetros

items
String[]

Uma matriz de cadeias de caracteres que representa o texto para os subitens do ListViewItem.

imageKey
String

O nome da imagem dentro do ImageList do ListView proprietário a ser exibido no item.

group
ListViewGroup

O ListViewGroup ao qual atribuir o item.

Comentários

Essa versão do construtor permite que você especifique o grupo ao qual pertence um item.

O imageKey parâmetro especifica uma imagem no ImageList associado ao controle proprietário ListView , que pode ser acessado com a ImageList propriedade .

Observação

ListView os grupos só estão disponíveis no Windows XP e na família Windows Server 2003 (Windows XP Home Edition, Windows XP Professional, Windows Server 2003). Para obter mais informações, consulte o tópico de visão geral ListViewGroup.

Aplica-se a

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.

public:
 ListViewItem(cli::array <System::String ^> ^ items, int imageIndex, System::Windows::Forms::ListViewGroup ^ group);
public ListViewItem (string[] items, int imageIndex, System.Windows.Forms.ListViewGroup group);
public ListViewItem (string[]? items, int imageIndex, System.Windows.Forms.ListViewGroup? group);
new System.Windows.Forms.ListViewItem : string[] * int * System.Windows.Forms.ListViewGroup -> System.Windows.Forms.ListViewItem
Public Sub New (items As String(), imageIndex As Integer, group As ListViewGroup)

Parâmetros

items
String[]

Uma matriz de cadeias de caracteres que representa os subitens do novo item.

imageIndex
Int32

O índice baseado em zero da imagem dentro do ImageList associado ao ListView que contém o item.

group
ListViewGroup

O ListViewGroup ao qual atribuir o item.

Comentários

Essa versão do construtor permite que você especifique o grupo ao qual pertence um item.

Observação

ListView os grupos só estão disponíveis no Windows XP e na família Windows Server 2003 (Windows XP Home Edition, Windows XP Professional, Windows Server 2003). Para obter mais informações, consulte o tópico de visão geral ListViewGroup.

Confira também

Aplica-se a

ListViewItem(String, String, ListViewGroup)

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

public:
 ListViewItem(System::String ^ text, System::String ^ imageKey, System::Windows::Forms::ListViewGroup ^ group);
public ListViewItem (string text, string imageKey, System.Windows.Forms.ListViewGroup group);
public ListViewItem (string? text, string? imageKey, System.Windows.Forms.ListViewGroup? group);
new System.Windows.Forms.ListViewItem : string * string * System.Windows.Forms.ListViewGroup -> System.Windows.Forms.ListViewItem
Public Sub New (text As String, imageKey As String, group As ListViewGroup)

Parâmetros

text
String

O texto a ser exibido para o item. Isso não deve exceder 259 caracteres.

imageKey
String

O nome da imagem dentro do ImageList do ListView proprietário a ser exibido no item.

group
ListViewGroup

O ListViewGroup ao qual atribuir o item.

Comentários

Essa versão do construtor permite que você especifique o grupo ao qual pertence um item.

O imageKey parâmetro especifica uma imagem no ImageList associado ao controle proprietário ListView , que pode ser acessado com a ImageList propriedade .

Observação

ListView os grupos só estão disponíveis no Windows XP e na família Windows Server 2003 (Windows XP Home Edition, Windows XP Professional, Windows Server 2003). Para obter mais informações, consulte o tópico de visão geral ListViewGroup.

O texto do ListViewItem não deve exceder 259 caracteres ou pode ocorrer um comportamento inesperado.

Aplica-se a

ListViewItem(ListViewItem+ListViewSubItem[], String)

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

public:
 ListViewItem(cli::array <System::Windows::Forms::ListViewItem::ListViewSubItem ^> ^ subItems, System::String ^ imageKey);
public ListViewItem (System.Windows.Forms.ListViewItem.ListViewSubItem[] subItems, string imageKey);
public ListViewItem (System.Windows.Forms.ListViewItem.ListViewSubItem[] subItems, string? imageKey);
new System.Windows.Forms.ListViewItem : System.Windows.Forms.ListViewItem.ListViewSubItem[] * string -> System.Windows.Forms.ListViewItem
Public Sub New (subItems As ListViewItem.ListViewSubItem(), imageKey As String)

Parâmetros

subItems
ListViewItem.ListViewSubItem[]

Uma matriz de objetos de ListViewItem.ListViewSubItem.

imageKey
String

O nome da imagem dentro do ImageList do ListView proprietário a ser exibido no ListViewItem.

Comentários

O imageKey parâmetro especifica uma imagem no ImageList associado ao controle proprietário ListView , que pode ser acessado com a ImageList propriedade .

Aplica-se a

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.

public:
 ListViewItem(System::String ^ text, int imageIndex, System::Windows::Forms::ListViewGroup ^ group);
public ListViewItem (string text, int imageIndex, System.Windows.Forms.ListViewGroup group);
public ListViewItem (string? text, int imageIndex, System.Windows.Forms.ListViewGroup? group);
new System.Windows.Forms.ListViewItem : string * int * System.Windows.Forms.ListViewGroup -> System.Windows.Forms.ListViewItem
Public Sub New (text As String, imageIndex As Integer, group As ListViewGroup)

Parâmetros

text
String

O texto a ser exibido para o item. Isso não deve exceder 259 caracteres.

imageIndex
Int32

O índice baseado em zero da imagem dentro do ImageList associado ao ListView que contém o item.

group
ListViewGroup

O ListViewGroup ao qual atribuir o item.

Comentários

Essa versão do construtor permite que você especifique o grupo ao qual pertence um item.

Observação

ListView os grupos só estão disponíveis no Windows XP e na família Windows Server 2003 (Windows XP Home Edition, Windows XP Professional, Windows Server 2003). Para obter mais informações, consulte o tópico de visão geral ListViewGroup.

O texto do ListViewItem não deve exceder 259 caracteres ou pode ocorrer um comportamento inesperado.

Confira também

Aplica-se a

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.

public:
 ListViewItem(cli::array <System::String ^> ^ items, System::Windows::Forms::ListViewGroup ^ group);
public ListViewItem (string[] items, System.Windows.Forms.ListViewGroup group);
public ListViewItem (string[]? items, System.Windows.Forms.ListViewGroup? group);
new System.Windows.Forms.ListViewItem : string[] * System.Windows.Forms.ListViewGroup -> System.Windows.Forms.ListViewItem
Public Sub New (items As String(), group As ListViewGroup)

Parâmetros

items
String[]

Uma matriz de cadeias de caracteres que representa os subitens do novo item.

group
ListViewGroup

O ListViewGroup ao qual atribuir o item.

Comentários

Essa versão do construtor permite que você especifique o grupo ao qual pertence um item.

Observação

ListView os grupos só estão disponíveis no Windows XP e na família Windows Server 2003 (Windows XP Home Edition, Windows XP Professional, Windows Server 2003). Para obter mais informações, consulte o tópico de visão geral ListViewGroup.

Confira também

Aplica-se a

ListViewItem(String[], String)

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

public:
 ListViewItem(cli::array <System::String ^> ^ items, System::String ^ imageKey);
public ListViewItem (string[] items, string imageKey);
public ListViewItem (string[]? items, string? imageKey);
new System.Windows.Forms.ListViewItem : string[] * string -> System.Windows.Forms.ListViewItem
Public Sub New (items As String(), imageKey As String)

Parâmetros

items
String[]

Uma matriz que contém o texto dos subitens do ListViewItem.

imageKey
String

O nome da imagem dentro do ImageList do ListView proprietário a ser exibido no ListViewItem.

Comentários

O imageKey parâmetro especifica uma imagem no ImageList associado ao controle proprietário ListView , que pode ser acessado com a ImageList propriedade .

Aplica-se a

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.

public:
 ListViewItem(cli::array <System::String ^> ^ items, int imageIndex);
public ListViewItem (string[] items, int imageIndex);
public ListViewItem (string[]? items, int imageIndex);
new System.Windows.Forms.ListViewItem : string[] * int -> System.Windows.Forms.ListViewItem
Public Sub New (items As String(), imageIndex As Integer)

Parâmetros

items
String[]

Uma matriz de cadeias de caracteres que representa os subitens do novo item.

imageIndex
Int32

O índice baseado em zero da imagem dentro do ImageList associado ao ListView que contém o item.

Confira também

Aplica-se a

ListViewItem(String, ListViewGroup)

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

public:
 ListViewItem(System::String ^ text, System::Windows::Forms::ListViewGroup ^ group);
public ListViewItem (string text, System.Windows.Forms.ListViewGroup group);
public ListViewItem (string? text, System.Windows.Forms.ListViewGroup? group);
new System.Windows.Forms.ListViewItem : string * System.Windows.Forms.ListViewGroup -> System.Windows.Forms.ListViewItem
Public Sub New (text As String, group As ListViewGroup)

Parâmetros

text
String

O texto a ser exibido para o item. Isso não deve exceder 259 caracteres.

group
ListViewGroup

O ListViewGroup ao qual atribuir o item.

Comentários

Essa versão do construtor permite que você especifique o grupo ao qual pertence um item.

Observação

ListView os grupos só estão disponíveis no Windows XP e na família Windows Server 2003 (Windows XP Home Edition, Windows XP Professional, Windows Server 2003). Para obter mais informações, consulte o tópico de visão geral ListViewGroup.

O texto do ListViewItem não deve exceder 259 caracteres ou pode ocorrer um comportamento inesperado.

Confira também

Aplica-se a

ListViewItem(String, String)

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

public:
 ListViewItem(System::String ^ text, System::String ^ imageKey);
public ListViewItem (string text, string imageKey);
public ListViewItem (string? text, string? imageKey);
new System.Windows.Forms.ListViewItem : string * string -> System.Windows.Forms.ListViewItem
Public Sub New (text As String, imageKey As String)

Parâmetros

text
String

O texto a ser exibido para o item. Isso não deve exceder 259 caracteres.

imageKey
String

O nome da imagem dentro do ImageList do ListView proprietário a ser exibido no ListViewItem.

Comentários

O imageKey parâmetro especifica uma imagem no ImageList associado ao controle proprietário ListView , que pode ser acessado com a ImageList propriedade .

O texto do ListViewItem não deve exceder 259 caracteres ou pode ocorrer um comportamento inesperado.

Aplica-se a

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.

public:
 ListViewItem(System::String ^ text, int imageIndex);
public ListViewItem (string text, int imageIndex);
public ListViewItem (string? text, int imageIndex);
new System.Windows.Forms.ListViewItem : string * int -> System.Windows.Forms.ListViewItem
Public Sub New (text As String, imageIndex As Integer)

Parâmetros

text
String

O texto a ser exibido para o item. Isso não deve exceder 259 caracteres.

imageIndex
Int32

O índice baseado em zero da imagem dentro do ImageList associado ao ListView que contém o item.

Comentários

O texto do ListViewItem não deve exceder 259 caracteres ou pode ocorrer um comportamento inesperado.

Confira também

Aplica-se a

ListViewItem(SerializationInfo, StreamingContext)

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

protected:
 ListViewItem(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);
protected ListViewItem (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);
new System.Windows.Forms.ListViewItem : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Windows.Forms.ListViewItem
Protected Sub New (info As SerializationInfo, context As StreamingContext)

Parâmetros

info
SerializationInfo

Um SerializationInfo que contém informações sobre o ListViewItem a ser inicializado.

context
StreamingContext

Um StreamingContext que indica as informações de contexto, de origem e de destino de um fluxo serializado.

Aplica-se a

ListViewItem(ListViewGroup)

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

public:
 ListViewItem(System::Windows::Forms::ListViewGroup ^ group);
public ListViewItem (System.Windows.Forms.ListViewGroup group);
public ListViewItem (System.Windows.Forms.ListViewGroup? group);
new System.Windows.Forms.ListViewItem : System.Windows.Forms.ListViewGroup -> System.Windows.Forms.ListViewItem
Public Sub New (group As ListViewGroup)

Parâmetros

group
ListViewGroup

O ListViewGroup ao qual atribuir o item.

Comentários

Essa versão do construtor permite que você especifique o grupo ao qual pertence um item.

Observação

ListView os grupos só estão disponíveis no Windows XP e na família Windows Server 2003 (Windows XP Home Edition, Windows XP Professional, Windows Server 2003). Para obter mais informações, consulte o tópico de visão geral ListViewGroup.

Confira também

Aplica-se a

ListViewItem(String[])

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

public:
 ListViewItem(cli::array <System::String ^> ^ items);
public ListViewItem (string[] items);
public ListViewItem (string[]? items);
new System.Windows.Forms.ListViewItem : string[] -> System.Windows.Forms.ListViewItem
Public Sub New (items As String())

Parâmetros

items
String[]

Uma matriz de cadeias de caracteres que representa os subitens do novo item.

Aplica-se a

ListViewItem(String)

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

public:
 ListViewItem(System::String ^ text);
public ListViewItem (string text);
public ListViewItem (string? text);
new System.Windows.Forms.ListViewItem : string -> System.Windows.Forms.ListViewItem
Public Sub New (text As String)

Parâmetros

text
String

O texto a ser exibido para o item. Isso não deve exceder 259 caracteres.

Comentários

O texto do ListViewItem não deve exceder 259 caracteres ou pode ocorrer um comportamento inesperado.

Aplica-se a

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.

public:
 ListViewItem(cli::array <System::Windows::Forms::ListViewItem::ListViewSubItem ^> ^ subItems, int imageIndex);
public ListViewItem (System.Windows.Forms.ListViewItem.ListViewSubItem[] subItems, int imageIndex);
new System.Windows.Forms.ListViewItem : System.Windows.Forms.ListViewItem.ListViewSubItem[] * int -> System.Windows.Forms.ListViewItem
Public Sub New (subItems As ListViewItem.ListViewSubItem(), imageIndex As Integer)

Parâmetros

subItems
ListViewItem.ListViewSubItem[]

Uma matriz do tipo ListViewItem.ListViewSubItem que representa os subitens do item.

imageIndex
Int32

O índice baseado em zero da imagem dentro do ImageList associado ao ListView que contém o item.

Comentários

Essa versão do construtor é útil quando você cria objetos antes de adicioná-los ListViewItem.ListViewSubItem a um ListViewItem (por exemplo, para indicar formatação especial ou para usar os subitems em vários itens).

Confira também

Aplica-se a