NavigationThemeTransition クラス

定義

public ref class NavigationThemeTransition sealed : Transition

/// [Microsoft.UI.Xaml.Markup.ContentProperty(Name="DefaultNavigationTransitionInfo")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class NavigationThemeTransition final : Transition

[Microsoft.UI.Xaml.Markup.ContentProperty(Name="DefaultNavigationTransitionInfo")]
[Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class NavigationThemeTransition : Transition

Public NotInheritable Class NavigationThemeTransition
Inherits Transition

<NavigationThemeTransition .../>

継承

Object Platform::Object IInspectable DependencyObject Transition NavigationThemeTransition

属性

ContentPropertyAttribute ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

例

WinUI 3 ギャラリー アプリには、ほとんどの WinUI 3 コントロールと機能の対話型の例が含まれています。 Microsoft Store からアプリを取得するか、GitHub でソース コードを取得します。

注釈

Windows 10バージョン 1803 では、Frame は NavigationThemeTransition を使用して、ページ間のナビゲーションを既定でアニメーション化します。

NavigationThemeTransition を使用すると、 アプリがフレーム内のさまざまなコンテンツ間を移動するときに、アニメーションの切り替えを追加できます。 NavigationThemeTransition を、移動するページの Transitions コレクションまたはナビゲーション フレームの ContentTransitions コレクションに追加できます。 一般に、フレームの ContentTransitions プロパティを使用して、すべてのナビゲーション ページに対して切り替えが行われるようにすることをお勧めします。

この例では、Frame の ContentTransitions コレクションに追加された NavigationThemeTransition を示します。

<Frame ...>
    <Frame.ContentTransitions>
        <TransitionCollection>
            <NavigationThemeTransition/> 
        </TransitionCollection> 
    </Frame.ContentTransitions> 
    ...
</Frame> 

var frame = new Frame(); 
frame.ContentTransitions = new TransitionCollection(); 
frame.ContentTransitions.Add(new NavigationThemeTransition()); 

Windows 10では、アプリ内のページ間のナビゲーション用に 2 つの異なるアニメーションが提供されます。 ナビゲーション アニメーションは、 NavigationTransitionInfo のサブクラスによって表されます。

• ページの更新: ページの更新は、ページ ナビゲーションの既定のアニメーションです。 これは、 スライド アップ アニメーションと、受信コンテンツ のフェード イン アニメーションの組み合わせです。 ナビゲーション メニューなどの最上位レベルのナビゲーションを使用する場合は、ページの更新を使用する必要があります。

ページ更新アニメーションは、 EntranceNavigationTransitionInfo クラスによって表されます。 EntranceNavigationTransitionInfo.IsTargetElement 添付プロパティを使用して、ページ更新モーションをページのサブセットに適用できます。たとえば、ページのコマンド実行 UI を除くすべてのコンテンツです。

• ドリルイン: ユーザーが別のページへのリンクを表すページの UI を操作する場合は、ドリルイン アニメーションを使用する必要があります。 たとえば、アルバムの一覧を表すページでは、ユーザーがアルバム項目をクリックすると、アルバム ページへの切り替えが行われます。

ドリルイン アニメーションは DrillInNavigationTransitionInfo クラスによって表されます。

既定では、NavigationThemeTransition はページ更新アニメーションを再生します。 ただし、NavigationThemeTransition の DefaultNavigationTransitionInfo プロパティを設定することで、この動作をオーバーライドできます。 このプロパティの NavigationTransitionInfo 値は、既定ですべてのナビゲーションに使用されます。

3 つのパラメーターを受け取る Frame.Navigate のオーバーロードを使用して、特定のナビゲーションに使用するアニメーションを指定できます。

この例では、ユーザーがアルバム リストから特定のアルバムを表すページに "ドリルイン" すると、音楽閲覧アプリはアニメーションのドリルインを要求します。

void AlbumsListView_ItemClick(object sender, ItemClickEventArgs e) 
{
    // Get albumId from clicked item... 
    Frame.Navigate(typeof(AlbumPage), albumId, new DrillInNavigationTransitionInfo());
} 

さらに、 Frame.GoBack(NavigationTransitionInfo) を使用して、 フレーム バック スタックに戻るときに特定の遷移を再生できます。 これは、画面サイズに基づいてナビゲーション動作を動的に変更する場合に便利です。たとえば、レスポンシブ マスター/詳細シナリオの場合などです。 その他の例については、 XAML マスター/詳細サンプルを参照してください。

SuppressNavigationTransitionInfo

ナビゲーション中にアニメーションを再生しないようにする場合は、他の NavigationTransitionInfo サブタイプの代わりに SuppressNavigationTransitionInfo を使用できます。

// Navigate to your first page without a transition 
Frame.Navigate(typeof(MainPage), null, new SuppressNavigationTransitionInfo()); 

こちらもご覧ください

• Transition
• EntranceNavigationTransitionInfo
• DrillInNavigationTransitionInfo
• SuppressNavigationTransitionInfo
• Navigate(TypeName, Object, NavigationTransitionInfo)
• Frame.GoBack(NavigationTransitionInfo)
• XAML マスター/詳細サンプル