Edit this page

Checkboxes

RadListViews' items have built-in checkboxes which can be shown by setting the ShowCheckBoxes property of RadListView to true.

Enable checkboxes


this.radListView1.ShowCheckBoxes = true;

Me.RadListView1.ShowCheckBoxes = True

When checkboxes are enabled, you have several options to handle the checked items:

  • You can check or uncheck items via the checkbox that is shown in each item

Figure 1: Toggle the item by using the mouse

listview-using-checkboxes 001

  • You can get or set the checked state of the ListViewDataItem directly via its CheckedState property:

Toggle an item programmatically

ListViewDataItem checkedItem = new ListViewDataItem("Checked item");
checkedItem.CheckState = Telerik.WinControls.Enumerations.ToggleState.On;
this.radListView1.Items.Add(checkedItem);

ListViewDataItem uncheckedItem = new ListViewDataItem("Unchecked item");
uncheckedItem.CheckState = Telerik.WinControls.Enumerations.ToggleState.Off;
this.radListView1.Items.Add(uncheckedItem);

Dim checkedItem As New ListViewDataItem("Checked item")
checkedItem.CheckState = Telerik.WinControls.Enumerations.ToggleState.[On]
Me.RadListView1.Items.Add(checkedItem)
Dim uncheckedItem As New ListViewDataItem("Unchecked item")
uncheckedItem.CheckState = Telerik.WinControls.Enumerations.ToggleState.Off
Me.RadListView1.Items.Add(uncheckedItem)

Figure 2: Toggle items programmatically

listview-using-checkboxes 002

  • You can get the checked items in RadListView via its CheckedItems collection

  • The CheckOnClickMode property gets or sets a value indicating whether the item's check state changes whenever the item is clicked. The following values are available:

    • CheckOnClickMode.Off: Item's CheckState property is not toggled on click.
    • CheckOnClickMode.FirstClick: Item is selected and the CheckState property is toggled on first click.
    • CheckOnClickMode.SecondClick: Item is selected on first click. On second click the CheckState property is toggled.
  • You can listen for changes in the check state of the items via the following events:

    • ItemCheckedChanging: Occurs when a ListViewDataItem is about to be checked. You can cancel this event.
    • ItemCheckedChanged: Occurs when a ListViewDataItem is checked.