CollectionView.MoveCurrentTo(Object) メソッド

定義

指定した項目がビュー内の CurrentItem になるように設定します。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

パラメーター

item
Object

CurrentItemとして設定する項目。The item to set as the CurrentItem.

戻り値

結果として得られるtrue がビュー内にある場合は CurrentItem 、それ以外の場合は falsetrue if the resulting CurrentItem is within the view; otherwise, false.

実装

このメソッドの使用例を次に示します。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

注釈

指定した項目が見つからない場合、メソッドは false を返し、CurrentItem はビュー内のコレクションの先頭の前に配置されます。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.

ビューの現在の項目の詳細については、「CurrentItem」を参照してください。For more information about the current item of a view, see CurrentItem.

適用対象

こちらもご覧ください