TransitionCollection Classe

Definizione

Spazio dei nomi:

Windows.UI.Xaml.Media.Animation

Rappresenta una raccolta di oggetti Transition . Ogni oggetto Transition rappresenta una transizione a tema diversa, parte della libreria di animazioni Windows Runtime.

public ref class TransitionCollection sealed : IIterable<Transition ^>, IVector<Transition ^>

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class TransitionCollection final : IIterable<Transition>, IVector<Transition>

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class TransitionCollection : IEnumerable<Transition>, IList<Transition>

Public NotInheritable Class TransitionCollection
Implements IEnumerable(Of Transition), IList(Of Transition)

<TransitionCollection>
    oneOrMoreTransitions
</TransitionCollection>

Ereditarietà

Object Platform::Object IInspectable TransitionCollection

Attributi

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementazioni

IIterable<T> IEnumerable<T> IIterable<Transition> IEnumerable<Transition> IVector<Transition> IList<Transition>

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Esempio

In questo esempio viene illustrata la sintassi XAML per impostare un elemento oggetto TransitionCollection come parte dell'impostazione della proprietà UIElement.Transitions inline.

<Button Content="EntranceThemeTransition Button">
    <Button.Transitions>
        <TransitionCollection>
            
            <!-- This transition just uses the default behavior which is to
                 have the button animate into view from the right. You can
                 make it start from anywhere on the right by using the
                 FromHorizontalOffset property. If you'd rather see a vertical
                 animation, use the FromVerticalOffset property. -->
            <EntranceThemeTransition />
        </TransitionCollection>
    </Button.Transitions>
</Button>

<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

TransitionCollection viene usato come tipo di valore per queste proprietà:

• Border.ChildTransitions
• ContentControl.ContentTransitions (nei controlli contenuto, ad esempio Button o AppBar)
• ContentPresenter.ContentTransitions
• ItemsControl.ItemContainerTransitions (in elementi come GridView, ListBox, ListView, ListView e Selector)
• ItemsPresenter.FooterTransitions
• ItemsPresenter.HeaderTransitions
• ListViewBase.FooterTransitions
• ListViewBase.HeaderTransitions
• Panel.ChildrenTransitions (in Grid, StackPanel e altri pannelli)
• Popup.ChildTransitions
• SettingsFlyoutTemplateSettings.ContentTransitions
• UIElement.Transitions (su centinaia di classi)

Nota

Prima di Windows 10, versione 1809 (SDK 17763), la sintassi XAML per le proprietà con valore TransitionCollection richiede che si dichiara un elemento oggetto TransitionCollectionesplicito come valore e quindi fornire elementi oggetto come elementi figlio di TransitionCollection per ognuna delle animazioni di transizione da usare. In Windows 10, versione 1809 (SDK 17763) o versioni successive, TransitionCollection supporta l'utilizzo implicito della raccolta, in modo da omettere l'elemento dell'oggetto raccolta. Per altre informazioni sulle raccolte implicite e XAML, vedere Guida alla sintassi XAML.

Le animazioni di transizione sono animazioni preconfigurate dalla libreria di animazioni Windows Runtime. Le animazioni di transizione vengono eseguite automaticamente in base alle condizioni associate all'animazione di transizione, usando il proprietario della proprietà in cui TransitionCollection è impostato come destinazione. Le proprietà animate variano a seconda della transizione usata.

VisualStateGroup.Transitions non usa il tipo TransitionCollection. VisualStateGroup.Transitions usa una raccolta predefinita(elenco o vettore) di oggetti VisualTransition .

Enumerazione della raccolta in C# o Microsoft Visual Basic

Un oggetto TransitionCollection è enumerabile, quindi è possibile usare una sintassi specifica del linguaggio, ad esempio foreach in C# per enumerare gli elementi nell'insieme. Il compilatore esegue il cast di tipi per l'utente e non è necessario eseguire il cast IEnumerable<Transition> in modo esplicito. Se è necessario eseguire il cast in modo esplicito, ad esempio se si vuole chiamare GetEnumerator, eseguire il cast in IEnumerable<T> con un vincolo Di transizione .

Costruttori

TransitionCollection()

Inizializza una nuova istanza della classe TransitionCollection .

Proprietà

Size	Ottiene le dimensioni (conteggio) dell'insieme.

Metodi

Append(Transition)	Aggiunge un nuovo elemento alla raccolta.
Clear()	Rimuove tutti gli elementi dalla raccolta.
First()	Restituisce l'iteratore per l'iterazione sugli elementi della raccolta.
GetAt(UInt32)	Restituisce l'elemento situato nell'indice specificato.
GetMany(UInt32, Transition[])	Recupera più elementi in un singolo passaggio dell'iteratore.
GetView()	Ottiene una visualizzazione non modificabile nella raccolta.
IndexOf(Transition, UInt32)	Recupera l'indice dell'elemento specificato.
InsertAt(UInt32, Transition)	Inserisce l'elemento specificato nell'indice specificato.
RemoveAt(UInt32)	Rimuove l'elemento all'indice specificato.
RemoveAtEnd()	Rimuove l'ultimo elemento della raccolta.
ReplaceAll(Transition[])	Inizialmente cancella la raccolta, quindi inserisce la matrice fornita come nuovi elementi.
SetAt(UInt32, Transition)	Imposta il valore in corrispondenza dell'indice specificato sul valore Di transizione specificato.

Vedi anche

• Transitions
• ContentTransitions
• ChildrenTransitions
• IVector<T>
• IIterable<T>
• IList< T>