UIElement.Transitions 属性

定义

获取或设置应用于 UIElementTransition 样式元素的集合。

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>

属性值

应用于 UIElementTransition 样式元素的强类型集合。

示例

提示

有关详细信息、设计指南和代码示例,请参阅 Motion

如果已安装 WinUI 2 库 应用,请单击此处打开该应用,并查看 隐式过渡主题过渡 的运行情况。

此 XAML 示例演示在 Button的样式中定义的单个 EntranceThemeTransition。 过渡动画属性通常在样式和模板中设置,而不是直接在 UI 定义中设置为属性。 样式通常存储为 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>

注解

注意

在 Windows 10 版本 1809 (SDK 17763) 之前,具有 TransitionCollection 值的属性的 XAML 语法要求将显式 TransitionCollection 对象元素声明为值,然后为要使用的每个过渡动画提供对象元素作为 TransitionCollection 的子元素。 在 Windows 10 版本 1809 (SDK 17763) 或更高版本中,TransitionCollection 支持隐式集合用法,因此可以省略集合对象元素。 有关隐式集合和 XAML 的详细信息,请参阅 XAML 语法指南

下面是一些可能的转换类型的简短列表:

派生自 UIElement 的特定类有时有自己的属性,这些属性保存特定于类的方案的其他转换类型。 例如, Popup.ChildTransitionsItemsControl.ItemContainerTransitions

过渡动画在应用的 UI 设计中扮演特定角色。 基本思路是,当发生更改或转换时,动画会将用户的注意力吸引到更改上。

直接在作为应用 UI 的直接元素的 UIElement 上设置 Transitions 属性的值并不常见。 更常见的情况是,将转换集合作为视觉状态、模板或样式的一部分。 在这种情况下,可以使用 Style的资源库等机制来指定 Transitions 属性,并使用通常存储为 XAML 资源的 XAML 定义的内容设置值。

VisualTransition 不是你放入 UIElement.Transitions 集合中的类型之一。 VisualTransition 专用于视觉状态组中的动画,由 VisualStateGroup.Transitions 属性使用。

适用于

另请参阅