CollectionView.MoveCurrentTo(Object) Método

Definição

Define o item especificado como o CurrentItem na exibição.

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

Parâmetros

item
Object

O item a ser definido como o CurrentItem.

Retornos

Boolean

true se o CurrentItem resultante estiver na exibição; caso contrário, false.

Implementações

Exemplos

O exemplo a seguir demonstra o uso desse método.

// 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

Comentários

Se o item especificado não for encontrado, o método retornará false e o CurrentItem será posicionado antes do início da coleção no modo de exibição.

As exibições de coleção dão suporte ao conceito de um ponteiro de registro atual. Ao navegar pelos objetos em uma exibição de coleção, você está movendo um ponteiro de registro que permite recuperar o objeto que existe naquele local específico da coleção. Para obter mais informações, consulte "Associação a coleções" na visão geral da Associação de Dados.

Para obter mais informações sobre o item atual de um modo de exibição, consulte CurrentItem.

Aplica-se a

Confira também