CollectionView.CurrentItem Свойство

Определение

Возвращает текущий элемент в представлении.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.

Применяется к