ConnectedAnimation Classe

  • Riferimento

Definizione

Spazio dei nomi:
Windows.UI.Xaml.Media.Animation
Modifica

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)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ConnectedAnimation final
/// [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)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class ConnectedAnimation
[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 ThreadingAttribute

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.

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.

Si applica a

Vedi anche