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 を使用して、既定で Pages 間のナビゲーションをアニメーション化します。

NavigationThemeTransition を使用すると、 アプリがフレーム内のさまざまなコンテンツ間を移動するときにアニメーション化された切り替えを追加できます。 NavigationThemeTransition を、移動先の Page の 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 マスター/詳細サンプル