CollectionView.MoveCurrentTo(Object) Méthode

Définition

Définit l'élément spécifié comme devant être le CurrentItem de la vue.Sets the specified item to be the CurrentItem in the view.

public:
 virtual bool MoveCurrentTo(System::Object ^ item);
public virtual bool MoveCurrentTo (object item);
abstract member MoveCurrentTo : obj -> bool
override this.MoveCurrentTo : obj -> bool
Public Overridable Function MoveCurrentTo (item As Object) As Boolean

Paramètres

item
Object

Élément à définir comme CurrentItem.The item to set as the CurrentItem.

Retours

true si le CurrentItem résultant est dans la vue ; sinon, false.true if the resulting CurrentItem is within the view; otherwise, false.

Implémente

Exemples

L’exemple suivant illustre l’utilisation de cette méthode.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);
}
' 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

Remarques

Si l’élément spécifié est introuvable, la méthode retourne false et la CurrentItem est positionnée avant le début de la collection dans la vue.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.

Les vues de collection prennent en charge le concept de pointeur d’enregistrement actif.Collection views support the concept of a current record pointer. Lorsque vous parcourez les objets d’une vue de collection, vous déplacez un pointeur d’enregistrement qui vous permet de récupérer l’objet qui existe à cet emplacement spécifique dans la collection.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. Pour plus d’informations, consultez « liaison aux collections » dans vue d’ensemblede la liaison de données.For more information, see "Binding to Collections" in Data Binding Overview.

Pour plus d’informations sur l’élément actuel d’une vue, consultez CurrentItem.For more information about the current item of a view, see CurrentItem.

S’applique à

Voir aussi