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樣式專案的強型別集合。

範例

提示

如需詳細資訊、設計指引和程式碼範例，請參閱 動作。

開啟 WinUI 3 資源庫應用程式，並查看轉換運作情形。

WinUI 3 資源庫應用程式包含大部分 WinUI 3 控制項、特性和功能的互動式範例。 從 Microsoft Store 取得應用程式，或在 GitHub上取得原始程式碼。

下列 XAML 範例顯示單一的 EntranceThemeTransition，如Button的Style中所定義。 轉換動畫屬性通常會以樣式和範本設定，而不是直接在 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的直接元素上設定屬性的值 Transitions 並不常見。 轉換集合是視覺狀態、範本或樣式的一部分比較常見。 在此情況下，您會使用Style的Setter之類的機制來指定 Transitions 屬性，並使用通常儲存為 XAML 資源的 XAML 定義內容來設定值。

VisualTransition 不是您在集合中 UIElement.Transitions 放置的其中一種類型。 VisualTransition 特別適用于視覺狀態群組中的動畫，而且由 VisualStateGroup.Transitions 屬性使用。

適用於

另請參閱