ConnectedAnimation クラス

リファレンス

定義

名前空間:: Windows.UI.Xaml.Media.Animation

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

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

public ref class ConnectedAnimation sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 196608)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ConnectedAnimation final

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 196608)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ConnectedAnimation final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 196608)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class ConnectedAnimation

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 196608)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ConnectedAnimation

Public NotInheritable Class ConnectedAnimation

継承: Object Platform::Object IInspectable ConnectedAnimation

属性: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows の要件

デバイスファミリ	Windows 10 Anniversary Edition (10.0.14393.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v3.0 で導入)

例

ヒント

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

WinUI 2 ギャラリー アプリがインストールされている場合は、ここをクリックしてアプリを開き、「接続済みアニメーションの動作」を参照してください。

注釈

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

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

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

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

バージョン履歴

Windows のバージョン	SDK バージョン	追加された値
1703	15063	IsScaleAnimationEnabled
1703	15063	SetAnimationComponent
1703	15063	TryStart(UIElement,IEnumerable<UIElement>)
1809	17763	構成

プロパティ

Configuration	再生する接続済みアニメーションの種類を記述する構成を取得または設定します。
IsScaleAnimationEnabled	接続されたアニメーションのスケールコンポーネントを使用するかどうかを示す値を取得または設定します。

メソッド

Cancel()	接続されているアニメーションを停止します。
SetAnimationComponent(ConnectedAnimationComponent, ICompositionAnimationBase)	接続されたアニメーションの特定の部分のモーションを変更するカスタム CompositionAnimation を設定します。
TryStart(UIElement)	アニメーションの開始を試みます。
TryStart(UIElement, IIterable<UIElement>)	ターゲット要素と指定されたセカンダリ要素でアニメーションを開始しようとします。

イベント

Completed

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

適用対象

こちらもご覧ください

ConnectedAnimationService

Share via