ListViewItem.Checked Свойство

Определение

Получает или задает значение, указывающее, установлен ли флажок для данного элемента.

public bool Checked { get; set; }

Значение свойства

Значение true, если команда отмечена флажком; в обратном случае — значение false. Значение по умолчанию — false.

Примеры

В следующем примере кода создается ListView элемент управления с тремя ListViewItem указанными объектами и тремя ListViewItem.ListViewSubItem объектами, указанными для каждого элемента. В примере также создаются ColumnHeader объекты для отображения вложенных элементов в представлении сведений. В примере кода также создаются два ImageList объекта для предоставления ListViewItem изображений для объектов . Эти ImageList объекты добавляются в LargeImageList свойства и SmallImageList . В примере при создании ListView элемента управления используются следующие свойства:

Необходимо добавить код Form в и вызвать метод, созданный в примере из конструктора или другого метода в форме. В этом примере требуется, чтобы образы с именами MySmallImage1, MySmallImage2, MyLargeImage1и MyLargeImage2 находились в корневом каталоге диска C.

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);
}

Комментарии

Это свойство полезно, только если CheckBoxes свойство ListView элемента управления, в котором содержится элемент, имеет значение true. Это свойство можно использовать, чтобы определить, был ли элемент проверен пользователем или с помощью кода во время выполнения. Чтобы определить все элементы, которые проверяются в элементе ListViewCheckedItems управления, можно использовать свойство . Чтобы выполнить действие при проверке элемента, можно создать обработчик событий для ItemCheck свойства ListView элемента управления .

Применяется к

Өнім Нұсқалар
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

См. также раздел