ConnectedAnimation クラス

  • リファレンス

定義

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

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

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

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

適用対象

こちらもご覧ください