CollectionView.MoveCurrentTo(Object) Método

Definição

Define o item especificado como o CurrentItem na vista.

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 definir como o CurrentItem.

Devoluções

true se o resultado CurrentItem estiver dentro da vista; caso contrário, false.

Implementações

Exemplos

O exemplo seguinte demonstra a utilização deste 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

Observações

Se o item especificado não for encontrado, o método retorna false e o CurrentItem é posicionado antes do início da coleção na visualização.

As vistas de coleção suportam o conceito de ponteiro de registo atual. Ao navegar pelos objetos numa vista de coleção, está a mover um ponteiro de registo que lhe permite recuperar o objeto que existe naquele local específico da coleção. Para obter mais informações, consulte "Vinculação a coleções" em Visão geral da vinculação de dados.

Para mais informações sobre o item atual de uma vista, veja CurrentItem.

Aplica-se a

Ver também