JournalEntry Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Představuje položku v historii zpětné nebo dopředné navigace.
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
- Dědičnost
- Atributy
- Implementuje
Příklady
Následující příklad ukazuje, jak načíst nejnovější JournalEntry objekt ze zásobníku zpětné navigace a získat Name hodnoty vlastnosti a 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
Poznámky
Windows Presentation Foundation implementuje službu historie navigace, která ukládá jednu položku pro každou část obsahu, na kterou jste předtím přešli, stejně jako historie navigace v prohlížeči. Historie navigace se skládá ze dvou zásobníků, jeden, který si pamatuje historii zpětné navigace, a druhý, který si pamatuje historii navigace.
Položka pro aktuální položku se přidá do historie zpětné navigace, když dojde k dopředné navigaci. K tomu dochází v následujících situacích:
Metoda se
Navigate
nazývá (NavigationService.Navigate, NavigationWindow.Navigate, ). Frame.NavigateMetoda se
GoForward
nazývá (NavigationService.GoForward, NavigationWindow.GoForward, ). Frame.GoForwardTlačítko vpřed v navigačním uživatelském rozhraní, které se zobrazuje z aktuálního navigátoru (XBAP, NavigationWindow, ). Frame
Podobně se položka pro aktuální položku přidá do historie navigace před provedením zpětné navigace, k čemuž dojde v následujících případech:
Metoda se
GoBack
nazývá (NavigationService.GoBack, NavigationWindow.GoBack, ). Frame.GoBackTlačítko Zpět v navigačním uživatelském rozhraní, které se zobrazuje v aktuálním navigátoru (XBAP, NavigationWindow, ). Frame
Každá položka v historii zpětné a dopředné navigace je instancí JournalEntry třídy.
Každý JournalEntry objekt zapouzdřuje informace o konkrétní navigaci, včetně názvu položky (Name), toho, jestli je položka zachována (KeepAlive) a identifikátoru URI (Uniform Resource Identifier) pro obsah, který je přecháděn na (Source).
Pomocí výčtu JournalEntryNavigationWindow.BackStack vlastností nebo Frame.BackStack můžete načíst všechny objekty v historii zpětné navigace. Pro dopřednou historii navigace můžete načíst všechny JournalEntry objekty výčtem NavigationWindow.ForwardStack vlastností nebo Frame.ForwardStack .
Pokud potřebujete odebrat poslední JournalEntry objekt z historie zpětné navigace, můžete například volat metodu RemoveBackEntry
(NavigationService.RemoveBackEntry, NavigationWindow.RemoveBackEntry, Frame.RemoveBackEntry), která objekt odebere JournalEntry a vrátí na něj odkaz.
Nelze však přidat JournalEntry objekty do historie navigace, protože nelze vytvořit instanci ani odvodit z JournalEntrya protože žádný typ neimplementuje člen, který by to udělal. Do historie navigace však můžete přidat vlastní CustomContentState objekty 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
JournalEntry(SerializationInfo, StreamingContext) |
Inicializuje novou instanci JournalEntry třídy. |
Pole
KeepAliveProperty |
Identifikuje připojenou KeepAlive vlastnost. |
NameProperty |
Identifikuje připojenou Name vlastnost. |
Vlastnosti
CustomContentState |
Získá nebo nastaví CustomContentState objekt, který je přidružen k této položky deníku. |
DependencyObjectType |
DependencyObjectType Získá, který zabalí typ CLR této instance. (Zděděno od DependencyObject) |
Dispatcher |
Získá přidruženou Dispatcher k tomuto DispatcherObject . (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řejděte. |
Přidružené vlastnosti
KeepAlive |
Získá nebo nastaví hodnotu, která označuje, zda obsah položky deníku je buď zachován nebo znovu vytvořen při přechodu na v historii navigace. |
Metody
CheckAccess() |
Určuje, zda má volající vlákno 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á se má vymazat, je určena parametrem DependencyPropertyKey. (Zděděno od DependencyObject) |
CoerceValue(DependencyProperty) |
Převede hodnotu zadané vlastnosti závislosti. Toho dosáhnete vyvoláním jakékoli CoerceValueCallback funkce zadané v metadatech vlastnosti pro vlastnost závislosti, protože existuje ve volajícím DependencyObjectobjektu . (Zděděno od DependencyObject) |
Equals(Object) |
Určuje, zda je zadaný DependencyObject ekvivalent k 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í vlastností závislostí, které mají místně nastavené hodnoty v tomto DependencyObjectobjektu . (Zděděno od DependencyObject) |
GetName(DependencyObject) |
Získá připojenou Name vlastnost položky deníku pro zadaný prvek. |
GetObjectData(SerializationInfo, StreamingContext) |
Volá se při serializaci tohoto objektu. |
GetType() |
Získá aktuální Type instanci. (Zděděno od Object) |
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) |
MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object) |
OnPropertyChanged(DependencyPropertyChangedEventArgs) |
Vyvolá se vždy, když byla aktualizována efektivní hodnota jakékoli vlastnosti závislosti na této DependencyObject vlastnosti. Specifická 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 hodnoty. (Zděděno od DependencyObject) |
SetKeepAlive(DependencyObject, Boolean) |
Nastaví připojenou KeepAlive vlastnost zadaného elementu. |
SetName(DependencyObject, String) |
Nastaví připojenou Name vlastnost zadaného elementu. |
SetValue(DependencyProperty, Object) |
Nastaví místní hodnotu vlastnosti závislosti určenou 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 DependencyPropertyKey identifikátorem vlastnosti závislosti. (Zděděno od DependencyObject) |
ShouldSerializeProperty(DependencyProperty) |
Vrátí hodnotu, která označuje, zda serializační procesy mají serializovat hodnotu pro zadanou vlastnost závislosti. (Zděděno od DependencyObject) |
ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |
VerifyAccess() |
Vynutí, aby volající vlákno má přístup k tomuto DispatcherObject. (Zděděno od DispatcherObject) |