UIElement.Transitions Proprietà

Definizione

Spazio dei nomi:

Microsoft.UI.Xaml

Ottiene o imposta la raccolta di elementi dello stile Di transizione che si applicano a un oggetto UIElement.

public:
 property TransitionCollection ^ Transitions { TransitionCollection ^ get(); void set(TransitionCollection ^ value); };

TransitionCollection Transitions();

void Transitions(TransitionCollection value);

public TransitionCollection Transitions { get; set; }

var transitionCollection = uIElement.transitions;
uIElement.transitions = transitionCollection;

Public Property Transitions As TransitionCollection

<uielement>
  <uielement.Transitions>
    <TransitionCollection>
      oneOrMoreTransitions
    </TransitionCollection>
  </uielement.Transitions>
</uielement>

Valore della proprietà

TransitionCollection

Raccolta fortemente tipizzata di elementi di stile Transition che si applicano a un OGGETTO UIElement.

Esempio

Suggerimento

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

Aprire l'app Raccolta WinUI 3 e visualizzare le transizioni in azione.

L'app Raccolta WinUI 3 include esempi interattivi della maggior parte dei controlli, delle funzionalità e delle funzionalità winUI 3. Ottenere l'app da Microsoft Store o ottenere il codice sorgente in GitHub.

L'esempio XAML seguente mostra un singolo oggetto EntranceThemeTransition come definito in uno stile per un controllo Button. Le proprietà dell'animazione di transizione vengono in genere impostate in stili e modelli anziché come proprietà direttamente in una definizione dell'interfaccia utente. Gli stili vengono in genere archiviati come risorsa XAML.

<Grid Background="{StaticResource ApplicationPageBackgroundBrush}">
    <Grid.Resources>
        <Style x:Key="DefaultButtonStyle" TargetType="Button">
            <Setter Property="Transitions">
                <Setter.Value>
                    <TransitionCollection>
                        <EntranceThemeTransition/>
                    </TransitionCollection>
                </Setter.Value>
            </Setter>
        </Style>
    </Grid.Resources>

    <Button Style="{StaticResource DefaultButtonStyle}" 
            Content="EntranceThemeTransition style applied" />

</Grid>

Commenti

Nota

Prima di Windows 10, versione 1809 (SDK 17763), la sintassi XAML per le proprietà con un valore TransitionCollection richiede che dichiari un elemento oggetto TransitionCollection esplicito come valore e quindi fornisci elementi oggetto come elementi figlio di TransitionCollection per ognuna delle animazioni di transizione che vuoi usare. In Windows 10, versione 1809 (SDK 17763) o versione successiva TransitionCollection supporta l'utilizzo implicito della raccolta, in modo da poter omettere l'elemento dell'oggetto raccolta. Per altre info sulle raccolte implicite e su XAML, vedi guida alla sintassi XAML.

Questo è un breve elenco di alcuni dei possibili tipi di transizioni:

• AddDeleteThemeTransition
• ContentThemeTransition
• EdgeUIThemeTransition
• EntranceThemeTransition
• PopupThemeTransition
• ReorderThemeTransition
• RepositionThemeTransition

A volte classi specifiche che derivano da UIElement hanno le proprie proprietà che contengono altri tipi di transizioni per scenari specifici della classe. Ad esempio , Popup.ChildTransitions e ItemsControl.ItemContainerTransitions.

Le animazioni di transizione svolgono un ruolo particolare nella progettazione dell'interfaccia utente della tua app. L'idea di base è che quando si verifica una modifica o una transizione, l'animazione attira l'attenzione dell'utente alla modifica.

Non è comune impostare il valore della Transitions proprietà direttamente su un UIElement che è un elemento diretto dell'interfaccia utente dell'app. È più comune avere una raccolta di transizioni come parte di uno stato di visualizzazione, un modello o uno stile. In questo caso si usano meccanismi come Setter di uno stile per specificare la Transitions proprietà e impostare il valore usando contenuto definito da XAML che viene in genere archiviato come risorsa XAML.

VisualTransition non è uno dei tipi inseriti nella UIElement.Transitions raccolta. VisualTransition è in particolare per le animazioni nei gruppi di stati di visualizzazione e viene utilizzata dalla proprietà VisualStateGroup.Transitions .

Vedi anche

• TransitionCollection
• Animazioni con storyboard