JournalEntry クラス

定義

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.NavigateFrame.Navigate) と呼ばれます。

• メソッドは GoForward (NavigationService.GoForward、、NavigationWindow.GoForwardFrame.GoForward) と呼ばれます。

• 現在のナビゲーター (XBAP、NavigationWindowFrame) から表示されるナビゲーション UI の [進む] ボタン。

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

• メソッドは GoBack (NavigationService.GoBack、、NavigationWindow.GoBackFrame.GoBack) と呼ばれます。

• 現在のナビゲーター (XBAP、NavigationWindowFrame) から表示されるナビゲーション 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すことで、AddBackEntryAddBackEntryナビゲーション履歴にカスタム CustomContentState オブジェクトを追加できます。内部で作成されたJournalEntryオブジェクトに オブジェクトが追加CustomContentStateされ、そのオブジェクトがバック ナビゲーション履歴に追加されます。

コンストラクター

フィールド

プロパティ

添付プロパティ

メソッド

適用対象