CollectionView.CurrentItem CollectionView.CurrentItem CollectionView.CurrentItem CollectionView.CurrentItem Property

定義

ビュー内の現在の項目を取得します。Gets the current item in the view.

public:
 virtual property System::Object ^ CurrentItem { System::Object ^ get(); };
public virtual object CurrentItem { get; }
member this.CurrentItem : obj
Public Overridable ReadOnly Property CurrentItem As Object

プロパティ値

ビューの現在の項目。The current item of the view. 既定では、コレクションの最初の項目が現在のアイテムとして開始します。By default, the first item of the collection starts as the current item.

実装

注釈

コレクション ビューは、現在のレコード ポインターの概念をサポートします。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.

現在のレコード ポインターを移動、並べ替えやフィルターがいずれかとの相互運用をは、コレクションに適用されます。Note that moving the current record pointer has some interactions with any sorting or filtering that is applied to the collection. 選択すると、最後のレコードには、現在のレコード ポインターの並べ替えが保持されますが、中心に、コレクション ビューが再構築します。Sorting preserves the current record pointer on the last record selected, but the collection view is restructured around it. (選択したレコードが前に、の一覧の先頭がおそらくが途中で選択したレコードをどこかにする可能性がようになりました)。フィルター処理と、残っている場合に、フィルター処理した後、選択したレコードが保持されます。(Perhaps the selected record was at the beginning of the list before, but now the selected record might be somewhere in the middle.) Filtering preserves the selected record if that selection remains in view after the filtering. それ以外の場合、現在のレコード ポインターは、フィルター選択されたコレクション ビューの最初のレコードに設定されます。Otherwise, the current record pointer is set to the first record of the filtered collection view.

バインディングのターゲットが単一値の場合、コレクションの現在の項目に自動的にバインドされます。The current item of the collection is bound to automatically if the target of a binding is a singleton value. ターゲットの場合、 ItemsControl、現在の項目が選択した項目と同期します。If the target is an ItemsControl, the current item is synchronized with the selected item. たとえば、リスト ボックスがコレクションにバインドされている場合、CurrentItemが現在選択されている項目と同期します。For example, if a list box is bound to a collection, the CurrentItem is synchronized with the currently selected item.

注意 (継承者)

処理を別の内部呼び出しクラスのみCollectionViewオブジェクトは、このプロパティをオーバーライドする必要があります。 他のすべての派生クラスを使用する必要があります、SetCurrent(Object, Int32)基底クラスに格納されている現在の値を更新するメソッド。Only classes that pass currency handling calls to another internal CollectionView object should override this property; all other derived classes should use the SetCurrent(Object, Int32) method to update the current values stored in the base class.

適用対象