JournalEntry Classe

Définition

Espace de noms:

System.Windows.Navigation

Assembly:

PresentationFramework.dll

Représente une entrée dans l’historique de navigation précédent ou avant.

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

Héritage

Object

DispatcherObject

DependencyObject

JournalEntry

Implémente

ISerializable

Exemples

L’exemple suivant montre comment récupérer l’objet le plus récent JournalEntry de la pile de navigation arrière pour obtenir les valeurs des propriétés et Source des Name valeurs.

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

Remarques

Windows Presentation Foundation implémente un service d’historique de navigation qui stocke une entrée pour chaque élément de contenu qui a été précédemment accédé, tout comme l’historique de navigation dans un navigateur. L’historique de navigation comprend deux piles, une qui mémorise l’historique de navigation arrière et l’autre qui se souvient de l’historique de navigation avant.

Une entrée pour l’élément actif est ajoutée à l’historique de navigation arrière lorsqu’une navigation vers l’avant se produit. Cela se produit dans les situations suivantes :

• La Navigate méthode est appelée (NavigationService.Navigate, NavigationWindow.Navigate, Frame.Navigate).

• La GoForward méthode est appelée (NavigationService.GoForward, NavigationWindow.GoForward, Frame.GoForward).

• Bouton transférer de l’interface utilisateur de navigation affichée à partir du navigateur actuel (XBAP, NavigationWindow, Frame).

De même, une entrée de l’élément actif est ajoutée à l’historique de navigation avant qu’une navigation arrière ne se produise, ce qui se produit lorsque :

• La GoBack méthode est appelée (NavigationService.GoBack, NavigationWindow.GoBack, Frame.GoBack).

• Bouton Précédent de l’interface utilisateur de navigation affichée à partir du navigateur actuel (XBAP, NavigationWindow, Frame).

Chaque entrée dans l’historique de navigation arrière et avant est une instance de la JournalEntry classe.

Chaque JournalEntry objet encapsule des informations sur une navigation particulière, y compris un nom pour l’entrée (Name), si l’entrée est conservée active (KeepAlive) et l’URI (Uniform Resource Identifier) pour le contenu qui est accédé à (Source).

Vous pouvez récupérer tous les objets dans l’historique JournalEntry de navigation arrière en énumérant les propriétés ou Frame.BackStack les NavigationWindow.BackStack propriétés. Pour l’historique de navigation avant, vous pouvez récupérer tous les JournalEntry objets en énumérant les propriétés ou Frame.ForwardStack les NavigationWindow.ForwardStack propriétés.

Si vous devez supprimer l’objet le plus récent JournalEntry de l’historique de navigation arrière, pour empêcher la navigation vers celui-ci, par exemple, vous pouvez appeler la RemoveBackEntry méthode (NavigationService.RemoveBackEntry, , NavigationWindow.RemoveBackEntry), Frame.RemoveBackEntryqui supprime l’objet JournalEntry et retourne une référence à celui-ci.

Toutefois, vous ne pouvez pas ajouter JournalEntry d’objets à l’historique de navigation, car vous ne pouvez ni instancier ni dériver de JournalEntry, et parce qu’aucun type n’implémente un membre pour le faire. Toutefois, vous pouvez ajouter des objets personnalisés CustomContentState à l’historique de navigation de retour en appelant la AddBackEntry méthode (AddBackEntry, AddBackEntry, AddBackEntry) ; NavigationService ajoute l’objet CustomContentState à un objet créé JournalEntry en interne, qui est ensuite ajouté à l’historique de navigation arrière.

Constructeurs

Nom	Description
JournalEntry(SerializationInfo, StreamingContext)	Initialise une nouvelle instance de la classe JournalEntry.

Champs

Nom	Description
KeepAliveProperty	Identifie la KeepAlive propriété jointe.
NameProperty	Identifie la Name propriété jointe.

Propriétés

Nom	Description
CustomContentState	Obtient ou définit l’objet CustomContentState associé à cette entrée de journal.
DependencyObjectType	Obtient le DependencyObjectType type CLR de cette instance. (Hérité de DependencyObject)
Dispatcher	Obtient ce Dispatcher qui DispatcherObject est associé. (Hérité de DispatcherObject)
IsSealed	Obtient une valeur qui indique si cette instance est actuellement scellée (en lecture seule). (Hérité de DependencyObject)
Name	Obtient ou définit le nom de l’entrée de journal.
Source	Obtient ou définit l’URI du contenu qui a été accédé.

Propriétés attachées

Nom	Description
KeepAlive	Obtient ou définit une valeur qui indique si le contenu d’une entrée de journal est conservé ou recréé lors de la navigation dans l’historique de navigation.

Méthodes

Nom	Description
CheckAccess()	Détermine si le thread appelant a accès à ce DispatcherObjectfichier . (Hérité de DispatcherObject)
ClearValue(DependencyProperty)	Efface la valeur locale d’une propriété. La propriété à effacer est spécifiée par un DependencyProperty identificateur. (Hérité de DependencyObject)
ClearValue(DependencyPropertyKey)	Efface la valeur locale d’une propriété en lecture seule. La propriété à effacer est spécifiée par un DependencyPropertyKey. (Hérité de DependencyObject)
CoerceValue(DependencyProperty)	Force la valeur de la propriété de dépendance spécifiée. Pour ce faire, appelez n’importe quelle CoerceValueCallback fonction spécifiée dans les métadonnées de propriété pour la propriété de dépendance telle qu’elle existe sur l’appel DependencyObject. (Hérité de DependencyObject)
Equals(Object)	Détermine si un élément fourni DependencyObject est équivalent à l’actuel DependencyObject. (Hérité de DependencyObject)
GetHashCode()	Obtient un code de hachage pour ce DependencyObject. (Hérité de DependencyObject)
GetKeepAlive(DependencyObject)	Retourne la KeepAlive propriété jointe de l’entrée de journal pour l’élément spécifié.
GetLocalValueEnumerator()	Crée un énumérateur spécialisé pour déterminer quelles propriétés de dépendance ont des valeurs définies localement sur ce DependencyObject. (Hérité de DependencyObject)
GetName(DependencyObject)	Obtient la Name propriété jointe de l’entrée de journal pour l’élément spécifié.
GetObjectData(SerializationInfo, StreamingContext)	Appelé lorsque cet objet est sérialisé.
GetValue(DependencyProperty)	Retourne la valeur effective actuelle d’une propriété de dépendance sur cette instance d’un DependencyObject. (Hérité de DependencyObject)
InvalidateProperty(DependencyProperty)	Évalue à nouveau la valeur effective de la propriété de dépendance spécifiée. (Hérité de DependencyObject)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Appelé chaque fois que la valeur effective d’une propriété de dépendance sur celle-ci DependencyObject a été mise à jour. La propriété de dépendance spécifique qui a changé est signalée dans les données d’événement. (Hérité de DependencyObject)
ReadLocalValue(DependencyProperty)	Retourne la valeur locale d’une propriété de dépendance, le cas échéant. (Hérité de DependencyObject)
SetCurrentValue(DependencyProperty, Object)	Définit la valeur d’une propriété de dépendance sans modifier sa source de valeur. (Hérité de DependencyObject)
SetKeepAlive(DependencyObject, Boolean)	Définit la KeepAlive propriété jointe de l’élément spécifié.
SetName(DependencyObject, String)	Définit la Name propriété jointe de l’élément spécifié.
SetValue(DependencyProperty, Object)	Définit la valeur locale d’une propriété de dépendance, spécifiée par son identificateur de propriété de dépendance. (Hérité de DependencyObject)
SetValue(DependencyPropertyKey, Object)	Définit la valeur locale d’une propriété de dépendance en lecture seule, spécifiée par l’identificateur DependencyPropertyKey de la propriété de dépendance. (Hérité de DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Retourne une valeur qui indique si les processus de sérialisation doivent sérialiser la valeur de la propriété de dépendance fournie. (Hérité de DependencyObject)
VerifyAccess()	Applique que le thread appelant a accès à ce DispatcherObjectfichier . (Hérité de DispatcherObject)