Assembly: System.Windows.Forms (in system.windows.forms.dll)
Public Property CheckBoxes As Boolean
Dim instance As ListView Dim value As Boolean value = instance.CheckBoxes instance.CheckBoxes = value
public bool CheckBoxes { get; set; }
public: property bool CheckBoxes { bool get (); void set (bool value); }
/** @property */ public boolean get_CheckBoxes () /** @property */ public void set_CheckBoxes (boolean value)
public function get CheckBoxes () : boolean public function set CheckBoxes (value : boolean)
Valore proprietà
true se viene visualizzata una casella di controllo accanto a ciascun elemento nel controllo ListView; in caso contrario, false. Il valore predefinito è false.La proprietà CheckBoxes consente di visualizzare una casella di controllo accanto a ciascun elemento nell'elenco. In questo modo, nell'applicazione viene visualizzato un elenco di elementi e, se la proprietà View è impostata su View.Details, di elementi secondari, che possono essere selezionati dall'utente facendo clic nella casella di controllo. La proprietà CheckBoxes consente di selezionare più elementi nel controllo ListView, senza utilizzare il tasto CTRL. A seconda dell'applicazione in esecuzione, può risultare più semplice agli utenti selezionare gli elementi tramite le caselle di controllo anziché tramite il metodo di selezione multipla standard. È possibile visualizzare le caselle di controllo anche se la proprietà MultiSelect del controllo ListView è impostata su false, in modo di fornire agli utenti più funzioni di selezione. Questa funzionalità può risultare utile se non si desidera che vengano selezionati più elementi, ma si desidera consentire all'utente di scegliere più elementi dall'elenco, per eseguire un'operazione all'interno dell'applicazione.
Per determinare se un elemento è stato selezionato, creare un gestore eventi per l'evento ItemCheck. Per ottenere tutti gli elementi selezionati nel controllo ListView, utilizzare la proprietà CheckedItems per accedere all'oggetto ListView.CheckedIndexCollection del controllo. Per ottenere gli indici di tutti gli elementi selezionati nel controllo ListView, utilizzare la proprietà CheckedIndices.
Se un oggetto ImageList è specificato nella proprietà StateImageList, le immagini in corrispondenza delle posizioni di indice 0 e 1 nel controllo ImageList vengono visualizzate al posto della casella di controllo. Le immagini in corrispondenza delle posizioni di indice 0 e 1 vengono visualizzate rispettivamente al posto della casella di controllo non selezionata e della casella di controllo selezionata.
 Nota |
|---|
| Se si imposta la proprietà su true, si verifica l'evento ItemCheck. Se la proprietà View è impostata su Tile, le caselle di controllo non vengono visualizzate. |
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. nonché alcuni 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 vengono utilizzate le seguenti proprietà per la creazione del controllo ListView.
-
View
-
CheckBoxes
In questo esempio si presuppone che sia stato aggiunto il codice a una classe Form e che sia stato chiamato il metodo creato nell'esempio dal costruttore o un altro metodo nel form. Si presuppone inoltre 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
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.