CollectionView.MoveCurrentTo Method (Object)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

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

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

public virtual bool MoveCurrentTo(
	object item
)

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.

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
void  OnNewColorClicked(object sender, RoutedEventArgs args)
{
  Button button = (Button)sender;
  ColorItemList colorList = (ColorItemList)button.DataContext;
  CollectionView cv = (CollectionView)CollectionViewSource.GetDefaultView((IEnumerable)colorList);

  // add a new color based on the current one, then select the new one
  ColorItem newItem = new ColorItem((ColorItem)cv.CurrentItem);
  colorList.Add(newItem);
  cv.MoveCurrentTo(newItem);
}

.NET Framework
Available since 3.0
Return to top
Show: