JournalEntry Clase

Definición

Espacio de nombres:

System.Windows.Navigation

Ensamblado:

PresentationFramework.dll

Representa una entrada del historial de retroceso o de avance de navegación.

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

Herencia

Object

DispatcherObject

DependencyObject

JournalEntry

Implementaciones

ISerializable

Ejemplos

En el ejemplo siguiente se muestra cómo recuperar el objeto más reciente JournalEntry de la pila de navegación inversa para obtener los valores de propiedad Name y 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

Comentarios

Windows Presentation Foundation implementa un servicio de historial de navegación que almacena una entrada para cada elemento de contenido al que se ha navegado anteriormente, al igual que el historial de navegación en un explorador. El historial de navegación consta de dos pilas, una que recuerda el historial de navegación hacia atrás y otra que recuerda el historial de navegación hacia delante.

Cuando se produce una navegación hacia delante, se agrega una entrada para el elemento actual al historial de navegación posterior. Esto ocurre en las situaciones siguientes:

• Se Navigate llama al método (NavigationService.Navigate, NavigationWindow.Navigate, Frame.Navigate).

• Se GoForward llama al método (NavigationService.GoForward, NavigationWindow.GoForward, Frame.GoForward).

• Botón hacia delante de la interfaz de usuario de navegación que se muestra desde el navegador actual (XBAP, NavigationWindow, Frame).

Del mismo modo, se agrega una entrada para el elemento actual para reenviar el historial de navegación antes de que se produzca una navegación inversa, lo que sucede cuando:

• Se GoBack llama al método (NavigationService.GoBack, NavigationWindow.GoBack, Frame.GoBack).

• Botón Atrás de la interfaz de usuario de navegación que se muestra desde el navegador actual (XBAP, NavigationWindow, Frame).

Cada entrada del historial de navegación hacia atrás y hacia delante es una instancia de la JournalEntry clase .

Cada JournalEntry objeto encapsula información sobre una navegación determinada, incluido un nombre para la entrada (Name), si la entrada se mantiene activa (KeepAlive) y el identificador uniforme de recursos (URI) para el contenido al que se navega (Source).

Puede recuperar todos los JournalEntry objetos del historial de navegación posterior mediante la enumeración de las NavigationWindow.BackStack propiedades o Frame.BackStack . Para el historial de navegación hacia delante, puede recuperar todos los objetos mediante la JournalEntry enumeración de las NavigationWindow.ForwardStack propiedades o Frame.ForwardStack .

Si necesita quitar el objeto más reciente JournalEntry del historial de navegación atrás, para evitar la navegación a él, por ejemplo, puede llamar al RemoveBackEntry método (NavigationService.RemoveBackEntry, NavigationWindow.RemoveBackEntry, Frame.RemoveBackEntry), que quita el JournalEntry objeto y devuelve una referencia a él.

Sin embargo, no se pueden agregar JournalEntry objetos al historial de navegación, ya que no se pueden crear instancias ni derivar de JournalEntry, y porque ningún tipo implementa un miembro para hacerlo. Sin embargo, puede agregar objetos personalizados CustomContentState al historial de navegación posterior llamando al AddBackEntry método (AddBackEntry, AddBackEntry, AddBackEntry); NavigationService agrega el CustomContentState objeto a un objeto creado JournalEntry internamente, que luego se agrega al historial de navegación posterior.

Constructores

JournalEntry(SerializationInfo, StreamingContext)

Inicializa una nueva instancia de la clase JournalEntry.

Campos

KeepAliveProperty	Identifica la propiedad adjunta KeepAlive.
NameProperty	Identifica la propiedad adjunta Name.

Propiedades

CustomContentState	Obtiene o establece el objeto CustomContentState asociado a esta entrada del diario.
DependencyObjectType	Obtiene el DependencyObjectType objeto que encapsula el tipo CLR de esta instancia. (Heredado de DependencyObject)
Dispatcher	Obtiene el objeto Dispatcher al que está asociado DispatcherObject. (Heredado de DispatcherObject)
IsSealed	Obtiene un valor que indica si esta instancia está actualmente sellada (es de solo lectura). (Heredado de DependencyObject)
Name	Obtiene o establece el nombre de la entrada del diario.
Source	Obtiene o establece el URI del contenido al que se navegó.

Propiedades adjuntas

KeepAlive

Obtiene o establece un valor que indica si el contenido de una entrada del diario se retiene o se vuelve a crear cuando se ha navegado por el historial de navegación.

Métodos

CheckAccess()	Determina si el subproceso de la llamada tiene acceso a DispatcherObject. (Heredado de DispatcherObject)
ClearValue(DependencyProperty)	Borra el valor local de una propiedad. La propiedad que se va a borrar se especifica mediante un identificador DependencyProperty. (Heredado de DependencyObject)
ClearValue(DependencyPropertyKey)	Borra el valor local de una propiedad de solo lectura. La propiedad que se va a borrar se especifica mediante un DependencyPropertyKey. (Heredado de DependencyObject)
CoerceValue(DependencyProperty)	Convierte el valor de la propiedad de dependencia especificada. Esto se logra invocando cualquier función CoerceValueCallback especificada en los metadatos de la propiedad de dependencia tal como existe en la clase DependencyObject que llama. (Heredado de DependencyObject)
Equals(Object)	Determina si un objeto DependencyObject proporcionado es equivalente al objeto DependencyObject actual. (Heredado de DependencyObject)
GetHashCode()	Obtiene un código hash de este objeto DependencyObject. (Heredado de DependencyObject)
GetKeepAlive(DependencyObject)	Devuelve la propiedad adjunta KeepAlive de la entrada de diario para el elemento especificado.
GetLocalValueEnumerator()	Crea un enumerador especializado para determinar qué propiedades de dependencia han establecido localmente los valores en DependencyObject. (Heredado de DependencyObject)
GetName(DependencyObject)	Obtiene la propiedad adjunta Name de la entrada de diario para el elemento especificado.
GetObjectData(SerializationInfo, StreamingContext)	Llamado cuando se serializa este objeto.
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
GetValue(DependencyProperty)	Devuelve el valor efectivo actual de una propiedad de dependencia en esta instancia de un DependencyObject. (Heredado de DependencyObject)
InvalidateProperty(DependencyProperty)	Vuelve a evaluar el valor efectivo para la propiedad de dependencia especificada. (Heredado de DependencyObject)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Se invoca cuando se actualiza el valor efectivo de alguna propiedad de dependencia en este DependencyObject. La propiedad de dependencia específica que cambió se notifica en los datos de evento. (Heredado de DependencyObject)
ReadLocalValue(DependencyProperty)	Devuelve el valor local de una propiedad de dependencia, si existe. (Heredado de DependencyObject)
SetCurrentValue(DependencyProperty, Object)	Establece el valor de una propiedad de dependencia sin cambiar el origen del valor. (Heredado de DependencyObject)
SetKeepAlive(DependencyObject, Boolean)	Establece el valor de la propiedad adjunta KeepAlive del elemento especificado.
SetName(DependencyObject, String)	Establece el valor de la propiedad adjunta Name del elemento especificado.
SetValue(DependencyProperty, Object)	Establece el valor local de una propiedad de dependencia, especificado mediante el identificador de la propiedad de dependencia. (Heredado de DependencyObject)
SetValue(DependencyPropertyKey, Object)	Establece el valor local de una propiedad de dependencia de solo lectura, especificado por el identificador DependencyPropertyKey de la propiedad de dependencia. (Heredado de DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Devuelve un valor que indica si los procesos de serialización deben serializar el valor de la propiedad de dependencia especificada. (Heredado de DependencyObject)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
VerifyAccess()	Exige que el subproceso de la llamada tenga acceso a DispatcherObject. (Heredado de DispatcherObject)