JournalEntry クラス

リファレンス

定義

名前空間:: System.Windows.Navigation

アセンブリ:: PresentationFramework.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

"戻る" または "進む" ナビゲーション履歴のエントリを表します。

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

継承: Object

DispatcherObject

DependencyObject
JournalEntry

属性: SerializableAttribute

実装: ISerializable

例

次の例では、戻るナビゲーションスタックから最新JournalEntryのオブジェクトを取得して、プロパティ値と Source プロパティ値を取得する方法をName示します。

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

注釈

Windows Presentation Foundationは、ブラウザーのナビゲーション履歴と同様に、以前に移動したコンテンツごとに 1 つのエントリを格納するナビゲーション履歴サービスを実装します。ナビゲーション履歴は、2 つのスタックで構成されます。1 つは戻るナビゲーション履歴を記憶し、もう 1 つは前方ナビゲーション履歴を記憶します。

前方ナビゲーションが発生すると、現在の項目のエントリが戻るナビゲーション履歴に追加されます。これは、次の状況で発生します。

メソッドは Navigate (NavigationService.Navigate、、NavigationWindow.Navigate Frame.Navigate) と呼ばれます。
メソッドは GoForward (NavigationService.GoForward、、NavigationWindow.GoForward Frame.GoForward) と呼ばれます。
現在のナビゲーター (XBAP、NavigationWindow Frame) から表示されるナビゲーション UI の [進む] ボタン。

同様に、現在の項目のエントリは、戻るナビゲーションが発生する前にナビゲーション履歴を転送するために追加されます。これは、次の場合に発生します。

メソッドは GoBack (NavigationService.GoBack、、NavigationWindow.GoBack Frame.GoBack) と呼ばれます。
現在のナビゲーター (XBAP、NavigationWindow Frame) から表示されるナビゲーション UI の [戻る] ボタン。

前後のナビゲーション履歴の各エントリは、クラスの JournalEntry インスタンスです。

各 JournalEntry オブジェクトは、特定のナビゲーションに関する情報をカプセル化します。これには、エントリの名前 (Name)、エントリが保持されているかどうか () と、KeepAlive移動先Sourceのコンテンツの URI (Uniform Resource Identifier) が含まれます。

または Frame.BackStack プロパティを列挙することで、JournalEntry戻るナビゲーション履歴内のすべてのオブジェクトをNavigationWindow.BackStack取得できます。前方ナビゲーション履歴の場合は、プロパティまたは Frame.ForwardStack プロパティをJournalEntry列挙することで、すべてのオブジェクトをNavigationWindow.ForwardStack取得できます。

ナビゲーション履歴から最新JournalEntryのオブジェクトを削除する必要がある場合は、そのオブジェクトへのナビゲーションを防ぐために、メソッド (NavigationService.RemoveBackEntry、、Frame.RemoveBackEntry) を呼び出RemoveBackEntryすと、NavigationWindow.RemoveBackEntryオブジェクトがJournalEntry削除され、そのオブジェクトへの参照が返されます。

ただし、オブジェクトをナビゲーション履歴に追加 JournalEntry することはできません。これは、をインスタンス化することもから JournalEntry派生することもできないためです。また、そのためのメンバーを実装する型がないためです。ただし、メソッド (AddBackEntry、、) NavigationService を呼び出AddBackEntryすことで、AddBackEntry AddBackEntryナビゲーション履歴にカスタム CustomContentState オブジェクトを追加できます。内部で作成されたJournalEntryオブジェクトにオブジェクトが追加CustomContentStateされ、そのオブジェクトがバックナビゲーション履歴に追加されます。

コンストラクター

JournalEntry(SerializationInfo, StreamingContext)

JournalEntry クラスの新しいインスタンスを初期化します。

フィールド

KeepAliveProperty	KeepAlive 添付プロパティを識別します。
NameProperty	Name 添付プロパティを識別します。

プロパティ

CustomContentState	この履歴項目に関連付けられている CustomContentState オブジェクトを取得または設定します。
DependencyObjectType	このインスタンスの DependencyObjectType CLR 型をラップするを取得します。 (継承元 DependencyObject)
Dispatcher	この Dispatcher が関連付けられている DispatcherObject を取得します。 (継承元 DispatcherObject)
IsSealed	このインスタンスが現在シールされている (読み取り専用である) かどうかを示す値を取得します。 (継承元 DependencyObject)
Name	履歴項目の名前を取得または設定します。
Source	移動先となったコンテンツの URI を取得または設定します。

添付プロパティ

KeepAlive

ナビゲーション履歴の履歴項目に移動した際に、その履歴項目のコンテンツが保持されるか、または再作成されるか示す値を取得または設定します。

メソッド

CheckAccess()	呼び出し元のスレッドがこの DispatcherObject にアクセスできるかどうかを確認します。 (継承元 DispatcherObject)
ClearValue(DependencyProperty)	プロパティのローカル値をクリアします。クリアするプロパティは DependencyProperty 識別子で指定されます。 (継承元 DependencyObject)
ClearValue(DependencyPropertyKey)	読み取り専用プロパティのローカル値を消去します。消去するプロパティは、DependencyPropertyKey で指定します。 (継承元 DependencyObject)
CoerceValue(DependencyProperty)	指定した依存関係プロパティの値を強制します。これは、呼び出し元の DependencyObject の依存関係プロパティのプロパティメタデータで指定されている CoerceValueCallback 関数を呼び出すことによって実現されます。 (継承元 DependencyObject)
Equals(Object)	指定した DependencyObject が現在の DependencyObject と等しいかどうかを判断します。 (継承元 DependencyObject)
GetHashCode()	この DependencyObject のハッシュコードを取得します。 (継承元 DependencyObject)
GetKeepAlive(DependencyObject)	指定された要素に対応する履歴項目の KeepAlive 添付プロパティを返します。
GetLocalValueEnumerator()	どの依存関係プロパティがこの DependencyObject 上にローカルに設定された値を持つかを確認するための、専用の列挙子を作成します。 (継承元 DependencyObject)
GetName(DependencyObject)	指定した要素に対応する履歴項目の Name 添付プロパティを取得します。
GetObjectData(SerializationInfo, StreamingContext)	このオブジェクトがシリアル化されるときに呼び出されます。
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
GetValue(DependencyProperty)	DependencyObject のこのインスタンスにある依存関係プロパティの現在の有効値を返します。 (継承元 DependencyObject)
InvalidateProperty(DependencyProperty)	指定した依存関係プロパティの有効値を再評価します。 (継承元 DependencyObject)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	この DependencyObject の依存関係プロパティの有効値が更新された場合に必ず呼び出されます。変更された特定の依存関係プロパティは、イベントデータで報告されます。 (継承元 DependencyObject)
ReadLocalValue(DependencyProperty)	ローカルの依存関係プロパティの値を返します (存在する場合)。 (継承元 DependencyObject)
SetCurrentValue(DependencyProperty, Object)	依存関係プロパティ値のソースを変更せずにその値を設定します。 (継承元 DependencyObject)
SetKeepAlive(DependencyObject, Boolean)	指定した要素の KeepAlive 添付プロパティを設定します。
SetName(DependencyObject, String)	指定した要素の Name 添付プロパティを設定します。
SetValue(DependencyProperty, Object)	依存関係プロパティ識別子を指定して、該当する依存関係プロパティのローカル値を設定します。 (継承元 DependencyObject)
SetValue(DependencyPropertyKey, Object)	依存関係プロパティの DependencyPropertyKey 識別子で指定した読み取り専用の依存関係プロパティのローカル値を設定します。 (継承元 DependencyObject)
ShouldSerializeProperty(DependencyProperty)	シリアル化プロセスが、指定された依存関係プロパティの値をシリアル化する必要があるかどうかを示す値を返します。 (継承元 DependencyObject)
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)
VerifyAccess()	呼び出し元のスレッドがこの DispatcherObject にアクセスできるように強制します。 (継承元 DispatcherObject)

適用対象

次の方法で共有