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

Définition

Obtient l'élément actif de la vue.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

Valeur de propriété

Élément actuel de la vue.The current item of the view. Par défaut, le premier élément de la collection commence en tant qu’élément actuel.By default, the first item of the collection starts as the current item.

Implémente

Remarques

Les vues de collection prennent en charge le concept de pointeur d’enregistrement actif.Collection views support the concept of a current record pointer. Lorsque vous parcourez les objets d’une vue de collection, vous déplacez un pointeur d’enregistrement qui vous permet de récupérer l’objet qui existe à cet emplacement spécifique dans la collection.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.

Notez que le déplacement du pointeur d’enregistrement actif présente des interactions avec tout tri ou filtrage appliqué à la collection.Note that moving the current record pointer has some interactions with any sorting or filtering that is applied to the collection. Le tri conserve le pointeur d’enregistrement actif sur le dernier enregistrement sélectionné, mais la vue de collection est restructurée autour de lui.Sorting preserves the current record pointer on the last record selected, but the collection view is restructured around it. (Peut-être que l’enregistrement sélectionné était au début de la liste avant, mais à présent, l’enregistrement sélectionné peut se trouver quelque part au milieu). Le filtrage conserve l’enregistrement sélectionné si cette sélection reste affichée après le filtrage.(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. Dans le cas contraire, le pointeur d’enregistrement actif est défini sur le premier enregistrement de la vue de collection filtrée.Otherwise, the current record pointer is set to the first record of the filtered collection view.

L’élément actuel de la collection est automatiquement lié à si la cible d’une liaison est une valeur Singleton.The current item of the collection is bound to automatically if the target of a binding is a singleton value. Si la cible est un ItemsControl, l’élément actuel est synchronisé avec l’élément sélectionné.If the target is an ItemsControl, the current item is synchronized with the selected item. Par exemple, si une zone de liste est liée à une collection, CurrentItem est synchronisé avec l’élément actuellement sélectionné.For example, if a list box is bound to a collection, the CurrentItem is synchronized with the currently selected item.

Notes pour les héritiers

Seules les classes qui passent des appels de gestion de CollectionView devises à un autre objet interne doivent substituer cette propriété ; toutes les SetCurrent(Object, Int32) autres classes dérivées doivent utiliser la méthode pour mettre à jour les valeurs actuelles stockées dans la classe de base.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.

S’applique à