CollectionView.CurrentItem, propriété

public virtual Object CurrentItem { get; }

Implémentations

Les vues de collection prennent en charge le concept d'un pointeur d'enregistrement actuel. Lorsque vous naviguez parmi 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 précis de la collection.

Notez que le déplacement du pointeur d'enregistrement actif provoque des interactions avec les opérations de tri ou de filtrage appliquées à la collection. Le tri conserve le pointeur d'enregistrement actif sur le dernier enregistrement sélectionné, mais la vue de collection est restructurée en relation. (Peut-être l'enregistrement sélectionné était-il auparavant au début de la liste, mais maintenant il peut être quelque part au milieu.) Le filtrage conserve l'enregistrement sélectionné si cette sélection reste dans la vue après le filtrage. Sinon, le pointeur d'enregistrement actif a pour valeur 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 actuel est synchronisé avec l'élément sélectionné. Par exemple, si une zone de liste est liée à une collection, CurrentItem est synchronisé avec l'élément actuellement sélectionné.

Les classes qui passent des appels relatifs à la monnaie à un autre objet CollectionView interne sont les seules qui doivent substituer cette propriété ; toutes les autres classes dérivées doivent utiliser la méthode SetCurrent pour mettre à jour les valeurs actuelles stockées dans la classe de base.

Les vues permettent d'afficher la même collection de données de différentes façons, selon les paramètres de tri, de filtrage ou de regroupement. Les vues fournissent également un concept de pointeur d'enregistrement actif et permettent le déplacement du pointeur. Cet exemple montre comment obtenir l'objet actif et naviguer parmi les objets d'une collection de données en utilisant la fonctionnalité fournie dans la classe CollectionView.

Dans cet exemple, myCollectionView est un objet CollectionView qui est une vue sur une collection liée.

Dans l'exemple suivant, OnButton est un gestionnaire d'événements des boutons Previous et Next d'une application, qui sont les boutons qui permettent à l'utilisateur de naviguer dans la collection de données. Notez que les propriétés IsCurrentBeforeFirst et IsCurrentAfterLast indiquent si le pointeur d'enregistrement actif est arrivé respectivement au début et à la fin de la liste, afin que MoveCurrentToFirst et MoveCurrentToLast puissent être appelés de manière appropriée.

La propriété CurrentItem de la vue est castée en un Order afin de retourner l'élément d'ordre actif dans la collection.

//OnButton is called whenever the Next or Previous buttons
//are clicked to change the currency
  private void OnButton(Object sender, RoutedEventArgs args)
  {
      Button b = sender as Button;

      switch (b.Name)
      {
          case "Previous":
              myCollectionView.MoveCurrentToPrevious();

              if (myCollectionView.IsCurrentBeforeFirst)
              {
                  myCollectionView.MoveCurrentToLast();
              }
              break;

          case "Next":
              myCollectionView.MoveCurrentToNext();
              if (myCollectionView.IsCurrentAfterLast)
              {
                  myCollectionView.MoveCurrentToFirst();
              }
              break;

          o = myCollectionView.CurrentItem as Order;
          // TODO: do something with the current Order o 
      }
  }

.NET Framework

.NET Framework Client Profile

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Référence

Autres ressources