JournalEntry Classe

Referência

Definição

Namespace:: System.Windows.Navigation

Assembly:: PresentationFramework.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

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

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

[<System.Serializable>]
type JournalEntry = class
    inherit DependencyObject
    interface ISerializable

type JournalEntry = class
    inherit DependencyObject
    interface ISerializable

Public Class JournalEntry
Inherits DependencyObject
Implements ISerializable

Herança: Object

DispatcherObject

DependencyObject
JournalEntry

Atributos: SerializableAttribute

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 e Source a Name propriedade.

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 conteúdo que já foi navegado anteriormente, assim como o histórico de navegação no Microsoft Internet Explorer. O histórico de navegação é composto por duas pilhas, uma que lembra o histórico de navegação e outra que se lembra do histórico de navegação para a frente.

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

O Navigate método é chamado (NavigationService.Navigate, , Frame.Navigate NavigationWindow.Navigate).
O GoForward método é chamado (NavigationService.GoForward, , Frame.GoForward NavigationWindow.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 uma navegação invertda ocorra, o que acontece quando:

O GoBack método é chamado (NavigationService.GoBack, , Frame.GoBack NavigationWindow.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 viva (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 propriedades ou Frame.BackStack as NavigationWindow.BackStack propriedades. Para histórico de navegação avançada, você pode recuperar todos os JournalEntry objetos enumerando as propriedades ou Frame.ForwardStack as NavigationWindow.ForwardStack propriedades.

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

No entanto, não é possível adicionar JournalEntry objetos ao histórico de JournalEntrynavegação, pois não é possível instanciar nem derivar e porque nenhum tipo implementa um membro para fazer isso. No entanto, você pode adicionar objetos personalizados CustomContentState para apoiar o histórico de navegação 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)

Aplica-se a