IProvideCustomContentState Interface
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Implementado por uma classe que precisa de adicionar um estado personalizado à entrada do histórico de navegação do conteúdo antes de o conteúdo ser navegado para longe.
public interface class IProvideCustomContentStatepublic interface IProvideCustomContentStatetype IProvideCustomContentState = interfacePublic Interface IProvideCustomContentStateObservações
IProvideCustomContentState Permite associar um pedaço de estado personalizado, implementado como uma classe personalizada CustomContentState , à entrada do histórico de navegação para conteúdo que foi navegado para fora.
O estado personalizado também pode ser associado desta forma, utilizando o seguinte:
Chamar AddBackEntry:
Definição NavigatingCancelEventArgs.Content quando um dos seguintes eventos é levantado:
Deve implementar IProvideCustomContentState quando adiciona um estado personalizado ao histórico de navegação, chamando o AddBackEntry, caso contrário o histórico de navegação não funcionará corretamente; considere os seguintes passos:
O AddBackEntry é chamado para associar um estado personalizado ao conteúdo atual.
A entrada do histórico de navegação é navegada de volta, e o Replay método do estado personalizado é chamado, e o estado é aplicado ao conteúdo.
O conteúdo anterior é acedido no histórico de navegação para a frente.
A entrada do histórico de navegação é navegada para trás, mas o estado personalizado não foi mantido desde a última vez que a entrada do histórico de navegação a que estava associada foi navegada.
Este é o comportamento padrão porque o estado inicialmente registado no estado personalizado pode mudar depois de ser adicionado ao histórico de navegação. Se o objeto de estado personalizado for navegado de volta e o seu estado for aplicado, antes de algum aspeto do estado mudar antes de a entrada no histórico de navegação ser explorada, a alteração de estado não pode ser refletida no objeto de estado personalizado. Além disso, AddBackEntry não pode ser explicitamente chamado para adicionar um novo objeto de estado personalizado que reflita as alterações de estado. Consequentemente, para garantir que o estado atual de uma determinada navegação está sempre guardado no histórico de navegação, GetContentState chama-se.
Importante
Quando armazena informação num estado de conteúdo personalizado, não pode guardar quaisquer referências à instância da página para a qual se está a lembrar do estado. Isto impede que o WPF liberte a instância da página e anula o propósito do comportamento padrão do histórico de navegação. Se precisar de fazer isto, pode considerar usar KeepAlive em vez disso.
Métodos
| Name | Description |
|---|---|
| GetContentState() |
Devolve uma instância de uma classe de estado personalizada que deve ser associada ao conteúdo no histórico de navegação. |