ConnectedAnimation Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ConnectedAnimation final[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ConnectedAnimationPublic NotInheritable Class ConnectedAnimation- Ereditarietà
- Attributi
Esempio
Tip
Per altre info, indicazioni sulla progettazione ed esempi di codice, vedi Animazione connessa.
L'app Raccolta WinUI 3 include esempi interattivi della maggior parte dei controlli e delle funzionalità di WinUI 3. Ottenere l'app dal Microsoft Store o ottenere il codice sorgente in GitHub.
Commenti
Un'istanza connectedAnimation viene restituita dai metodi ConnectedAnimationService.GetAnimatione 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 popolato completamente, 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 bene 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.
Proprietà
| Nome | Descrizione |
|---|---|
| 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
| Nome | Descrizione |
|---|---|
| Cancel() |
Arresta l'animazione connessa. |
| SetAnimationComponent(ConnectedAnimationComponent, ICompositionAnimationBase) |
Imposta un oggetto CompositionAnimation personalizzato per modificare il movimento di una particolare parte dell'animazione connessa. |
| TryStart(UIElement, IIterable<UIElement>) |
Tenta di avviare l'animazione sull'elemento di destinazione e sugli elementi secondari specificati. |
| TryStart(UIElement) |
Tenta di avviare l'animazione. |
Eventi
| Nome | Descrizione |
|---|---|
| Completed |
Si verifica al termine dell'animazione. |