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 のスタイルで定義されている 1 つの 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 Version 1809 (SDK 17763) より前のバージョンでは、TransitionCollection 値を持つプロパティの XAML 構文では、明示的な TransitionCollection オブジェクト要素を値として宣言し、使用する各遷移アニメーションに対して TransitionCollection の子要素としてオブジェクト要素を指定する必要があります。 Windows 10 Version 1809 (SDK 17763) 以降では、TransitionCollection は暗黙的なコレクションの使用をサポートしているため、コレクション オブジェクト要素を省略できます。 暗黙的なコレクションと XAML の詳細については、「 XAML 構文ガイド」を参照してください。

これは、切り替えで使用できるいくつかの種類の短い一覧です。

UIElement から派生した特定のクラスには、クラス固有のシナリオの他の種類の遷移を保持する独自のプロパティがある場合があります。 たとえば、 Popup.ChildTransitions や ItemsControl.ItemContainerTransitions などです。

切り替えアニメーションは、アプリの UI デザインで特定の役割を果たしています。 基本的な考え方は、変更または切り替えがある場合、アニメーションはユーザーの注意をその変更に引き付けるということです。

アプリ UI の直接要素である UIElement でプロパティのTransitions値を直接設定することは一般的ではありません。 画面切り替えコレクションを表示状態、テンプレート、またはスタイルの一部にする方が一般的です。 この場合は、 Setter of a Style などのメカニズムを使用して プロパティを Transitions 指定し、通常は XAML リソースとして格納される XAML 定義コンテンツを使用して値を設定します。

VisualTransition は、コレクションに配置 UIElement.Transitions した型の 1 つではありません。 VisualTransition は、ビジュアル状態グループ内のアニメーション専用であり、 VisualStateGroup.Transitions プロパティによって使用されます。

適用対象

こちらもご覧ください