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

Definizione

Ottiene l'elemento corrente della visualizzazione.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

Valore della proprietà

Elemento corrente della visualizzazione.The current item of the view. Per impostazione predefinita, il primo elemento della raccolta inizia come elemento corrente.By default, the first item of the collection starts as the current item.

Implementazioni

Commenti

Le visualizzazioni di raccolta supportano il concetto di un puntatore al record corrente.Collection views support the concept of a current record pointer. Durante lo spostamento tra gli oggetti in una visualizzazione di raccolta, si sta spostando un puntatore di record che consente di recuperare l'oggetto esistente in un percorso specifico nella raccolta.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.

Si noti che spostando il puntatore di record corrente ha alcune interazioni con l'ordinamento o filtro che viene applicato all'insieme.Note that moving the current record pointer has some interactions with any sorting or filtering that is applied to the collection. L'ordinamento mantiene il puntatore di record corrente sull'ultimo record selezionato, ma la visualizzazione di raccolta viene ristrutturata.Sorting preserves the current record pointer on the last record selected, but the collection view is restructured around it. (Forse è stato il record selezionato all'inizio dell'elenco, ma ora il record selezionato potrebbe essere in una posizione al centro). Il filtro mantiene il record selezionato se la selezione rimane nella visualizzazione dopo il filtro.(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. In caso contrario, puntatore al record corrente è impostato per il primo record della vista raccolta filtrata.Otherwise, the current record pointer is set to the first record of the filtered collection view.

L'elemento della raccolta corrente viene associato automaticamente se la destinazione di un'associazione è un valore singleton.The current item of the collection is bound to automatically if the target of a binding is a singleton value. Se la destinazione è un ItemsControl, l'elemento corrente è sincronizzato con l'elemento selezionato.If the target is an ItemsControl, the current item is synchronized with the selected item. Se, ad esempio, una casella di riepilogo è associata a una raccolta, il CurrentItem è sincronizzato con l'elemento attualmente selezionato.For example, if a list box is bound to a collection, the CurrentItem is synchronized with the currently selected item.

Note per gli eredi

Solo le classi che passano che valuta la gestione delle chiamate a un altro interni CollectionView oggetto deve eseguire l'override di questa proprietà; tutte le altre classi derivate devono utilizzare il SetCurrent(Object, Int32) metodo per aggiornare i valori correnti archiviati nella classe di 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.

Si applica a