言語

ConnectedAnimation クラス

定義

名前空間:
Microsoft.UI.Xaml.Media.Animation
編集

ある要素の終了と別の要素の入り口を同時にアニメーション化するアニメーションを表します。

public ref class ConnectedAnimation sealed
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ConnectedAnimation final
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ConnectedAnimation
Public NotInheritable Class ConnectedAnimation
継承
Object Platform::Object IInspectable ConnectedAnimation
属性
ContractVersionAttribute MarshalingBehaviorAttribute

例

Tip

詳細、設計ガイダンス、およびコード例については、「 接続されたアニメーション」を参照してください。

WinUI 3 ギャラリー アプリを開き、ConnectedAnimation の動作を確認する

WinUI 3 ギャラリー アプリには、ほとんどの WinUI 3 コントロールと機能の対話型の例が含まれています。 Microsoft Store からアプリを取得するか、GitHub でソース コードを取得します。

注釈

ConnectedAnimation インスタンスは、 ConnectedAnimationService.GetAnimation メソッドと ConnectedAnimationService.PrepareToAnimate メソッドによって返されます。

TryStart を呼び出すとき、メソッドに渡す要素のサイズはレイアウトで定義されている必要があります。 つまり、XAML フレームワークでサイズを計算できるように、要素のサイズをマークアップで設定するか、要素の内容を完全に設定する必要があります。 レイアウトがバインドされたプロパティを持つ ListView または GridView 項目の一部である場合は、バインドを非同期的に更新できるため、アニメーションの準備のためにコンテンツを手動で更新する必要がある場合があります。

NavigationThemeTransition や EntranceThemeTransition などの翻訳コンポーネントを持つテーマの切り替えでは、ConnectedAnimation がうまく機能しないという既知の制限があります。 ConnectedAnimation でエクスペリエンスを作成するときは、これらの遷移を削除するか、 SuppressNavigationTransitionInfo を使用してナビゲーションを抑制することをお勧めします。

ConnectedAnimation の完全な例については、 Connected アニメーションのサンプル を参照してください。

プロパティ

名前 説明
Configuration

再生する接続済みアニメーションの種類を記述する構成を取得または設定します。
IsScaleAnimationEnabled

接続されたアニメーションのスケール コンポーネントを使用するかどうかを示す値を取得または設定します。

メソッド

名前 説明
Cancel()

接続されているアニメーションを停止します。
SetAnimationComponent(ConnectedAnimationComponent, ICompositionAnimationBase)

接続されたアニメーションの特定の部分のモーションを変更するカスタム CompositionAnimation を設定します。
TryStart(UIElement, IIterable<UIElement>)

ターゲット要素と指定したセカンダリ要素でアニメーションを開始しようとします。
TryStart(UIElement)

アニメーションの開始を試みます。

イベント

名前 説明
Completed

アニメーションが完了したときに発生します。

適用対象

こちらもご覧ください