CollectionView.MoveCurrentTo(Object) メソッド

定義

指定された項目をビュー内の CurrentItem に設定します。

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 として設定する項目。

戻り値

結果として得られる CurrentItem がビュー内に存在する場合は true。それ以外の場合は false

実装

次の例では、このメソッドの使用方法を示します。

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

注釈

指定した項目が見つからない場合、 メソッドは を返 falseCurrentItem 、 はビュー内のコレクションの先頭の前に配置されます。

コレクション ビューでは、現在のレコード ポインターの概念がサポートされています。 コレクション ビュー内のオブジェクト間を移動する際に、コレクション内の特定の場所に存在するオブジェクトを取得できるレコード ポインターを移動します。 詳細については、「データ バインディングの概要」の「コレクションへの バインド」を参照してください。

ビューの現在の項目の詳細については、「」を参照してください CurrentItem

適用対象

こちらもご覧ください