CollectionView.CurrentItem Propriedade

Definição

Namespace:

System.Windows.Data

Assembly:

PresentationFramework.dll

Obtém o item atual na exibição.

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

Valor da propriedade

Object

O item atual da exibição. Por padrão, o primeiro item da coleção é iniciado como o item atual.

Implementações

CurrentItem

Comentários

As exibições de coleção dão suporte ao conceito de um ponteiro de registro atual. Ao navegar pelos objetos em uma exibição de coleção, você está movendo um ponteiro de registro que permite recuperar o objeto que existe naquele local específico da coleção.

Observe que mover o ponteiro de registro atual tem algumas interações com qualquer classificação ou filtragem aplicada à coleção. A classificação preserva o ponteiro de registro atual no último registro selecionado, mas o modo de exibição de coleção é reestruturado em torno dele. (Talvez o registro selecionado estivesse no início da lista anteriormente, mas agora o registro selecionado pode estar em algum lugar no meio.) A filtragem preservará o registro selecionado se essa seleção permanecer em exibição após a filtragem. Caso contrário, o ponteiro de registro atual será definido como o primeiro registro da exibição de coleção filtrada.

O item atual da coleção será associado automaticamente se o destino de uma associação for um valor singleton. Se o destino for um ItemsControl, o item atual será sincronizado com o item selecionado. Por exemplo, se uma caixa de listagem estiver associada a uma coleção, ela CurrentItem será sincronizada com o item selecionado no momento.

Notas aos Herdeiros

Somente classes que passam chamadas de tratamento de moeda para outro objeto interno CollectionView devem substituir essa propriedade; todas as outras classes derivadas devem usar o SetCurrent(Object, Int32) método para atualizar os valores atuais armazenados na classe base.