Язык

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 с привязанными свойствами, может потребоваться вручную обновить содержимое, чтобы подготовиться к анимации, так как привязки можно обновлять асинхронно.

Существует известное ограничение, в котором ConnectedAnimation не работает хорошо с переходами тем, имеющими компонент перевода, включая NavigationThemeTransition и EntranceThemeTransition. Рекомендуется удалить эти переходы или отключить навигацию с помощью SuppressNavigationTransitionInfo при создании интерфейса с ConnectedAnimation.

Полный пример connectedAnimation см. в примере анимации ConnectedAnimation .

Свойства

Имя Описание
Configuration

Возвращает или задает конфигурацию, описывающую тип подключенной анимации для воспроизведения.
IsScaleAnimationEnabled

Возвращает или задает значение, указывающее, следует ли использовать компонент масштабирования подключенной анимации.

Методы

Имя Описание
Cancel()

Останавливает подключенную анимацию.
SetAnimationComponent(ConnectedAnimationComponent, ICompositionAnimationBase)

Задает настраиваемую композициюAnimation , чтобы изменить движение определенной части подключенной анимации.
TryStart(UIElement, IIterable<UIElement>)

Пытается запустить анимацию на целевом элементе и указанные вторичные элементы.
TryStart(UIElement)

Пытается запустить анимацию.

События

Имя Описание
Completed

Происходит при завершении анимации.

Применяется к

См. также раздел