NavigationThemeTransition Classe

Définition

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 .../>

Héritage

Object Platform::Object IInspectable DependencyObject Transition NavigationThemeTransition

Attributs

ContentPropertyAttribute ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Exemples

L’application WinUI 3 Gallery inclut des exemples interactifs de la plupart des contrôles, des caractéristiques et des fonctionnalités de WinUI 3. Obtenez l’application à partir du Microsoft Store ou obtenez le code source sur GitHub.

Remarques

Avec Windows 10, version 1803, un frame utilise NavigationThemeTransition pour animer la navigation entre les pages par défaut.

Vous pouvez utiliser NavigationThemeTransition pour ajouter des transitions animées lorsque votre application navigue entre différents éléments de contenu dans un frame. Vous pouvez ajouter NavigationThemeTransition à la collection Transitions de la page en cours d’accès ou à la collection ContentTransitions pour le cadre de navigation. En général, nous vous recommandons d’utiliser la propriété ContentTransitions du frame pour vous assurer que les transitions se produisent pour toutes les pages de navigation.

Cet exemple montre NavigationThemeTransition ajouté à la collection ContentTransitions d’un frame.

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

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

Dans Windows 10, deux animations différentes sont fournies pour la navigation entre les pages d’une application. Les animations de navigation sont représentées par des sous-classes de NavigationTransitionInfo.

• Actualisation de la page : l’actualisation de la page est l’animation par défaut pour la navigation de page. Il s’agit d’une combinaison d’une animation de diapositive et d’une fondue dans l’animation pour le contenu entrant. Vous devez utiliser l’actualisation de page lorsque vous utilisez la navigation de niveau supérieur comme un menu de navigation.

L’animation d’actualisation de la page est représentée par la classe EntranceNavigationTransitionInfo . Vous pouvez utiliser la propriété jointe EntranceNavigationTransitionInfo.IsTargetElement pour appliquer le mouvement d’actualisation de la page à un sous-ensemble de la page ; par exemple, tout le contenu à l’exclusion de l’interface utilisateur de commande de la page.

• Extraction : vous devez utiliser l’extraction dans l’animation lorsqu’un utilisateur interagit avec l’interface utilisateur sur une page qui représente un lien vers une autre page. Par exemple, dans une page qui représente une liste d’albums, lorsqu’un utilisateur clique sur un élément d’album, il doit y avoir une exploration de la page d’album.

L’extraction dans l’animation est représentée par la classe DrillInNavigationTransitionInfo .

Par défaut, NavigationThemeTransition lit une animation d’actualisation de page. Toutefois, vous pouvez remplacer ce comportement en définissant la propriété DefaultNavigationTransitionInfo de NavigationThemeTransition. La valeur NavigationTransitionInfo de cette propriété est utilisée pour toutes les navigations par défaut.

Vous pouvez spécifier l’animation à utiliser pour une navigation particulière à l’aide de la surcharge de Frame.Navigate qui prend 3 paramètres.

Dans cet exemple, lorsqu’un utilisateur « extrait » d’une liste d’albums vers une page représentant un album particulier, une application de navigation musicale demande une extraction dans l’animation.

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

En outre, vous pouvez utiliser Frame.GoBack(NavigationTransitionInfo) pour lire une transition spécifique lors de la navigation dans la pile arrière Frame . Cela peut être utile lorsque vous modifiez dynamiquement le comportement de navigation en fonction de la taille de l’écran ; par exemple, dans un scénario maître/détail réactif. Pour plus d’exemples, consultez l’exemple maître/détail XAML.

SuppressNavigationTransitionInfo

Vous pouvez utiliser SuppressNavigationTransitionInfo à la place d’autres sous-types NavigationTransitionInfo lorsque vous souhaitez éviter de lire une animation pendant la navigation.

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

Voir aussi

• Transition
• EntranceNavigationTransitionInfo
• DrillInNavigationTransitionInfo
• SuppressNavigationTransitionInfo
• Navigate(TypeName, Object, NavigationTransitionInfo)
• Frame.GoBack(NavigationTransitionInfo)
• Exemple maître/détail XAML