Assembly: System.Windows.Forms (in system.windows.forms.dll)
<SerializableAttribute> _ Public Class ListViewItem Implements ICloneable, ISerializable
Dim instance As ListViewItem
[SerializableAttribute] public class ListViewItem : ICloneable, ISerializable
[SerializableAttribute] public ref class ListViewItem : ICloneable, ISerializable
/** @attribute SerializableAttribute() */ public class ListViewItem implements ICloneable, ISerializable
SerializableAttribute public class ListViewItem implements ICloneable, ISerializable
Il controllo ListView è analogo a un oggetto ListBox, in quanto entrambi consentono di visualizzare un elenco di elementi. La differenza principale consiste nel fatto che il controllo ListView prevede più modalità di visualizzazione degli elementi. La classe ListViewItem definisce l'aspetto, il funzionamento e i dati associati a un elemento visualizzato nel controllo ListView. Gli oggetti ListViewItem possono essere visualizzati nel controllo ListView in base a una delle quattro modalità indicate di seguito. Gli elementi possono essere visualizzati come icone grandi, icone piccole o icone piccole in un elenco verticale oppure possono essere associati a elementi secondari contenenti informazioni correlate all'elemento padre. Infine, è possibile applicare una visualizzazione di dettaglio, in cui l'elemento e i relativi elementi secondari sono rappresentati all'interno di una griglia con intestazioni di colonna che consentono di individuare le informazioni associate a un elemento secondario.
La maggior parte delle proprietà della classe ListViewItem consente di modificare la visualizzazione dell'elemento nel controllo ListView a cui è associato. Le proprietà BackColor, ForeColor e Font consentono di modificare la modalità di visualizzazione del testo dell'elemento nel controllo ListView. La proprietà ImageIndex consente di specificare l'immagine da caricare dall'oggetto ImageList assegnato al controllo ListView, tramite l'impostazione delle proprietà LargeImageList o SmallImageList dell'oggetto ListView. Accanto agli elementi è possibile visualizzare caselle di controllo selezionabili dall'utente, così come avviene per un controllo CheckedListBox. La proprietà Checked consente di determinare se un elemento è selezionato oppure di selezionare o deselezionare la casella di controllo in fase di esecuzione. Per ciascun elemento è possibile visualizzare un numero illimitato di elementi secondari se la proprietà View del controllo ListView associato è impostata su Details e le colonne sono definite nell'oggetto ListView.ColumnHeaderCollection del controllo ListView. È possibile aggiungere elementi secondari a un elemento chiamando il metodo Add della classe ListViewItem.ListViewSubItemCollection. La proprietà SubItems consente di accedere alla classe ListViewItem.ListViewSubItemCollection e ai relativi membri.
Alcuni dei metodi e delle proprietà della classe ListViewItem rappresentano versioni specifiche per un particolare elemento dei metodi e delle proprietà del controllo ListView. Ad esempio, il metodo EnsureVisibleè analogo alla versione ListView del metodo, ma la versione ListViewItem ha effetto soltanto sulla versione corrente.
Nella classe ListViewItem sono inoltre disponibili metodi che non rappresentano versioni di metodi ListView. Il metodo BeginEdit consente di attivare la modalità di modifica per il testo dell'elemento, in modo da consentirne la modifica da parte dell'utente a condizione che la proprietà LabelEdit del controllo ListView sia impostata su true. Il metodo Clone consente di creare copie degli oggetti ListViewItem esistenti, da riutilizzare in altri controlli ListView.
Nell'esempio di codice riportato di seguito viene creato un controllo ListView con tre oggetti ListViewItem specificati e tre oggetti ListViewItem.ListViewSubItem specificati per ciascun elemento. Nell'esempio sono creati anche degli oggetti ColumnHeader per la visualizzazione degli elementi secondari nella visualizzazione Dettagli. Nel codice di esempio vengono inoltre creati due oggetti ImageList che forniscono immagini per gli oggetti ListViewItem. Questi oggetti ImageList vengono aggiunti alle proprietà LargeImageList e SmallImageList. Nell'esempio sono utilizzate le seguenti proprietà per la creazione del controllo ListView:
-
View
-
LabelEdit
È necessario aggiungere il codice a un oggetto Form e chiamare il metodo creato nell'esempio dal costruttore o da un altro metodo del form. Nell'esempio si presuppone che le immagini denominate MySmallImage1, MySmallImage2, MyLargeImage1 e MyLargeImage2 siano memorizzate nella directory principale dell'unità C.
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. 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 'CreateMyListView
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. listView1.Columns.Add("Item Column", -2, HorizontalAlignment.Left); listView1.Columns.Add("Column 2", -2, HorizontalAlignment.Left); listView1.Columns.Add("Column 3", -2, HorizontalAlignment.Left); listView1.Columns.Add("Column 4", -2, HorizontalAlignment.Center); //Add the items to the ListView. listView1.Items.AddRange(new ListViewItem[]{item1,item2,item3}); // Create two ImageList objects. ImageList imageListSmall = new ImageList(); ImageList imageListLarge = new ImageList(); // Initialize the ImageList objects with bitmaps. imageListSmall.Images.Add(Bitmap.FromFile("C:\\MySmallImage1.bmp")); imageListSmall.Images.Add(Bitmap.FromFile("C:\\MySmallImage2.bmp")); imageListLarge.Images.Add(Bitmap.FromFile("C:\\MyLargeImage1.bmp")); imageListLarge.Images.Add(Bitmap.FromFile("C:\\MyLargeImage2.bmp")); //Assign the ImageList objects to the ListView. listView1.LargeImageList = imageListLarge; listView1.SmallImageList = imageListSmall; // Add the ListView to the control collection. this.Controls.Add(listView1); }
private: void CreateMyListView() { // Create a new ListView control. ListView^ listView1 = 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. 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.set_Bounds(new Rectangle(new Point(10, 10),
new Size(300, 200)));
// Set the view to show details.
listView1.set_View(View.Details);
// Allow the user to edit item text.
listView1.set_LabelEdit(true);
// Allow the user to rearrange columns.
listView1.set_AllowColumnReorder(true);
// Display check boxes.
listView1.set_CheckBoxes(true);
// Select the item and subitems when selection is made.
listView1.set_FullRowSelect(true);
// Display grid lines.
listView1.set_GridLines(true);
// Sort the items in the list in ascending order.
listView1.set_Sorting(SortOrder.Ascending);
// Create three items and three sets of subitems for each item.
ListViewItem item1 = new ListViewItem("item1", 0);
// Place a check mark next to the item.
item1.set_Checked(true);
item1.get_SubItems().Add("1");
item1.get_SubItems().Add("2");
item1.get_SubItems().Add("3");
ListViewItem item2 = new ListViewItem("item2", 1);
item2.get_SubItems().Add("4");
item2.get_SubItems().Add("5");
item2.get_SubItems().Add("6");
ListViewItem item3 = new ListViewItem("item3", 0);
// Place a check mark next to the item.
item3.set_Checked(true);
item3.get_SubItems().Add("7");
item3.get_SubItems().Add("8");
item3.get_SubItems().Add("9");
// Create columns for the items and subitems.
listView1.get_Columns().Add("Item Column", -2,
HorizontalAlignment.Left);
listView1.get_Columns().Add("Column 2", -2, HorizontalAlignment.Left);
listView1.get_Columns().Add("Column 3", -2, HorizontalAlignment.Left);
listView1.get_Columns().Add("Column 4", -2, HorizontalAlignment.Center);
//Add the items to the ListView.
listView1.get_Items().AddRange(new ListViewItem[] { item1, item2,
item3 });
// Create two ImageList objects.
ImageList imageListSmall = new ImageList();
ImageList imageListLarge = new ImageList();
// Initialize the ImageList objects with bitmaps.
imageListSmall.get_Images().Add(Bitmap.FromFile(
"C:\\MySmallImage1.bmp"));
imageListSmall.get_Images().Add(Bitmap.FromFile(
"C:\\MySmallImage2.bmp"));
imageListLarge.get_Images().Add(Bitmap.FromFile(
"C:\\MyLargeImage1.bmp"));
imageListLarge.get_Images().Add(Bitmap.FromFile(
"C:\\MyLargeImage2.bmp"));
//Assign the ImageList objects to the ListView.
listView1.set_LargeImageList(imageListLarge);
listView1.set_SmallImageList(imageListSmall);
// Add the ListView to the control collection.
this.get_Controls().Add(listView1);
} //CreateMyListView
System.Windows.Forms.ListViewItem
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile per Pocket PC, Windows Mobile per Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema.