ListView.CheckBoxes ListView.CheckBoxes ListView.CheckBoxes ListView.CheckBoxes Property

Definition

Ruft einen Wert ab, der angibt, ob neben jedem Element im Steuerelement ein Kontrollkästchen angezeigt wird, oder legt diesen fest.Gets or sets a value indicating whether a check box appears next to each item in the control.

public:
 property bool CheckBoxes { bool get(); void set(bool value); };
public bool CheckBoxes { get; set; }
member this.CheckBoxes : bool with get, set
Public Property CheckBoxes As Boolean

Eigenschaftswert

true Wenn das Kontrollkästchen neben jedem Element im angezeigt wird, die ListView steuern; andernfalls false.true if a check box appears next to each item in the ListView control; otherwise, false. Die Standardeinstellung ist false.The default is false.

Beispiele

Das folgende Codebeispiel erstellt eine ListView -Steuerelement mit drei ListViewItem angegebenen Objekte und drei ListViewItem.ListViewSubItem Objekte, die für jedes Element angegeben.The following code example creates a ListView control with three ListViewItem objects specified and three ListViewItem.ListViewSubItem objects specified for each item. Außerdem erstellt das Beispiel ColumnHeader Objekte, die Unterelemente in der Detailansicht angezeigt werden sollen.The example also creates ColumnHeader objects to display the subitems in details view. Zwei ImageList Objekte werden im Codebeispiel zu Images für außerdem erstellt der ListViewItem Objekte.Two ImageList objects are also created in the code example to provide images for the ListViewItem objects. Diese ImageList Objekte werden hinzugefügt, um die LargeImageList und SmallImageList Eigenschaften.These ImageList objects are added to the LargeImageList and SmallImageList properties. Im Beispiel verwendet die folgenden Eigenschaften beim Erstellen der ListView Steuerelement.The example uses the following properties in creating the ListView control.

Dieses Beispiel erfordert, dass Sie den Code hinzugefügt haben eine Form und rufen die Methode, die im Beispiel aus dem Konstruktor oder eine andere Methode auf dem Formular erstellt.This example requires that you have added the code to a Form and call the method created in the example from the constructor or another method on the form. Das Beispiel erfordert auch, dass die Images mit dem Namen MySmallImage1, MySmallImage2, MyLargeImage1, und MyLargeImage2 befinden sich im Stammverzeichnis von Laufwerk C.The example also requires that images named MySmallImage1, MySmallImage2, MyLargeImage1, and MyLargeImage2 are located in the root directory of drive 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 'CreateMyListView

Hinweise

Die CheckBoxes Eigenschaft können Sie das Kontrollkästchen neben jedem Element in der Liste angezeigt.The CheckBoxes property allows you to display a check box next to each item in the list. Dadurch kann die Anwendung aus, um eine Liste von Elementen anzuzeigen (und die Unterelemente darstellen, wenn die View -Eigenschaftensatz auf View.Details), dass der Benutzer auswählen kann, indem Sie auf das Kontrollkästchen.This enables your application to display a list of items (and subitems if the View property is set to View.Details) that the user can select by clicking the check box. Die CheckBoxes Eigenschaft bietet eine Möglichkeit zur Auswahl mehrerer Elemente in der ListView Steuerelement ohne die STRG-Taste.The CheckBoxes property offers a way to select multiple items in the ListView control without using the CTRL key. Abhängig von Ihrer Anwendung kann die Verwendung von Kontrollkästchen verweisen, statt den Standard Auswählen mehrerer Auswahlmethode für den Benutzer einfacher sein.Depending on your application, using check boxes to select items rather than the standard multiple selection method may be easier for the user. Auch wenn die MultiSelect Eigenschaft der ListView -Steuerelement so eingestellt ist, dass false, können Sie weiterhin anzeigen Kontrollkästchen und mehrere Auswahlfunktionen für den Benutzer bereitstellen.Even if the MultiSelect property of the ListView control is set to false, you can still display checkboxes and provide multiple selection capabilities to the user. Dieses Feature kann nützlich sein, wenn Sie nicht mehrere Elemente ausgewählt werden soll noch immer noch dem Benutzer ermöglichen, wählen Sie mehrere Elemente aus der Liste einen Vorgang in Ihrer Anwendung ausführen möchten.This feature can be useful if you do not want multiple items to be selected yet still want to allow the user to choose multiple items from the list to perform an operation within your application.

Um zu bestimmen, wann ein Element aktiviert wurde, erstellen Sie einen Ereignishandler für die ItemCheck Ereignis.To determine when an item has been checked, create an event handler for the ItemCheck event. Um alle Elemente abzurufen, die eingecheckt werden die ListView, verwenden Sie die CheckedItems Eigenschaft, die Zugriff auf die ListView.CheckedIndexCollection für das Steuerelement.To get all the items that are checked in the ListView, use the CheckedItems property to access the ListView.CheckedIndexCollection for the control. Um die Indizes aller Elemente abzurufen, die eingecheckt werden die ListView, verwenden Sie die CheckedIndices Eigenschaft.To get the indexes of all items that are checked in the ListView, use the CheckedIndices property.

Wenn ein ImageList angegeben ist, der StateImageList -Eigenschaft, die Bilder an der Indexposition 0 und 1 in der ImageList werden angezeigt, statt das Kontrollkästchen.If an ImageList is specified in the StateImageList property, the images at index positions 0 and 1 in the ImageList are displayed instead of the check box. Das Bild an der Indexposition 0 wird angezeigt, statt das Kontrollkästchen deaktiviert, und das Bild an der Indexposition 1 anstelle der aktivierten Kontrollkästchens angezeigt wird.The image at index position 0 is displayed instead of the unchecked check box, and the image at index position 1 is displayed instead of the checked check box.

Hinweis

Wenn Sie diese Eigenschaft festlegen, um true, ItemCheck Ereignis auftritt.When you set this property to true, the ItemCheck event occurs.

Kontrollkästchen werden nicht angezeigt wird, wenn die View -Eigenschaftensatz auf Tile.Check boxes are not displayed when the View property is set to Tile.

Gilt für:

Siehe auch