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 スタイル要素の厳密に型指定されたコレクション。
例
Tip
詳細、設計ガイダンス、およびコード例については、「 Motion」を参照してください。
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>
注釈
Note
Windows 10バージョン 1809 (SDK 17763) より前のバージョンでは、TransitionCollection 値を持つプロパティの XAML 構文では、明示的な TransitionCollection オブジェクト要素を値として宣言し、使用する遷移アニメーションごとに TransitionCollection の子要素としてオブジェクト要素を指定する必要があります。 Windows 10 バージョン 1809 (SDK 17763) 以降では、TransitionCollection は暗黙的なコレクションの使用をサポートしているため、コレクション オブジェクト要素を省略できます。 暗黙的なコレクションと XAML の詳細については、 XAML 構文ガイドを参照してください。
切り替えに使用できるいくつかの種類の簡単な一覧を次に示します。
- AddDeleteThemeTransition
- ContentThemeTransition
- EdgeUIThemeTransition
- EntranceThemeTransition
- PopupThemeTransition
- ReorderThemeTransition
- RepositionThemeTransition
UIElement から派生する特定のクラスには、クラス固有のシナリオの他の種類の遷移を保持する独自のプロパティがある場合があります。 たとえば、 Popup.ChildTransitions や ItemsControl.ItemContainerTransitions などです。
切り替えアニメーションは、アプリの UI デザインで特定の役割を果たします。 基本的な考え方は、変更または遷移がある場合、アニメーションはユーザーの注意を変更に引き付けるということです。
アプリ UI の直接要素である UIElement でTransitions プロパティの値を直接設定することは一般的ではありません。 画面切り替えコレクションを表示状態、テンプレート、またはスタイルの一部にする方が一般的です。 この場合は、スタイルのセッターなどのメカニズムを使用してTransitionsプロパティを指定し、通常は XAML リソースとして格納される XAML で定義されたコンテンツを使用して値を設定します。
VisualTransition は、 UIElement.Transitions コレクションに配置する型の 1 つではありません。
VisualTransition は、特にビジュアル状態グループ内のアニメーション用であり、 VisualStateGroup.Transitions プロパティによって使用されます。