JournalEntry Classe

Definizione

Spazio dei nomi:

System.Windows.Navigation

Assembly:

PresentationFramework.dll

Rappresenta una voce della cronologia di navigazione in avanti o indietro.

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

Ereditarietà

Object

DispatcherObject

DependencyObject

JournalEntry

Implementazioni

ISerializable

Esempio

Nell'esempio seguente viene illustrato come recuperare l'oggetto più recente JournalEntry dallo stack di spostamento indietro per ottenere i valori delle Name proprietà 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

Commenti

Windows Presentation Foundation implementa un servizio cronologia navigazione che archivia una voce per ogni parte di contenuto a cui è stato eseguito lo spostamento in precedenza, proprio come la cronologia di navigazione in un browser. La cronologia di spostamento comprende due stack, uno che ricorda la cronologia di spostamento indietro e uno che ricorda la cronologia di spostamento in avanti.

Una voce per l'elemento corrente viene aggiunta alla cronologia di navigazione indietro quando si verifica uno spostamento in avanti. Ciò si verifica nelle situazioni seguenti:

• Il Navigate metodo viene chiamato (NavigationService.Navigate, NavigationWindow.Navigate, Frame.Navigate).

• Il GoForward metodo viene chiamato (NavigationService.GoForward, NavigationWindow.GoForward, Frame.GoForward).

• Pulsante avanti nell'interfaccia utente di navigazione visualizzata dallo strumento di navigazione corrente (XBAP, NavigationWindow, Frame).

Analogamente, viene aggiunta una voce per l'elemento corrente per inoltrare la cronologia di navigazione prima che si verifichi uno spostamento indietro, che si verifica quando:

• Il GoBack metodo viene chiamato (NavigationService.GoBack, NavigationWindow.GoBack, Frame.GoBack).

• Pulsante Indietro nell'interfaccia utente di navigazione visualizzata dallo strumento di navigazione corrente (XBAP, NavigationWindow, Frame).

Ogni voce nella cronologia di spostamento indietro e in avanti è un'istanza della JournalEntry classe .

Ogni JournalEntry oggetto incapsula informazioni su una navigazione specifica, incluso un nome per la voce (Name), se la voce viene mantenuta attiva (KeepAlive) e l'URI (Uniform Resource Identifier) per il contenuto a cui si accede (Source).

È possibile recuperare tutti gli JournalEntry oggetti nella cronologia di spostamento indietro enumerando le NavigationWindow.BackStack proprietà o Frame.BackStack . Per la cronologia di spostamento in avanti, è possibile recuperare tutti gli JournalEntry oggetti enumerando le NavigationWindow.ForwardStack proprietà o Frame.ForwardStack .

Se è necessario rimuovere l'oggetto più recente JournalEntry dalla cronologia di spostamento indietro, per impedire lo spostamento, ad esempio, è possibile chiamare il RemoveBackEntry metodo (NavigationService.RemoveBackEntry, NavigationWindow.RemoveBackEntry, Frame.RemoveBackEntry), che rimuove l'oggetto JournalEntry e restituisce un riferimento.

Non è possibile aggiungere JournalEntry oggetti alla cronologia di navigazione, tuttavia, perché non è possibile creare un'istanza né derivare da JournalEntrye perché nessun tipo implementa un membro a tale scopo. È tuttavia possibile aggiungere oggetti personalizzati CustomContentState alla cronologia di navigazione indietro chiamando il AddBackEntry metodo (AddBackEntry, AddBackEntry, AddBackEntry); NavigationService aggiunge l'oggetto CustomContentState a un oggetto creato JournalEntry internamente, che viene quindi aggiunto alla cronologia di spostamento indietro.

Costruttori

JournalEntry(SerializationInfo, StreamingContext)

Inizializza una nuova istanza della classe JournalEntry.

Campi

KeepAliveProperty	Identifica la proprietà associata KeepAlive.
NameProperty	Identifica la proprietà associata Name.

Proprietà

CustomContentState	Ottiene o imposta l'oggetto CustomContentState associato alla voce del journal corrente.
DependencyObjectType	Ottiene l'oggetto DependencyObjectType che esegue il wrapping del tipo CLR di questa istanza. (Ereditato da DependencyObject)
Dispatcher	Ottiene l'oggetto Dispatcher associato a DispatcherObject. (Ereditato da DispatcherObject)
IsSealed	Ottiene un valore che indica se l'istanza è attualmente sealed (di sola lettura). (Ereditato da DependencyObject)
Name	Ottiene o imposta il nome della voce del journal.
Source	Ottiene o imposta l'URI del contenuto sul quale ci si è spostati.

Proprietà associate

KeepAlive

Ottiene o imposta un valore che indica se il contenuto di una voce del journal viene mantenuto o ricreato quando vi ci accede dalla cronologia di navigazione.

Metodi

CheckAccess()	Determina se il thread chiamante ha accesso a DispatcherObject. (Ereditato da DispatcherObject)
ClearValue(DependencyProperty)	Cancella il valore locale di una proprietà. La proprietà da cancellare è specificata da un identificatore DependencyProperty. (Ereditato da DependencyObject)
ClearValue(DependencyPropertyKey)	Cancella il valore locale di una proprietà di sola lettura. La proprietà da cancellare è specificata da un oggetto DependencyPropertyKey. (Ereditato da DependencyObject)
CoerceValue(DependencyProperty)	Assegna forzatamente il valore della proprietà di dipendenza specificata. Questa operazione viene eseguita richiamando qualsiasi funzione CoerceValueCallback specificata nei metadati della proprietà di dipendenza esistente nell'oggetto DependencyObject chiamante. (Ereditato da DependencyObject)
Equals(Object)	Determina se l'oggetto DependencyObject specificato equivale all'oggetto DependencyObject corrente. (Ereditato da DependencyObject)
GetHashCode()	Ottiene un codice hash per l'oggetto DependencyObject. (Ereditato da DependencyObject)
GetKeepAlive(DependencyObject)	Restituisce la proprietà associata KeepAlive della voce diario per l'elemento specificato.
GetLocalValueEnumerator()	Crea un enumeratore specializzato per determinare le proprietà di dipendenza che presentano valori impostati localmente nell'oggetto DependencyObject. (Ereditato da DependencyObject)
GetName(DependencyObject)	Ottiene la proprietà associata Name della voce diario per l'elemento specificato.
GetObjectData(SerializationInfo, StreamingContext)	Viene chiamato quando questo oggetto viene serializzato.
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
GetValue(DependencyProperty)	Restituisce il valore effettivo corrente di una proprietà di dipendenza in questa istanza di DependencyObject. (Ereditato da DependencyObject)
InvalidateProperty(DependencyProperty)	Valuta di nuovo il valore effettivo della proprietà di dipendenza specificata. (Ereditato da DependencyObject)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Richiamato ogni volta che viene aggiornato il valore effettivo di qualsiasi proprietà di dipendenza in DependencyObject. La proprietà di dipendenza specifica modificata viene indicata nei dati dell'evento. (Ereditato da DependencyObject)
ReadLocalValue(DependencyProperty)	Restituisce il valore locale di una proprietà di dipendenza, se esistente. (Ereditato da DependencyObject)
SetCurrentValue(DependencyProperty, Object)	Imposta il valore di una proprietà di dipendenza senza modificare l'origine del valore. (Ereditato da DependencyObject)
SetKeepAlive(DependencyObject, Boolean)	Imposta la proprietà associata KeepAlive dell'elemento specificato.
SetName(DependencyObject, String)	Imposta la proprietà associata Name dell'elemento specificato.
SetValue(DependencyProperty, Object)	Imposta il valore locale di una proprietà di dipendenza, specificato dal relativo identificatore della proprietà di dipendenza. (Ereditato da DependencyObject)
SetValue(DependencyPropertyKey, Object)	Imposta il valore locale di una proprietà di dipendenza di sola lettura, specificato dall'identificatore DependencyPropertyKey della proprietà di dipendenza. (Ereditato da DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Restituisce un valore che indica se i processi di serializzazione devono serializzare il valore della proprietà di dipendenza specificata. (Ereditato da DependencyObject)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
VerifyAccess()	Impone che il thread chiamante abbia accesso a DispatcherObject. (Ereditato da DispatcherObject)