UIElement.Transitions 属性

  • 参考

定义

命名空间:
Microsoft.UI.Xaml
编辑

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

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>

属性值

TransitionCollection

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

示例

提示

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

打开 WinUI 3 库应用，查看切换效果。

WinUI 3 库应用包括大多数 WinUI 3 控件、特性和功能的交互式示例。 通过 Microsoft Store 获取应用，或在 GitHub 上获取源代码。

下面的 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.ChildTransitions 和 ItemsControl.ItemContainerTransitions。

过渡动画在应用的 UI 设计中发挥着特定作用。 基本思路是，当发生更改或切换时，动画会将用户的注意力吸引到更改。

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

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

适用于

另请参阅