Partager via


CollectionView.CurrentItem Propriété

Définition

Obtient l'élément actif de la vue.

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. Par défaut, le premier élément de la collection commence en tant qu’élément actuel.

Implémente

Remarques

Les vues de collection prennent en charge le concept d’un pointeur d’enregistrement actif. 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 particulier dans la collection.

Notez que le déplacement du pointeur d’enregistrement actif a certaines interactions avec tout tri ou filtrage appliqué à la collection. Le tri conserve le pointeur d’enregistrement actif sur le dernier enregistrement sélectionné, mais l’affichage de collection est restructuré autour de celui-ci. (Peut-être que l’enregistrement sélectionné se trouvait au début de la liste auparavant, mais maintenant l’enregistrement sélectionné peut se trouver quelque part au milieu.) Le filtrage conserve l’enregistrement sélectionné si cette sélection reste visible après le filtrage. Sinon, le pointeur d’enregistrement actif est défini sur le premier enregistrement de la vue de collection filtrée.

L’élément actuel de la collection est lié automatiquement à si la cible d’une liaison est une valeur singleton. Si la cible est un ItemsControl, l’élément actif est synchronisé avec l’élément sélectionné. Par exemple, si une zone de liste est liée à une collection, le CurrentItem est synchronisé avec l’élément actuellement sélectionné.

Notes pour les héritiers

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

S’applique à