JournalEntry Classe

Definição

Namespace:

System.Windows.Navigation

Assembly:

PresentationFramework.dll

Representa uma entrada no histórico de navegação, para frente ou para trás.

public ref class JournalEntry : System::Windows::DependencyObject, System::Runtime::Serialization::ISerializable

public class JournalEntry : System.Windows.DependencyObject, System.Runtime.Serialization.ISerializable

type JournalEntry = class
    inherit DependencyObject
    interface ISerializable

Public Class JournalEntry
Inherits DependencyObject
Implements ISerializable

Herança

Object

DispatcherObject

DependencyObject

JournalEntry

Implementações

ISerializable

Exemplos

O exemplo a seguir mostra como recuperar o objeto mais recente JournalEntry da pilha de navegação traseira para obter os valores da Name propriedade e Source .

void removeJournalEntryButton_Click(object sender, RoutedEventArgs e)
{
    // If there are journal entries on the back navigation stack
    if (this.NavigationService.CanGoBack)
    {
        // Remove and get the most recent entry on the back navigation stack
        JournalEntry journalEntry = this.NavigationService.RemoveBackEntry();

        string name = journalEntry.Name;
        string uri = journalEntry.Source.OriginalString;
        MessageBox.Show(name + " [" + uri + "] removed from back navigation.");
    }
}

Private Sub removeJournalEntryButton_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
    ' If there are journal entries on the back navigation stack
    If Me.NavigationService.CanGoBack Then
        ' Remove and get the most recent entry on the back navigation stack
        Dim journalEntry As JournalEntry = Me.NavigationService.RemoveBackEntry()

        Dim name As String = journalEntry.Name
        Dim uri As String = journalEntry.Source.OriginalString
        MessageBox.Show(name & " [" & uri & "] removed from back navigation.")
    End If
End Sub

Comentários

Windows Presentation Foundation implementa um serviço de histórico de navegação que armazena uma entrada para cada parte do conteúdo que foi navegada anteriormente, assim como o histórico de navegação em um navegador. O histórico de navegação é composto por duas pilhas, uma que lembra o histórico de navegação posterior e outra que se lembra do histórico de navegação para frente.

Uma entrada para o item atual é adicionada ao histórico de navegação posterior quando ocorre uma navegação para frente. Isso ocorre nas seguintes situações:

• O Navigate método é chamado (NavigationService.Navigate, NavigationWindow.Navigate, Frame.Navigate).

• O GoForward método é chamado (NavigationService.GoForward, NavigationWindow.GoForward, Frame.GoForward).

• O botão avançar na interface do usuário de navegação exibido do navegador atual (XBAP, NavigationWindow, Frame).

Da mesma forma, uma entrada para o item atual é adicionada ao histórico de navegação de encaminhamento antes que ocorra uma navegação posterior, o que acontece quando:

• O GoBack método é chamado (NavigationService.GoBack, NavigationWindow.GoBack, Frame.GoBack).

• O botão Voltar na interface do usuário de navegação exibido do navegador atual (XBAP, NavigationWindow, Frame).

Cada entrada no histórico de navegação para trás e para frente é uma instância da JournalEntry classe .

Cada JournalEntry objeto encapsula informações sobre uma navegação específica, incluindo um nome para a entrada (Name), se a entrada é mantida ativa (KeepAlive) e o URI (uniform resource identifier) para o conteúdo que é navegado para (Source).

Você pode recuperar todos os JournalEntry objetos no histórico de navegação posterior enumerando as NavigationWindow.BackStack propriedades ou Frame.BackStack . Para o histórico de navegação de avanço, você pode recuperar todos os JournalEntry objetos enumerando as NavigationWindow.ForwardStack propriedades ou Frame.ForwardStack .

Se você precisar remover o objeto mais recente JournalEntry do histórico de navegação posterior, para impedir a navegação para ele, por exemplo, você poderá chamar o RemoveBackEntry método (NavigationService.RemoveBackEntry, NavigationWindow.RemoveBackEntry, Frame.RemoveBackEntry), que remove o JournalEntry objeto e retorna uma referência a ele.

No entanto, não é possível adicionar JournalEntry objetos ao histórico de navegação porque você não pode criar uma instância nem derivar de JournalEntrye porque nenhum tipo implementa um membro para fazer isso. No entanto, você pode adicionar objetos personalizados CustomContentState ao histórico de navegação de volta chamando o AddBackEntry método (AddBackEntry, AddBackEntry, AddBackEntry); NavigationService adiciona o CustomContentState objeto a um objeto criado JournalEntry internamente, que é adicionado ao histórico de navegação posterior.

Construtores

JournalEntry(SerializationInfo, StreamingContext)

Inicializa uma nova instância da classe JournalEntry.

Campos

KeepAliveProperty	Identifica a propriedade KeepAlive anexada.
NameProperty	Identifica a propriedade Name anexada.

Propriedades

CustomContentState	Obtém ou define o objeto CustomContentState que é associado com essa entrada de diário.
DependencyObjectType	Obtém o DependencyObjectType que encapsula o tipo CLR dessa instância. (Herdado de DependencyObject)
Dispatcher	Obtém o Dispatcher ao qual este DispatcherObject está associado. (Herdado de DispatcherObject)
IsSealed	Obtém um valor que indica se essa instância está validada no momento (somente leitura). (Herdado de DependencyObject)
Name	Obtém ou define o nome da entrada de diário.
Source	Obtém ou define o URI do conteúdo para o qual foi navegado.

Propriedades Anexadas

KeepAlive

Obtém ou define um valor que indica se o conteúdo de uma entrada de diário é mantido ou recriado quando acessado no histórico de navegação.

Métodos

CheckAccess()	Determina se o thread de chamada tem acesso a este DispatcherObject. (Herdado de DispatcherObject)
ClearValue(DependencyProperty)	Limpa o valor local de uma propriedade. A propriedade a ser limpa é especificada por um identificador DependencyProperty. (Herdado de DependencyObject)
ClearValue(DependencyPropertyKey)	Limpa o valor local de uma propriedade somente leitura. A propriedade a ser limpa é especificada por um DependencyPropertyKey. (Herdado de DependencyObject)
CoerceValue(DependencyProperty)	Converte o valor da propriedade de dependência especificada. Isso é feito invocando qualquer função CoerceValueCallback especificada nos metadados de propriedade para a propriedade de dependência, visto que ela existe na chamada a DependencyObject. (Herdado de DependencyObject)
Equals(Object)	Determina se um DependencyObject fornecido é equivalente ao DependencyObject atual. (Herdado de DependencyObject)
GetHashCode()	Obtém o código hash para esse DependencyObject. (Herdado de DependencyObject)
GetKeepAlive(DependencyObject)	Retorna a propriedade anexada KeepAlive da entrada de diário para o elemento especificado.
GetLocalValueEnumerator()	Cria um enumerador especializado para determinar quais propriedades de dependência têm valores definidos localmente nessa DependencyObject. (Herdado de DependencyObject)
GetName(DependencyObject)	Obtém a propriedade anexada Name da entrada de diário para o elemento especificado.
GetObjectData(SerializationInfo, StreamingContext)	Chamado quando este objeto é serializado.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
GetValue(DependencyProperty)	Retorna o valor efetivo atual de uma propriedade de dependência nessa instância de um DependencyObject. (Herdado de DependencyObject)
InvalidateProperty(DependencyProperty)	Reavalia o valor efetivo para a propriedade de dependência especificada. (Herdado de DependencyObject)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Invocado sempre que o valor efetivo de qualquer propriedade de dependência nesse DependencyObject for atualizado. A propriedade de dependência específica que mudou é relatada os dados do evento. (Herdado de DependencyObject)
ReadLocalValue(DependencyProperty)	Retorna o valor local de uma propriedade de dependência, local, se houver. (Herdado de DependencyObject)
SetCurrentValue(DependencyProperty, Object)	Define o valor da propriedade de dependência sem alterar a origem do valor. (Herdado de DependencyObject)
SetKeepAlive(DependencyObject, Boolean)	Define a propriedade anexada KeepAlive do elemento especificado.
SetName(DependencyObject, String)	Define a propriedade anexada Name do elemento especificado.
SetValue(DependencyProperty, Object)	Define o valor local de uma propriedade de dependência, especificada pelo identificador da propriedade de dependência. (Herdado de DependencyObject)
SetValue(DependencyPropertyKey, Object)	Define o valor de uma propriedade de dependência somente leitura, especificada pelo identificador DependencyPropertyKey da propriedade de dependência. (Herdado de DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Retorna um valor que indica se os processos de serialização devem serializar o valor da propriedade de dependência fornecida. (Herdado de DependencyObject)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
VerifyAccess()	Impõe que o thread de chamada tenha acesso a este DispatcherObject. (Herdado de DispatcherObject)