Condividi tramite


ListViewItem Costruttori

Definizione

Inizializza una nuova istanza della classe ListViewItem.

Overload

ListViewItem()

Inizializza una nuova istanza della classe ListViewItem con i valori predefiniti.

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

Inizializza una nuova istanza della classe ListViewItem con gli elementi secondari contenenti il testo, l'immagine, i colori, i tipi di carattere e il gruppo specificati.

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

Inizializza una nuova istanza della classe ListViewItem con la posizione di indice dell'immagine per l'icona dell'elemento, il colore di primo piano, di sfondo e il tipo di carattere dell'elemento, nonché una matrice di stringhe che rappresenta gli elementi secondari. Assegna l'elemento al gruppo specificato.

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

Inizializza una nuova istanza della classe ListViewItem con gli elementi secondari contenenti il testo, l'immagine, i colori e i tipi di carattere specificati.

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

Inizializza una nuova istanza della classe ListViewItem con la posizione di indice dell'immagine per l'icona dell'elemento, il colore di primo piano, di sfondo e il tipo di carattere dell'elemento, nonché una matrice di stringhe che rappresenta gli elementi secondari.

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

Inizializza una nuova istanza della classe ListViewItem con gli elementi secondari, l'immagine e il gruppo specificati.

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

Inizializza una nuova istanza della classe ListViewItem con la posizione di indice dell'immagine per l'icona dell'elemento e una matrice di oggetti ListViewItem.ListViewSubItem, assegna inoltre l'elemento al gruppo specificato.

ListViewItem(String[], String, ListViewGroup)

Inizializza una nuova istanza della classe ListViewItem con gli elementi secondari contenenti il testo, l'immagine e il gruppo specificati.

ListViewItem(String[], Int32, ListViewGroup)

Inizializza una nuova istanza della classe ListViewItem con la posizione di indice dell'immagine per l'icona dell'elemento stesso e una matrice di stringhe che rappresenta gli elementi secondari, inoltre assegna l'elemento al gruppo specificato.

ListViewItem(String, String, ListViewGroup)

Inizializza una nuova istanza della classe ListViewItem con il testo, l'immagine e il gruppo specificati.

ListViewItem(ListViewItem+ListViewSubItem[], String)

Inizializza una nuova istanza della classe ListViewItem con gli elementi secondari e l'immagine specificati.

ListViewItem(String, Int32, ListViewGroup)

Inizializza una nuova istanza della classe ListViewItem con il testo dell'elemento specificato e la posizione di indice dell'immagine per l'icona dell'elemento stesso e assegna l'elemento al gruppo specificato.

ListViewItem(String[], ListViewGroup)

Inizializza una nuova istanza della classe ListViewItem con una matrice di stringhe che rappresenta gli elementi secondari e assegna l'elemento al gruppo specificato.

ListViewItem(String[], String)

Inizializza una nuova istanza della classe ListViewItem con il testo e l'immagine dell'elemento e dell'elemento secondario specificati.

ListViewItem(String[], Int32)

Inizializza una nuova istanza della classe ListViewItem con la posizione di indice dell'immagine per l'icona dell'elemento stesso e una matrice di stringhe che rappresenta gli elementi secondari.

ListViewItem(String, ListViewGroup)

Inizializza una nuova istanza della classe ListViewItem con il testo dell'elemento specificato e la assegna al gruppo indicato.

ListViewItem(String, String)

Inizializza una nuova istanza della classe ListViewItem con testo e immagine specificati.

ListViewItem(String, Int32)

Inizializza una nuova istanza della classe ListViewItem con il testo dell'elemento specificato e la posizione di indice dell'immagine per l'icona dell'elemento stesso.

ListViewItem(SerializationInfo, StreamingContext)

Inizializza una nuova istanza della classe ListViewItem con le informazioni di serializzazione e il contesto di flusso specificati.

ListViewItem(ListViewGroup)

Inizializza una nuova istanza della classe ListViewItem assegnandola al gruppo specificato.

ListViewItem(String[])

Inizializza una nuova istanza della classe ListViewItem con una matrice di stringhe che rappresentano gli elementi secondari.

ListViewItem(String)

Inizializza una nuova istanza della classe ListViewItem con il testo dell'elemento specificato.

ListViewItem(ListViewItem+ListViewSubItem[], Int32)

Inizializza una nuova istanza della classe ListViewItem con la posizione di indice dell'immagine per l'icona dell'elemento e una matrice di oggetti ListViewItem.ListViewSubItem.

ListViewItem()

Inizializza una nuova istanza della classe ListViewItem con i valori predefiniti.

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

Esempio

Nell'esempio di codice seguente viene creato un ListView controllo con tre oggetti specificati e tre ListViewItemListViewItem.ListViewSubItem oggetti specificati per ogni elemento. L'esempio crea ColumnHeader anche oggetti per visualizzare gli elementi secondari nella visualizzazione dei dettagli. Due ImageList oggetti vengono creati anche nell'esempio di codice per fornire immagini per gli ListViewItem oggetti. Questi ImageList oggetti vengono aggiunti alle LargeImageList proprietà e SmallImageList . Nell'esempio vengono usate le proprietà seguenti nella creazione del ListView controllo:

È necessario aggiungere il codice a un Form e chiamare il metodo creato nell'esempio dal costruttore o da un altro metodo nel modulo. L'esempio richiede che le immagini denominate MySmallImage1, MySmallImage2, MyLargeImage1e MyLargeImage2 si trovino nella directory radice dell'unità 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

Si applica a

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

Inizializza una nuova istanza della classe ListViewItem con gli elementi secondari contenenti il testo, l'immagine, i colori, i tipi di carattere e il gruppo specificati.

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)

Parametri

items
String[]

Matrice di stringhe che rappresenta il testo degli elementi secondari dell'oggetto ListViewItem.

imageKey
String

Nome dell'immagine all'interno della proprietà ImageList dell'oggetto ListView proprietario, da visualizzare nell'elemento.

foreColor
Color

Oggetto Color che rappresenta il colore di primo piano dell'elemento.

backColor
Color

Oggetto Color che rappresenta il colore di sfondo dell'elemento.

font
Font

Oggetto Font da applicare al testo dell'elemento.

group
ListViewGroup

Oggetto ListViewGroup a cui assegnare l'elemento.

Commenti

Questa versione del costruttore consente di specificare il gruppo a cui appartiene un elemento.

Il imageKey parametro specifica un'immagine nell'oggetto ImageList associato al controllo proprietario ListView , a cui è possibile accedere con la ImageList proprietà .

Nota

ListView i gruppi sono disponibili solo in Windows XP e nella famiglia Windows Server 2003 (Windows XP Home Edition, Windows XP Professional, Windows Server 2003). Per ulteriori informazioni, vedere l'argomento relativo ai cenni preliminari su ListViewGroup.

Si applica a

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

Inizializza una nuova istanza della classe ListViewItem con la posizione di indice dell'immagine per l'icona dell'elemento, il colore di primo piano, di sfondo e il tipo di carattere dell'elemento, nonché una matrice di stringhe che rappresenta gli elementi secondari. Assegna l'elemento al gruppo specificato.

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)

Parametri

items
String[]

Matrice di stringhe che rappresentano gli elementi secondari del nuovo elemento.

imageIndex
Int32

Indice in base zero dell'immagine inclusa nell'oggetto ImageList associato all'oggetto ListView contenente l'elemento.

foreColor
Color

Oggetto Color che rappresenta il colore di primo piano dell'elemento.

backColor
Color

Oggetto Color che rappresenta il colore di sfondo dell'elemento.

font
Font

Oggetto Font che rappresenta il tipo di carattere da utilizzare per la visualizzazione del testo dell'elemento.

group
ListViewGroup

Oggetto ListViewGroup a cui assegnare l'elemento.

Commenti

Questa versione del costruttore consente di specificare il gruppo a cui appartiene un elemento.

Nota

ListView i gruppi sono disponibili solo in Windows XP e nella famiglia Windows Server 2003 (Windows XP Home Edition, Windows XP Professional, Windows Server 2003). Per ulteriori informazioni, vedere l'argomento relativo ai cenni preliminari su ListViewGroup.

Vedi anche

Si applica a

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

Inizializza una nuova istanza della classe ListViewItem con gli elementi secondari contenenti il testo, l'immagine, i colori e i tipi di carattere specificati.

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)

Parametri

items
String[]

Matrice di stringhe che rappresenta il testo degli elementi secondari dell'oggetto ListViewItem.

imageKey
String

Nome dell'immagine all'interno della proprietà ImageList dell'oggetto ListView proprietario, da visualizzare nell'elemento.

foreColor
Color

Oggetto Color che rappresenta il colore di primo piano dell'elemento.

backColor
Color

Oggetto Color che rappresenta il colore di sfondo dell'elemento.

font
Font

Oggetto Font da applicare al testo dell'elemento.

Commenti

Il imageKey parametro specifica un'immagine nell'oggetto ImageList associato al controllo proprietario ListView , a cui è possibile accedere con la ImageList proprietà .

Si applica a

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

Inizializza una nuova istanza della classe ListViewItem con la posizione di indice dell'immagine per l'icona dell'elemento, il colore di primo piano, di sfondo e il tipo di carattere dell'elemento, nonché una matrice di stringhe che rappresenta gli elementi secondari.

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)

Parametri

items
String[]

Matrice di stringhe che rappresentano gli elementi secondari del nuovo elemento.

imageIndex
Int32

Indice in base zero dell'immagine inclusa nell'oggetto ImageList associato all'oggetto ListView contenente l'elemento.

foreColor
Color

Oggetto Color che rappresenta il colore di primo piano dell'elemento.

backColor
Color

Oggetto Color che rappresenta il colore di sfondo dell'elemento.

font
Font

Oggetto Font che rappresenta il tipo di carattere da utilizzare per la visualizzazione del testo dell'elemento.

Esempio

Nell'esempio di codice seguente viene creato un modulo che contiene un ListView controllo che ordina manualmente gli elementi quando viene fatto clic su una colonna nel ListView controllo. L'esempio definisce una classe denominata ListViewItemComparer che implementa l'interfaccia che esegue il System.Collections.IComparerListViewItem confronto. Nell'esempio viene creata un'istanza di ListViewItemComparer e viene usata per impostare la ListViewItemSorter proprietà del ListView controllo. La Sort chiamata al metodo nel ColumnClick gestore eventi usa i metodi definiti in ListViewItemComparer per eseguire il tipo di elementi, in base alla colonna su cui viene fatto clic.

#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

Vedi anche

Si applica a

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

Inizializza una nuova istanza della classe ListViewItem con gli elementi secondari, l'immagine e il gruppo specificati.

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)

Parametri

subItems
ListViewItem.ListViewSubItem[]

Matrice di oggetti ListViewItem.ListViewSubItem che rappresenta gli elementi secondari dell'oggetto ListViewItem.

imageKey
String

Nome dell'immagine all'interno della proprietà ImageList dell'oggetto ListView proprietario, da visualizzare nell'elemento.

group
ListViewGroup

Oggetto ListViewGroup a cui assegnare l'elemento.

Commenti

Questa versione del costruttore è utile quando si creano ListViewItem.ListViewSubItem oggetti prima di aggiungerli a , ListViewItem ad esempio per indicare una formattazione speciale o per usare gli elementi secondari in più elementi. Consente inoltre di specificare il gruppo a cui appartiene un elemento.

Il imageKey parametro specifica un'immagine nell'oggetto ImageList associato al controllo proprietario ListView , a cui è possibile accedere con la ImageList proprietà .

Nota

ListView i gruppi sono disponibili solo in Windows XP e nella famiglia Windows Server 2003 (Windows XP Home Edition, Windows XP Professional, Windows Server 2003). Per ulteriori informazioni, vedere l'argomento relativo ai cenni preliminari su ListViewGroup.

Si applica a

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

Inizializza una nuova istanza della classe ListViewItem con la posizione di indice dell'immagine per l'icona dell'elemento e una matrice di oggetti ListViewItem.ListViewSubItem, assegna inoltre l'elemento al gruppo specificato.

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)

Parametri

subItems
ListViewItem.ListViewSubItem[]

Matrice di tipo ListViewItem.ListViewSubItem che rappresenta gli elementi secondari dell'elemento.

imageIndex
Int32

Indice in base zero dell'immagine inclusa nell'oggetto ImageList associato all'oggetto ListView contenente l'elemento.

group
ListViewGroup

Oggetto ListViewGroup a cui assegnare l'elemento.

Commenti

Questa versione del costruttore è utile quando si creano ListViewItem.ListViewSubItem oggetti prima di aggiungerli a un ListViewItem oggetto , ad esempio per indicare una formattazione speciale o per usare gli elementi secondari in più elementi. Consente inoltre di specificare il gruppo a cui appartiene un elemento.

Nota

ListView i gruppi sono disponibili solo in Windows XP e nella famiglia Windows Server 2003 (Windows XP Home Edition, Windows XP Professional, Windows Server 2003). Per ulteriori informazioni, vedere l'argomento relativo ai cenni preliminari su ListViewGroup.

Vedi anche

Si applica a

ListViewItem(String[], String, ListViewGroup)

Inizializza una nuova istanza della classe ListViewItem con gli elementi secondari contenenti il testo, l'immagine e il gruppo specificati.

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)

Parametri

items
String[]

Matrice di stringhe che rappresenta il testo degli elementi secondari dell'oggetto ListViewItem.

imageKey
String

Nome dell'immagine all'interno della proprietà ImageList dell'oggetto ListView proprietario, da visualizzare nell'elemento.

group
ListViewGroup

Oggetto ListViewGroup a cui assegnare l'elemento.

Commenti

Questa versione del costruttore consente di specificare il gruppo a cui appartiene un elemento.

Il imageKey parametro specifica un'immagine nell'oggetto ImageList associato al controllo proprietario ListView , a cui è possibile accedere con la ImageList proprietà .

Nota

ListView i gruppi sono disponibili solo in Windows XP e nella famiglia Windows Server 2003 (Windows XP Home Edition, Windows XP Professional, Windows Server 2003). Per ulteriori informazioni, vedere l'argomento relativo ai cenni preliminari su ListViewGroup.

Si applica a

ListViewItem(String[], Int32, ListViewGroup)

Inizializza una nuova istanza della classe ListViewItem con la posizione di indice dell'immagine per l'icona dell'elemento stesso e una matrice di stringhe che rappresenta gli elementi secondari, inoltre assegna l'elemento al gruppo specificato.

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)

Parametri

items
String[]

Matrice di stringhe che rappresentano gli elementi secondari del nuovo elemento.

imageIndex
Int32

Indice in base zero dell'immagine inclusa nell'oggetto ImageList associato all'oggetto ListView contenente l'elemento.

group
ListViewGroup

Oggetto ListViewGroup a cui assegnare l'elemento.

Commenti

Questa versione del costruttore consente di specificare il gruppo a cui appartiene un elemento.

Nota

ListView i gruppi sono disponibili solo in Windows XP e nella famiglia Windows Server 2003 (Windows XP Home Edition, Windows XP Professional, Windows Server 2003). Per ulteriori informazioni, vedere l'argomento relativo ai cenni preliminari su ListViewGroup.

Vedi anche

Si applica a

ListViewItem(String, String, ListViewGroup)

Inizializza una nuova istanza della classe ListViewItem con il testo, l'immagine e il gruppo specificati.

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)

Parametri

text
String

Testo da visualizzare per l'elemento. Non deve superare i 259 caratteri.

imageKey
String

Nome dell'immagine all'interno della proprietà ImageList dell'oggetto ListView proprietario, da visualizzare nell'elemento.

group
ListViewGroup

Oggetto ListViewGroup a cui assegnare l'elemento.

Commenti

Questa versione del costruttore consente di specificare il gruppo a cui appartiene un elemento.

Il imageKey parametro specifica un'immagine nell'oggetto ImageList associato al controllo proprietario ListView , a cui è possibile accedere con la ImageList proprietà .

Nota

ListView i gruppi sono disponibili solo in Windows XP e nella famiglia Windows Server 2003 (Windows XP Home Edition, Windows XP Professional, Windows Server 2003). Per ulteriori informazioni, vedere l'argomento relativo ai cenni preliminari su ListViewGroup.

Il testo di ListViewItem non deve superare i 259 caratteri o il comportamento imprevisto potrebbe verificarsi.

Si applica a

ListViewItem(ListViewItem+ListViewSubItem[], String)

Inizializza una nuova istanza della classe ListViewItem con gli elementi secondari e l'immagine specificati.

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)

Parametri

imageKey
String

Nome dell'immagine all'interno della proprietà ImageList dell'oggetto ListView proprietario, da visualizzare nell'oggetto ListViewItem.

Commenti

Il imageKey parametro specifica un'immagine nell'oggetto ImageList associato al controllo proprietario ListView , a cui è possibile accedere con la ImageList proprietà .

Si applica a

ListViewItem(String, Int32, ListViewGroup)

Inizializza una nuova istanza della classe ListViewItem con il testo dell'elemento specificato e la posizione di indice dell'immagine per l'icona dell'elemento stesso e assegna l'elemento al gruppo specificato.

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)

Parametri

text
String

Testo da visualizzare per l'elemento. Non deve superare i 259 caratteri.

imageIndex
Int32

Indice in base zero dell'immagine inclusa nell'oggetto ImageList associato all'oggetto ListView contenente l'elemento.

group
ListViewGroup

Oggetto ListViewGroup a cui assegnare l'elemento.

Commenti

Questa versione del costruttore consente di specificare il gruppo a cui appartiene un elemento.

Nota

ListView i gruppi sono disponibili solo in Windows XP e nella famiglia Windows Server 2003 (Windows XP Home Edition, Windows XP Professional, Windows Server 2003). Per ulteriori informazioni, vedere l'argomento relativo ai cenni preliminari su ListViewGroup.

Il testo di ListViewItem non deve superare i 259 caratteri o il comportamento imprevisto potrebbe verificarsi.

Vedi anche

Si applica a

ListViewItem(String[], ListViewGroup)

Inizializza una nuova istanza della classe ListViewItem con una matrice di stringhe che rappresenta gli elementi secondari e assegna l'elemento al gruppo specificato.

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)

Parametri

items
String[]

Matrice di stringhe che rappresentano gli elementi secondari del nuovo elemento.

group
ListViewGroup

Oggetto ListViewGroup a cui assegnare l'elemento.

Commenti

Questa versione del costruttore consente di specificare il gruppo a cui appartiene un elemento.

Nota

ListView i gruppi sono disponibili solo in Windows XP e nella famiglia Windows Server 2003 (Windows XP Home Edition, Windows XP Professional, Windows Server 2003). Per ulteriori informazioni, vedere l'argomento relativo ai cenni preliminari su ListViewGroup.

Vedi anche

Si applica a

ListViewItem(String[], String)

Inizializza una nuova istanza della classe ListViewItem con il testo e l'immagine dell'elemento e dell'elemento secondario specificati.

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)

Parametri

items
String[]

Matrice contenente il testo degli elementi secondari dell'oggetto ListViewItem.

imageKey
String

Nome dell'immagine all'interno della proprietà ImageList dell'oggetto ListView proprietario, da visualizzare nell'oggetto ListViewItem.

Commenti

Il imageKey parametro specifica un'immagine nell'oggetto ImageList associato al controllo proprietario ListView , a cui è possibile accedere con la ImageList proprietà .

Si applica a

ListViewItem(String[], Int32)

Inizializza una nuova istanza della classe ListViewItem con la posizione di indice dell'immagine per l'icona dell'elemento stesso e una matrice di stringhe che rappresenta gli elementi secondari.

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)

Parametri

items
String[]

Matrice di stringhe che rappresentano gli elementi secondari del nuovo elemento.

imageIndex
Int32

Indice in base zero dell'immagine inclusa nell'oggetto ImageList associato all'oggetto ListView contenente l'elemento.

Vedi anche

Si applica a

ListViewItem(String, ListViewGroup)

Inizializza una nuova istanza della classe ListViewItem con il testo dell'elemento specificato e la assegna al gruppo indicato.

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)

Parametri

text
String

Testo da visualizzare per l'elemento. Non deve superare i 259 caratteri.

group
ListViewGroup

Oggetto ListViewGroup a cui assegnare l'elemento.

Commenti

Questa versione del costruttore consente di specificare il gruppo a cui appartiene un elemento.

Nota

ListView i gruppi sono disponibili solo in Windows XP e nella famiglia Windows Server 2003 (Windows XP Home Edition, Windows XP Professional, Windows Server 2003). Per ulteriori informazioni, vedere l'argomento relativo ai cenni preliminari su ListViewGroup.

Il testo di ListViewItem non deve superare i 259 caratteri o il comportamento imprevisto potrebbe verificarsi.

Vedi anche

Si applica a

ListViewItem(String, String)

Inizializza una nuova istanza della classe ListViewItem con testo e immagine specificati.

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)

Parametri

text
String

Testo da visualizzare per l'elemento. Non deve superare i 259 caratteri.

imageKey
String

Nome dell'immagine all'interno della proprietà ImageList dell'oggetto ListView proprietario, da visualizzare nell'oggetto ListViewItem.

Commenti

Il imageKey parametro specifica un'immagine nell'oggetto ImageList associato al controllo proprietario ListView , a cui è possibile accedere con la ImageList proprietà .

Il testo di ListViewItem non deve superare i 259 caratteri o il comportamento imprevisto potrebbe verificarsi.

Si applica a

ListViewItem(String, Int32)

Inizializza una nuova istanza della classe ListViewItem con il testo dell'elemento specificato e la posizione di indice dell'immagine per l'icona dell'elemento stesso.

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)

Parametri

text
String

Testo da visualizzare per l'elemento. Non deve superare i 259 caratteri.

imageIndex
Int32

Indice in base zero dell'immagine inclusa nell'oggetto ImageList associato all'oggetto ListView contenente l'elemento.

Commenti

Il testo di ListViewItem non deve superare i 259 caratteri o il comportamento imprevisto potrebbe verificarsi.

Vedi anche

Si applica a

ListViewItem(SerializationInfo, StreamingContext)

Inizializza una nuova istanza della classe ListViewItem con le informazioni di serializzazione e il contesto di flusso specificati.

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)

Parametri

info
SerializationInfo

Oggetto SerializationInfo contenente informazioni sull'oggetto ListViewItem da inizializzare.

context
StreamingContext

Oggetto StreamingContext che indica la destinazione dell'origine e le informazioni sul contesto di un flusso serializzato.

Si applica a

ListViewItem(ListViewGroup)

Inizializza una nuova istanza della classe ListViewItem assegnandola al gruppo specificato.

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)

Parametri

group
ListViewGroup

Oggetto ListViewGroup a cui assegnare l'elemento.

Commenti

Questa versione del costruttore consente di specificare il gruppo a cui appartiene un elemento.

Nota

ListView i gruppi sono disponibili solo in Windows XP e nella famiglia Windows Server 2003 (Windows XP Home Edition, Windows XP Professional, Windows Server 2003). Per ulteriori informazioni, vedere l'argomento relativo ai cenni preliminari su ListViewGroup.

Vedi anche

Si applica a

ListViewItem(String[])

Inizializza una nuova istanza della classe ListViewItem con una matrice di stringhe che rappresentano gli elementi secondari.

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())

Parametri

items
String[]

Matrice di stringhe che rappresentano gli elementi secondari del nuovo elemento.

Si applica a

ListViewItem(String)

Inizializza una nuova istanza della classe ListViewItem con il testo dell'elemento specificato.

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)

Parametri

text
String

Testo da visualizzare per l'elemento. Non deve superare i 259 caratteri.

Commenti

Il testo di ListViewItem non deve superare i 259 caratteri o il comportamento imprevisto potrebbe verificarsi.

Si applica a

ListViewItem(ListViewItem+ListViewSubItem[], Int32)

Inizializza una nuova istanza della classe ListViewItem con la posizione di indice dell'immagine per l'icona dell'elemento e una matrice di oggetti 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)

Parametri

subItems
ListViewItem.ListViewSubItem[]

Matrice di tipo ListViewItem.ListViewSubItem che rappresenta gli elementi secondari dell'elemento.

imageIndex
Int32

Indice in base zero dell'immagine inclusa nell'oggetto ImageList associato all'oggetto ListView contenente l'elemento.

Commenti

Questa versione del costruttore è utile quando si creano ListViewItem.ListViewSubItem oggetti prima di aggiungerli a , ListViewItem ad esempio per indicare una formattazione speciale o per usare gli elementi secondari in più elementi.

Vedi anche

Si applica a