JournalEntry Třída

Definice

Obor názvů:

System.Windows.Navigation

Sestavení:

PresentationFramework.dll

Představuje položku v historii navigace zpět nebo vpřed.

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

Dědičnost

Object

DispatcherObject

DependencyObject

JournalEntry

Implementuje

ISerializable

Příklady

Následující příklad ukazuje, jak načíst nejnovější JournalEntry objekt z back navigačního zásobníku pro získání Name hodnot a Source vlastností.

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

Poznámky

Windows Presentation Foundation implementuje službu historie navigace, která ukládá jednu položku pro každou část obsahu, která byla dříve přecházena, stejně jako historie navigace v prohlížeči. Historie navigace se skládá ze dvou zásobníků, jedné, která si pamatuje historii navigace zpět, a druhou, která si pamatuje historii navigace dopředu.

Položka pro aktuální položku se přidá do historie navigace zpět, když dojde k přeposlání navigace. K tomu dochází v následujících situacích:

• Metoda Navigate je volána (NavigationService.Navigate, NavigationWindow.Navigate, Frame.Navigate).

• Metoda GoForward je volána (NavigationService.GoForward, NavigationWindow.GoForward, Frame.GoForward).

• Tlačítko vpřed v navigačním uživatelském rozhraní zobrazeném z aktuálního navigátoru (XBAP, NavigationWindow, Frame).

Podobně se přidá položka pro aktuální položku do historie navigace dopředu, než dojde k zpětné navigaci, což se stane v následujících případech:

• Metoda GoBack je volána (NavigationService.GoBack, NavigationWindow.GoBack, Frame.GoBack).

• Tlačítko Zpět v navigačním uživatelském rozhraní zobrazeném z aktuálního navigátoru (XBAP, NavigationWindow, Frame).

Každá položka v historii navigace zpět a vpřed je instance JournalEntry třídy.

Každý JournalEntry objekt zapouzdřuje informace o konkrétní navigaci, včetně názvu položky (Name), zda je položka zachována (KeepAlive) a identifikátor URI (uniform resource identifier) pro obsah, na který se přechází (Source).

Všechny objekty v historii zpětné navigace můžete načíst JournalEntry výčetm nebo Frame.BackStack vlastnostmiNavigationWindow.BackStack. Pro historii navigace vpřed můžete načíst všechny JournalEntry objekty pomocí výčtu NavigationWindow.ForwardStack nebo Frame.ForwardStack vlastností.

Pokud potřebujete odebrat nejnovější JournalEntry objekt z historie navigace zpět, abyste zabránili navigaci, například můžete volat metodu RemoveBackEntry (NavigationService.RemoveBackEntry, NavigationWindow.RemoveBackEntry, Frame.RemoveBackEntry), která odebere JournalEntry objekt a vrátí odkaz na něj.

Objekty nelze přidat do historie navigace, protože nelze vytvořit JournalEntry instanci ani odvodit z JournalEntry, a protože žádný typ implementuje člena. Vlastní objekty však můžete přidat CustomContentState do historie navigace zpět voláním AddBackEntry metody (AddBackEntry, AddBackEntry, AddBackEntry); NavigationService přidá CustomContentState objekt do interně vytvořeného JournalEntry objektu, který se pak přidá do historie zpětné navigace.

Konstruktory

Name	Description
JournalEntry(SerializationInfo, StreamingContext)	Inicializuje novou instanci JournalEntry třídy.

Pole

Name	Description
KeepAliveProperty	Identifikuje připojenou KeepAlive vlastnost.
NameProperty	Identifikuje připojenou Name vlastnost.

Vlastnosti

Name	Description
CustomContentState	Získá nebo nastaví CustomContentState objekt, který je přidružen k této položce deníku.
DependencyObjectType	DependencyObjectType Získá ten, který zabalí typ CLR této instance. (Zděděno od DependencyObject)
Dispatcher	Dispatcher Získá toto DispatcherObject je přidružené. (Zděděno od DispatcherObject)
IsSealed	Získá hodnotu, která označuje, zda je tato instance aktuálně zapečetěna (jen pro čtení). (Zděděno od DependencyObject)
Name	Získá nebo nastaví název položky deníku.
Source	Získá nebo nastaví identifikátor URI obsahu, na který byl přešel.

Přidružené vlastnosti

Name	Description
KeepAlive	Získá nebo nastaví hodnotu, která označuje, zda je obsah položky deníku buď zachován nebo znovu vytvořen při přechodu do historie navigace.

Metody

Name	Description
CheckAccess()	Určuje, zda volající vlákno má přístup k tomuto DispatcherObject. (Zděděno od DispatcherObject)
ClearValue(DependencyProperty)	Vymaže místní hodnotu vlastnosti. Vlastnost, která se má vymazat, je určena identifikátorem DependencyProperty . (Zděděno od DependencyObject)
ClearValue(DependencyPropertyKey)	Vymaže místní hodnotu vlastnosti jen pro čtení. Vlastnost, která má být vymazána, je určena parametrem DependencyPropertyKey. (Zděděno od DependencyObject)
CoerceValue(DependencyProperty)	Převede hodnotu zadané vlastnosti závislosti. Toho se dosahuje vyvoláním jakékoli CoerceValueCallback funkce zadané v metadatech vlastností pro vlastnost závislosti, protože existuje ve volání DependencyObject. (Zděděno od DependencyObject)
Equals(Object)	Určuje, zda je poskytnutá DependencyObject hodnota ekvivalentní aktuálnímu DependencyObject. (Zděděno od DependencyObject)
GetHashCode()	Získá hash kód pro tento DependencyObject. (Zděděno od DependencyObject)
GetKeepAlive(DependencyObject)	Vrátí připojenou KeepAlive vlastnost položky deníku pro zadaný prvek.
GetLocalValueEnumerator()	Vytvoří specializovaný enumerátor pro určení, které vlastnosti závislosti mají místně nastavené hodnoty na tomto DependencyObject. (Zděděno od DependencyObject)
GetName(DependencyObject)	Získá připojenou Name vlastnost záznamu deníku pro zadaný prvek.
GetObjectData(SerializationInfo, StreamingContext)	Volá se při serializaci tohoto objektu.
GetValue(DependencyProperty)	Vrátí aktuální efektivní hodnotu vlastnosti závislosti na této instanci objektu DependencyObject. (Zděděno od DependencyObject)
InvalidateProperty(DependencyProperty)	Znovu vyhodnotí efektivní hodnotu pro zadanou vlastnost závislosti. (Zděděno od DependencyObject)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Vyvolána vždy, když byla aktualizována efektivní hodnota jakékoli vlastnosti závislosti na této DependencyObject vlastnosti. Konkrétní vlastnost závislosti, která se změnila, je hlášena v datech události. (Zděděno od DependencyObject)
ReadLocalValue(DependencyProperty)	Vrátí místní hodnotu vlastnosti závislosti, pokud existuje. (Zděděno od DependencyObject)
SetCurrentValue(DependencyProperty, Object)	Nastaví hodnotu vlastnosti závislosti beze změny jejího zdroje hodnot. (Zděděno od DependencyObject)
SetKeepAlive(DependencyObject, Boolean)	Nastaví připojenou KeepAlive vlastnost zadaného prvku.
SetName(DependencyObject, String)	Nastaví připojenou Name vlastnost zadaného prvku.
SetValue(DependencyProperty, Object)	Nastaví místní hodnotu vlastnosti závislosti určenou jeho identifikátorem vlastnosti závislosti. (Zděděno od DependencyObject)
SetValue(DependencyPropertyKey, Object)	Nastaví místní hodnotu vlastnosti závislosti jen pro čtení určenou identifikátorem DependencyPropertyKey vlastnosti závislosti. (Zděděno od DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Vrátí hodnotu, která určuje, zda procesy serializace mají serializovat hodnotu pro zadanou vlastnost závislosti. (Zděděno od DependencyObject)
VerifyAccess()	Vynucuje, že volající vlákno má přístup k tomuto DispatcherObject. (Zděděno od DispatcherObject)