UIElement.Transitions Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene o establece la colección de elementos de estilo Transition que se aplican a un 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>
Valor de propiedad
Colección fuertemente tipada de elementos de estilo Transition que se aplican a un UIElement.
Ejemplos
Sugerencia
Para obtener más información, instrucciones de diseño y ejemplos de código, consulta Motion.
La aplicación WinUI 3 Gallery incluye ejemplos interactivos de la mayoría de los controles, las características y la funcionalidad de WinUI 3. Obtenga la aplicación en Microsoft Store u obtenga el código fuente en GitHub.
En el ejemplo XAML siguiente se muestra una única EntradaThemeTransition tal y como se define en un estilo para un botón. Las propiedades de animación de transición normalmente se establecen en estilos y plantillas en lugar de como propiedades directamente en una definición de interfaz de usuario. Normalmente, los estilos se almacenan como un recurso 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>
Comentarios
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 object 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 implícito de la colección, 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.
Esta es una breve lista de algunos de los posibles tipos de transiciones:
- AddDeleteThemeTransition
- ContentThemeTransition
- EdgeUIThemeTransition
- EntranceThemeTransition
- PopupThemeTransition
- ReorderThemeTransition
- RepositionThemeTransition
Las clases específicas que derivan de UIElement a veces tienen sus propias propiedades que contienen otros tipos de transiciones para escenarios específicos de clase. Por ejemplo, Popup.ChildTransitions y ItemsControl.ItemContainerTransitions.
Las animaciones de transición desempeñan un papel particular en el diseño de la interfaz de usuario de la aplicación. La idea básica es que cuando hay un cambio o una transición, la animación llama la atención del usuario al cambio.
No es habitual establecer el valor de la Transitions
propiedad directamente en un UIElement que es un elemento directo de la interfaz de usuario de la aplicación. Es más habitual que una colección de transiciones forme parte de un estado visual, una plantilla o un estilo. En este caso, usas mecanismos como Establecedor de un estilo para especificar la Transitions
propiedad y estableces el valor mediante contenido definido por XAML que normalmente se almacena como un recurso XAML.
VisualTransition no es uno de los tipos que se colocan en la UIElement.Transitions
colección.
VisualTransition
es específicamente para animaciones en grupos de estado visual y se usa en la propiedad VisualStateGroup.Transitions .