UIElement.Transitions プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
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>
プロパティ値
UIElement に適用される Transition スタイル要素の厳密に型指定されたコレクション。
例
ヒント
詳細、設計ガイダンス、およびコード例については、「 Motion」を参照してください。
WinUI 2 ギャラリー アプリがインストールされている場合は、ここをクリックしてアプリを開き、「暗黙的な切り替えとテーマの切り替え」を参照してください。
この 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 構文ガイド」を参照してください。
これは、切り替えで使用できるいくつかの種類の短い一覧です。
- AddDeleteThemeTransition
- ContentThemeTransition
- EdgeUIThemeTransition
- EntranceThemeTransition
- PopupThemeTransition
- ReorderThemeTransition
- RepositionThemeTransition
UIElement から派生した特定のクラスには、クラス固有のシナリオの他の種類の遷移を保持する独自のプロパティがある場合があります。 たとえば、 Popup.ChildTransitions や ItemsControl.ItemContainerTransitions などです。
切り替えアニメーションは、アプリの UI デザインで特定の役割を果たしています。 基本的な考え方は、変更または切り替えがある場合、アニメーションはユーザーの注意をその変更に引き付けるということです。
アプリ UI の直接要素である UIElement で Transitions プロパティの値を直接設定することは一般的ではありません。 画面切り替えコレクションを表示状態、テンプレート、またはスタイルの一部にする方が一般的です。 この場合は、Style の Setter などのメカニズムを使用して Transitions プロパティを指定し、通常は XAML リソースとして格納される XAML 定義コンテンツを使用して値を設定します。
VisualTransition は、UIElement.Transitions コレクションに配置した型の 1 つではありません。 VisualTransition は、ビジュアル状態グループ内のアニメーション専用であり、 VisualStateGroup.Transitions プロパティによって使用されます。