CollectionView.CurrentItem プロパティ

定義

ビュー内の現在の項目を取得します。

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

プロパティ値

ビューの現在の項目。 既定では、コレクションの最初の項目が現在のアイテムとして開始します。

実装

注釈

コレクション ビューでは、現在のレコード ポインターの概念がサポートされています。 コレクション ビュー内のオブジェクト間を移動する際に、コレクション内の特定の場所に存在するオブジェクトを取得できるレコード ポインターを移動します。

現在のレコード ポインターを移動すると、コレクションに適用される並べ替えやフィルター処理とのやり取りがいくつかあります。 並べ替えでは、選択した最後のレコードに対する現在のレコード ポインターが保持されますが、コレクション ビューはその周りに再構築されます。 (選択したレコードは以前はリストの先頭にあったかもしれませんが、選択したレコードが中央のどこかにある可能性があります)。フィルター処理を行うと、選択したレコードがフィルター処理後もビューに残っている場合は、そのレコードが保持されます。 それ以外の場合、現在のレコード ポインターは、フィルター処理されたコレクション ビューの最初のレコードに設定されます。

バインドのターゲットがシングルトン値の場合、コレクションの現在の項目は 自動的に にバインドされます。 ターゲットが の ItemsControl場合、現在の項目は選択した項目と同期されます。 たとえば、リスト ボックスがコレクションにバインドされている場合、 CurrentItem は現在選択されている項目と同期されます。

注意 (継承者)

通貨処理呼び出しを別の内部 CollectionView オブジェクトに渡すクラスのみが、このプロパティをオーバーライドする必要があります。他のすべての派生クラスは、 メソッドを SetCurrent(Object, Int32) 使用して基底クラスに格納されている現在の値を更新する必要があります。

適用対象