CollectionView.CurrentItem Свойство

Определение

Пространство имен:

System.Windows.Data

Сборка:

PresentationFramework.dll

Возвращает текущий элемент в представлении.

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

Значение свойства

Object

Текущий элемент в представлении. По умолчанию первый элемент коллекции изначально является текущим элементом.

Реализации

CurrentItem

Комментарии

Представления коллекции поддерживают концепцию текущего указателя записи. При переходе по объектам в представлении коллекции перемещается указатель записи, позволяющий получить объект, который существует в этом конкретном расположении коллекции.

Обратите внимание, что перемещение текущего указателя записи имеет некоторые взаимодействия с любой сортировкой или фильтрацией, применяемой к коллекции. Сортировка сохраняет текущий указатель записи на последнюю выбранную запись, но представление коллекции переструктурировано вокруг него. (Возможно, выбранная запись была в начале списка раньше, но теперь выбранная запись может находиться где-то в середине.) Фильтрация сохраняет выбранную запись, если этот выбор остается в представлении после фильтрации. В противном случае текущий указатель записи устанавливается на первую запись отфильтрованного представления коллекции.

Текущий элемент коллекции привязывается автоматически, если целевой объект привязки является одноэлементным значением. Если целевой объект является целевым, текущий ItemsControlэлемент синхронизируется с выбранным элементом. Например, если список привязан к коллекции, CurrentItem синхронизирован с выбранным элементом.

Примечания для тех, кто наследует этот метод

Только классы, которые передают вызовы обработки валют другому внутреннему CollectionView объекту, должны переопределять это свойство. Все остальные производные классы должны использовать SetCurrent(Object, Int32) метод для обновления текущих значений, хранящихся в базовом классе.