TransitionCollection Clase

Definición

Espacio de nombres:

Windows.UI.Xaml.Media.Animation

Representa una colección de objetos Transition . Cada objeto Transition representa una transición de tema diferente, parte de la biblioteca de animaciones de 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>

Herencia

Object Platform::Object IInspectable TransitionCollection

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementaciones

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

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Ejemplos

En este ejemplo se muestra la sintaxis XAML para establecer un elemento de objeto TransitionCollection como parte del establecimiento de la propiedad UIElement.Transitions insertada.

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

Comentarios

TransitionCollection se usa como tipo de valor para estas propiedades:

• Border.ChildTransitions
• ContentControl.ContentTransitions (en controles de contenido como Button o AppBar)
• ContentPresenter.ContentTransitions
• ItemsControl.ItemContainerTransitions (en controles de elementos como GridView, ListBox, ListView y Selector)
• ItemsPresenter.FooterTransitions
• ItemsPresenter.HeaderTransitions
• ListViewBase.FooterTransitions
• ListViewBase.HeaderTransitions
• Panel.ChildrenTransitions (en Grid, StackPanel y otros paneles)
• Popup.ChildTransitions
• SettingsFlyoutTemplateSettings.ContentTransitions
• UIElement.Transitions (en cientos de clases)

Nota:

Antes de Windows 10, versión 1809 (SDK 17763), la sintaxis XAML de las propiedades que tienen un valor TransitionCollection requiere que declares un elemento de objeto TransitionCollection explícito como valor y, a continuación, proporcione elementos de objeto como elementos secundarios de TransitionCollection para cada una de las animaciones de transición que quieras usar. En Windows 10, versión 1809 (SDK 17763) o posterior, TransitionCollection admite el uso de la colección implícita, por lo que puede omitir el elemento de objeto de colección. Para obtener más información sobre colecciones implícitas y XAML, consulta la guía de sintaxis XAML.

Las animaciones de transición son animaciones preconfiguradas de la biblioteca de animaciones de Windows Runtime. Las animaciones de transición se ejecutan automáticamente en las condiciones a las que está asociada la animación de transición, utilizando el propietario de la propiedad donde transitionCollection se establece como destino. Las propiedades que se animan varían en función de la transición que use.

VisualStateGroup.Transitions no usa el tipo TransitionCollection. VisualStateGroup.Transitions usa una colección integrada (lista o vector) de objetos VisualTransition .

Enumeración de la colección en C# o Microsoft Visual Basic

TransitionCollection es enumerable, por lo que puede usar sintaxis específica del lenguaje, como foreach en C# para enumerar los elementos de la colección. El compilador realiza la conversión de tipos automáticamente y no es necesario convertir a IEnumerable<Transition> explícitamente. Si necesita convertir explícitamente, por ejemplo, si desea llamar a GetEnumerator, convierta a IEnumerable<T> con una restricción Transition .

Constructores

TransitionCollection()

Inicializa una nueva instancia de la clase TransitionCollection .

Propiedades

Size	Obtiene el tamaño (recuento) de la colección.

Métodos

Append(Transition)	Agrega un nuevo elemento a la colección.
Clear()	Quita todos los elementos de la colección.
First()	Devuelve el iterador para la iteración sobre los elementos de la colección.
GetAt(UInt32)	Devuelve el elemento ubicado en el índice especificado.
GetMany(UInt32, Transition[])	Recupera varios elementos en un solo paso a través del iterador.
GetView()	Obtiene una vista inmutable en la colección.
IndexOf(Transition, UInt32)	Recupera el índice del elemento especificado.
InsertAt(UInt32, Transition)	Inserta el elemento especificado en el índice especificado.
RemoveAt(UInt32)	Quita el elemento del índice especificado.
RemoveAtEnd()	Quita el último elemento de la colección.
ReplaceAll(Transition[])	Inicialmente borra la colección y, a continuación, inserta la matriz proporcionada como nuevos elementos.
SetAt(UInt32, Transition)	Establece el valor en el índice especificado en el valor Transition especificado.

Consulte también

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