ConnectedAnimation Classe

Definizione

Spazio dei nomi:

Windows.UI.Xaml.Media.Animation

Rappresenta un'animazione che anima simultaneamente l'uscita di un elemento e l'ingresso di un altro elemento.

public ref class ConnectedAnimation sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 196608)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ConnectedAnimation final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 196608)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ConnectedAnimation

Public NotInheritable Class ConnectedAnimation

Ereditarietà

Object Platform::Object IInspectable ConnectedAnimation

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 Anniversary Edition (è stato introdotto in 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v3.0)

Esempio

Suggerimento

Per altre info, linee guida per la progettazione ed esempi di codice, vedi Animazione connessa.

Se è installata l'app WinUI 2 Gallery , fare clic qui per aprire l'app e vedere Animazione connessa in azione.

• Ottenere l'app Raccolta WinUI 2 (Microsoft Store)
• Ottieni il codice sorgente (GitHub)

Commenti

Un'istanza ConnectedAnimation viene restituita dai metodi ConnectedAnimationService.GetAnimation e ConnectedAnimationService.PrepareToAnimate .

Quando si chiama TryStart, l'elemento passato nel metodo deve avere le dimensioni definite nel layout. Ciò significa che le dimensioni dell'elemento devono essere impostate nel markup o che il contenuto dell'elemento deve essere completamente popolato, in modo che le dimensioni possano essere calcolate dal framework XAML. Se il layout fa parte di un elemento ListView o GridView con proprietà associate, potrebbe essere necessario aggiornare manualmente il contenuto per prepararsi per l'animazione perché i binding possono essere aggiornati in modo asincrono.

Esiste una limitazione nota in cui ConnectedAnimation non funziona correttamente con le transizioni di tema con un componente di conversione, tra cui NavigationThemeTransition e EntranceThemeTransition. È consigliabile rimuovere queste transizioni o eliminare la navigazione usando SuppressNavigationTransitionInfo, quando si crea un'esperienza con ConnectedAnimation.

Vedi l'esempio di animazione connessa per un esempio completo di ConnectedAnimation.

Cronologia delle versioni

Versione di Windows	Versione dell'SDK	Valore aggiunto
1703	15063	IsScaleAnimationEnabled
1703	15063	SetAnimationComponent
1703	15063	TryStart(UIElement,IEnumerable<UIElement>)
1809	17763	Configurazione

Proprietà

Configuration	Ottiene o imposta la configurazione che descrive il tipo di animazione connessa da riprodurre.
IsScaleAnimationEnabled	Ottiene o imposta un valore che indica se deve essere utilizzato il componente di scala dell'animazione connessa.

Metodi

Cancel()	Arresta l'animazione connessa.
SetAnimationComponent(ConnectedAnimationComponent, ICompositionAnimationBase)	Imposta un oggetto CompositionAnimation personalizzato per modificare il movimento di una determinata parte dell'animazione connessa.
TryStart(UIElement)	Tenta di avviare l'animazione.
TryStart(UIElement, IIterable<UIElement>)	Tenta di avviare l'animazione sull'elemento di destinazione e sugli elementi secondari specificati.

Eventi

Completed

Si verifica al termine dell'animazione.

Vedi anche

• ConnectedAnimationService