Export (0) Print
Expand All

CollectionView.MoveCurrentTo Method

Sets the specified item to be the CurrentItem in the view.

Namespace:  System.Windows.Data
Assembly:  PresentationFramework (in PresentationFramework.dll)

'Declaration
Public Overridable Function MoveCurrentTo ( _
	item As Object _
) As Boolean

Parameters

item
Type: System.Object

The item to set as the CurrentItem.

Return Value

Type: System.Boolean
true if the resulting CurrentItem is within the view; otherwise, false.

Implements

ICollectionView.MoveCurrentTo(Object)

If the specified item is not found, the method returns false and the CurrentItem is positioned before the beginning of the collection in the view.

Collection views support the concept of a current record pointer. As you navigate through the objects in a collection view, you are moving a record pointer that allows you to retrieve the object that exists at that particular location in the collection. For more information, see "Binding to Collections" in Data Binding Overview.

For more information about the current item of a view, see CurrentItem.

The following example demonstrates the use of this method.

	' Event handler for the NewColor button
	Private Sub OnNewColorClicked(ByVal sender As Object, ByVal args As RoutedEventArgs)
	  Dim button As Button = CType(sender, Button)
	  Dim colorList As ColorItemList = CType(button.DataContext, ColorItemList)
	  Dim cv As CollectionView = CType(CollectionViewSource.GetDefaultView(CType(colorList, IEnumerable)), CollectionView)

	  ' add a new color based on the current one, then select the new one
	  Dim newItem As New ColorItem(CType(cv.CurrentItem, ColorItem))
	  colorList.Add(newItem)
	  cv.MoveCurrentTo(newItem)
	End Sub

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Show:
© 2015 Microsoft