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) メソッドを使用する必要があります。