The RadListView control is now obsolete and will be removed in the future. Use the RadCollectionView control instead. The RadCollectionView is a complete, ground-up rewrite of the ListView. The RadCollectionView offers improved performance, enhanced features, and a modernized approach to managing lists of data. The RadCollectionView incorporates all of the ListView's key features. More about the differences between both components and how to migrate to the new RadCollectionView is available in the Migrating the Telerik .NET MAUI RadListView to RadCollectionView article.

.NET MAUI ListView Events

The ListView component exposes a set of events.

Item Events

• ItemTapped—Occurs when an item is tapped. The ItemTapped event handler receives two parameters:

  • The sender argument which is of type object, but can be cast to the RadListView type.
  • An ItemTapEventArgs object which has a reference to the tapped item through its Item property.

• ItemHold—Occurs when the end user is holding on a specific item. The ItemHold event handler receives two parameters:

  • The sender argument which is of type object, but can be cast to the RadListView type.
  • An ItemHoldEventArgs object which has a reference to the held item through its Item property.

• RefreshRequested—Occurs when the pull-to-refresh gesture is triggered. The RefreshRequested event handler receives two parameters:

  • The sender argument which is of type object, but can be cast to the RadListView type.
  • A PullToRefreshRequestedEventArgs object which provides Cancel property used to cancel the pull-to-refresh operation.

  For more details on the RefreshRequested event usage, refer to the Pull to Refresh topic.

Selection Events

The SelectionChanged occurs when the SelectionItems collection is updated. The SelectionChanged event handler receives two parameters:

• The sender argument which is of type object, but can be cast to the RadListView type.
• A NotifyCollectionChangedEventArgs object which provides information on the collection changed event. For more details, refer to the NotifyCollectionChangedEventArgs Class topic.

Group/Reorder Events

• GroupHeaderTapped—Occurs when a group header of a grouped ListView is tapped. The GroupHeaderTapped event handler receives two parameters:

  • The sender argument which is of type object, but can be cast to the RadListView type.
  • A GroupHeaderTapEventArgs object which provides the following properties:
    • Key—Gets the specific key for the group.
    • Items—Gets the child items of the group.

• ReorderStarting—Occurs when a reorder operation is about to start. The ReorderStarting event handler receives two parameters:

  • The sender argument which is of type object, but can be cast to the RadListView type.
  • A ReorderStartingEventArgs object provides the following properties:
    • Item—Gets the item that is about to be dragged.
    • Cancel—A boolean property which can be used to cancel the reorder operation.

• ReorderEnded—Occurs when a reorder operation has ended. The ReorderEnded event handler receives two parameters:

  • The sender argument which is of type object, but can be cast to the RadListView type.
  • A ReorderEndedEventArgs object which has a reference to the item that was reordered through its Item property.

Swipe Events

The ListView exposes a few useful events related to the item swiping feature, namely ItemSwipeStarting, ItemSwiping and ItemSwipeCompleted. For detailed information on using the swiping events, refer to the Cell Swipe topic.

See Also

• Selection
• Grouping
• Reordering
• Pull to Refresh
• Cell Swipe