ConnectedAnimation 클래스

정의

한 요소의 종료와 다른 요소의 입구에 동시에 애니메이션 효과를 주는 애니메이션을 나타냅니다.

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
특성

Windows 요구 사항

디바이스 패밀리
Windows 10 Anniversary Edition (10.0.14393.0에서 도입되었습니다.)
API contract
Windows.Foundation.UniversalApiContract (v3.0에서 도입되었습니다.)

예제

자세한 정보, 디자인 지침 및 코드 예제는 연결된 애니메이션을 참조하세요.

WinUI 2 갤러리 앱이 설치되어 있는 경우 여기를 클릭하여 앱을 열고 작동하는 연결된 애니메이션을 확인합니다.

설명

ConnectedAnimation instance ConnectedAnimationService.GetAnimationConnectedAnimationService.PrepareToAnimate 메서드에 의해 반환됩니다.

TryStart를 호출할 때 메서드에 전달하는 요소의 크기가 레이아웃에 정의되어 있어야 합니다. 즉, XAML 프레임워크에서 해당 크기를 계산할 수 있도록 요소의 크기를 태그로 설정하거나 요소의 내용을 완전히 채워야 합니다. 레이아웃이 바인딩된 속성이 있는 ListView 또는 GridView 항목의 일부인 경우 바인딩을 비동기적으로 업데이트할 수 있으므로 애니메이션을 준비하기 위해 콘텐츠를 수동으로 업데이트해야 할 수 있습니다.

ConnectedAnimation이 NavigationThemeTransition 및 EntranceThemeTransition 을 포함하여 번역 구성 요소가 있는 테마 전환에서 제대로 작동하지 않는 알려진 제한 사항이 있습니다. ConnectedAnimation 환경을 만들 때 이러한 전환을 제거하거나 SuppressNavigationTransitionInfo를 사용하여 탐색을 표시하지 않는 것이 좋습니다.

ConnectedAnimation의 전체 예제는 연결된 애니메이션 샘플을 참조하세요.

버전 기록

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

애니메이션이 완료되면 발생합니다.

적용 대상

추가 정보