JournalEntry Classe

Definizione

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

Ereditarietà

Object

DispatcherObject

DependencyObject

JournalEntry

Attributi

SerializableAttribute

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

Campi

Proprietà

Proprietà associate

Metodi

Si applica a