TransitionCollection Classe

Definição

Namespace:

Windows.UI.Xaml.Media.Animation

Representa uma coleção de objetos Transition . Cada objeto Transition representa uma transição de tema diferente, parte da biblioteca de animação 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>

Herança

Object Platform::Object IInspectable TransitionCollection

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementações

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

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Exemplos

Este exemplo mostra a sintaxe XAML para definir um elemento de objeto TransitionCollection como parte da definição da propriedade UIElement.Transitions embutida.

<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>

Comentários

TransitionCollection é usado como o tipo de valor para estas propriedades:

• Border.ChildTransitions
• ContentControl.ContentTransitions (em controles de conteúdo como Button ou AppBar)
• ContentPresenter.ContentTransitions
• ItemsControl.ItemContainerTransitions (em controles de itens como GridView, ListBox, ListView e Selector)
• ItemsPresenter.FooterTransitions
• ItemsPresenter.HeaderTransitions
• ListViewBase.FooterTransitions
• ListViewBase.HeaderTransitions
• Panel.ChildrenTransitions (em Grade, StackPanel e outros painéis)
• Popup.ChildTransitions
• SettingsFlyoutTemplateSettings.ContentTransitions
• UIElement.Transitions (em centenas de classes)

Observação

Antes de Windows 10, versão 1809 (SDK 17763), a sintaxe XAML para propriedades que têm um valor TransitionCollection requer que você declare um elemento de objeto TransitionCollection explícito como o valor e forneça elementos de objeto como elementos filho de TransitionCollection para cada uma das animações de transição que você deseja usar. No Windows 10, versão 1809 (SDK 17763) ou posterior, TransitionCollection dá suporte ao uso implícito da coleção, para que você possa omitir o elemento de objeto da coleção. Para obter mais informações sobre coleções implícitas e XAML, consulte Guia de sintaxe XAML.

Animações de transição são animações pré-configuradas da biblioteca de animação Windows Runtime. As animações de transição são executadas automaticamente nas condições às quais a animação de transição está associada, usando o proprietário da propriedade em que TransitionCollection é definido como o destino. As propriedades que estão sendo animadas variam dependendo de qual transição você usa.

VisualStateGroup.Transitions não usa o tipo TransitionCollection. VisualStateGroup.Transitions usa uma coleção interna (lista ou vetor) de objetos VisualTransition .

Enumerando a coleção em C# ou Microsoft Visual Basic

Uma TransitionCollection é enumerável, portanto, você pode usar a sintaxe específica da linguagem, como foreach em C# para enumerar os itens na coleção. O compilador faz a conversão de tipo para você e você não precisará converter IEnumerable<Transition> explicitamente. Se você precisar converter explicitamente, por exemplo, se quiser chamar GetEnumerator, converta para IEnumerable<T> com uma restrição de Transição .

Construtores

TransitionCollection()

Inicializa uma nova instância da classe TransitionCollection .

Propriedades

Size	Obtém o tamanho (contagem) da coleção.

Métodos

Append(Transition)	Adiciona um novo item à coleção.
Clear()	Remove todos os itens da coleção.
First()	Retorna o iterador para iteração sobre os itens na coleção.
GetAt(UInt32)	Retorna o item localizado no índice especificado.
GetMany(UInt32, Transition[])	Recupera vários elementos em uma única passagem pelo iterador.
GetView()	Obtém uma exibição imutável na coleção.
IndexOf(Transition, UInt32)	Recupera o índice do item especificado.
InsertAt(UInt32, Transition)	Insere o item especificado no índice especificado.
RemoveAt(UInt32)	Remove o item no índice especificado.
RemoveAtEnd()	Remove o último item da coleção.
ReplaceAll(Transition[])	Inicialmente limpa a coleção e insere a matriz fornecida como novos itens.
SetAt(UInt32, Transition)	Define o valor no índice especificado como o valor de Transição especificado.

Confira também

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