CollectionView.MoveCurrentTo(Object) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
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.