ImplicitAnimationCollection Класс

Ссылка

Определение

Пространство имен:: Windows.UI.Composition

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Изменить

Коллекция анимаций, активируется при выполнении условия.

public ref class ImplicitAnimationCollection sealed : CompositionObject, IIterable<IKeyValuePair<Platform::String ^, ICompositionAnimationBase ^> ^>, IMap<Platform::String ^, ICompositionAnimationBase ^>

/// [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 ImplicitAnimationCollection final : CompositionObject, IIterable<IKeyValuePair<winrt::hstring, ICompositionAnimationBase const&>>, IMap<winrt::hstring, ICompositionAnimationBase const&>

[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 ImplicitAnimationCollection : CompositionObject, IDictionary<string,ICompositionAnimationBase>, IEnumerable<KeyValuePair<string,ICompositionAnimationBase>>

Public NotInheritable Class ImplicitAnimationCollection
Inherits CompositionObject
Implements IDictionary(Of String, ICompositionAnimationBase), IEnumerable(Of KeyValuePair(Of String, ICompositionAnimationBase))

Наследование: Object Platform::Object IInspectable CompositionObject ImplicitAnimationCollection

Атрибуты: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Реализации: IDictionary<String,ICompositionAnimationBase> IMap<Platform::String,ICompositionAnimationBase> IMap<winrt::hstring,ICompositionAnimationBase> IIterable<IKeyValuePair<K,V>> IEnumerable<KeyValuePair<K,V>> IEnumerable<KeyValuePair<String,ICompositionAnimationBase>> IIterable<IKeyValuePair<Platform::String,ICompositionAnimationBase>> IIterable<IKeyValuePair<winrt::hstring,ICompositionAnimationBase>>

Требования к Windows

Семейство устройств	Windows 10 Anniversary Edition (появилось в 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v3.0)

Примеры

class PropertyAnimation 
{ 
  PropertyAnimation(Compositor compositor, SpriteVisual heroVisual, SpriteVisual listVisual) 
  { 
    // Define ImplicitAnimationCollection 
    ImplicitAnimationCollection implicitAnimations = compositor.CreateImplicitAnimationCollection(); 

    // Trigger animation when the “Offset” property changes. 
    implicitAnimations["Offset"] = CreateAnimation(compositor); 

    // Assign ImplicitAnimations to a visual. Unlike Visual.Children,     
    // ImplicitAnimations can be shared by multiple visuals so that they  
    // share the same implicit animation behavior (same as Visual.Clip). 
    heroVisual.ImplicitAnimations = implicitAnimations; 

    // ImplicitAnimations can be shared among visuals  
    listVisual.ImplicitAnimations = implicitAnimations; 

    listVisual.Offset = new Vector3(20f, 20f, 20f); 
  } 

  Vector3KeyFrameAnimation CreateAnimation(Compositor compositor) 
  { 
    Vector3KeyFrameAnimation animation = compositor.CreateVector3KeyFrameAnimation(); 
    animation.InsertExpressionKeyFrame(0f, "this.StartingValue"); 
    animation.InsertExpressionKeyFrame(1f, "this.FinalValue"); 
    animation.Target = “Offset”; 
    animation.Duration = TimeSpan.FromSeconds(0.25); 
    return animation; 
  } 
}

Неявные анимации позволяют управлять анимацией, указывая условия триггера, а не требуя ручного определения поведения анимации. Они помогают отделить логику запуска анимации от основной логики приложения. Вы определяете анимации и события, которые должны активировать эти анимации. Затем компонатор выполняет анимацию набора при соблюдении соответствующих условий триггера.

Триггеры

Условие выступает в качестве триггеров для ImplicitAnimationCollection. Эти триггеры являются анимируемыми свойствами CompositionObject. Для юбилейного обновления Windows 10 в качестве триггеров поддерживаются только анимируемые свойства Visual.

this.FinalValue

Это специальная ключевое слово в системе выражений композиции, которую разработчики могут использовать для создания шаблонов анимации и привязки платформы к значению API целевого свойства.

Анимации будут поддерживать эту функцию. FinalValue ключевое слово в качестве допустимого ключевое слово для обозначения конечного значения целевого свойства для анимации.

Неявные анимации — это. Параметру FinalValue будет присвоено последнее значение, которому было напрямую назначено соответствующее целевое свойство. Например, если свойству Offset визуального элемента присваивается напрямую, это будет иметь неявная анимация, предназначенная для свойства Offset. Параметру FinalValue присваивается новое значение Offset типа Vector3. Другие неявные анимации, предназначенные для различных свойств, например Size , по-прежнему смогут использовать эту функцию. FinalValue в шаблоне, и в этом случае это. Параметру FinalValue будет присвоено текущее значение свойства Size типа Vector2. Обратите внимание, что в последнем случае это. Параметр FinalValue будет таким же , как и этот. StartingValue . Это обеспечивает четко определенное поведение и позволяет разработчикам легко создавать шаблоны анимации . FinalValue всегда будет разрешаться в допустимое значение, независимо от того, какое свойство вызвало изменение.
Явные анимации. По умолчанию она будет иметь то же поведение, что и случай неявной анимации, где это. Параметру FinalValue будет присвоено последнее значение, которое было задано свойству напрямую. Например, анимации, предназначенные для свойства Size , будут иметь этот параметр. FinalValue разрешается до последнего известного значения Size на уровне API. Другими словами, это. Параметр FinalValue будет таким же , как и этот. StartingValue . Разработчик сможет переопределить это поведение и задать его. FinalValue имеет другое значение, явно задав его в качестве параметра анимации.

События и целевые свойства для ImplicitAnimationCollection и CompositionAnimationGroup

ImplicitAnimationCollection позволяет добавлять триггеры, которые будут отслеживать изменения и запускать связанные анимации, предоставленные разработчиком. ImplicitAnimationCollection поддерживает все анимируемые свойства Visual, которые также используются в качестве целевых свойств для анимации. Целевой объект должен быть определен в анимации, иначе это вызовет исключение.

implicitAnimationCollection[“Offset”] = offsetAnimationGroup;

CompositionAnimationGroup содержит список CompositionAnimation , где их можно активировать как одну логическую единицу. Каждому объекту CompositionAnimation в группе должно быть задано целевое свойство.

CompositionAnimationGroup.Add(opacityKeyFrameAnimation);
CompositionAnimationGroup.Insert(sizeKeyFrameAnimation);

ImplicitAnimationCollection поддерживает следующие свойства в Visual:

AnchorPoint (Точка привязки)
CenterPoint (Центральная точка)
Offset
Непрозрачность
Ориентация
RotationAngle (Угол поворота)
RotationAngleInDegrees (Угол поворота в градусах)
RotationAxis (Ось поворота)
Масштабирование
Размер Если то же значение задано снова, анимация не будет выполняться, так как не было разницы между предыдущим и новым значением.

Свойства

Comment	Строка, связанная с CompositionObject. (Унаследовано от CompositionObject)
Compositor	Составитель, используемый для создания этого объекта CompositionObject. (Унаследовано от CompositionObject)
Dispatcher	Диспетчер для CompositionObject. (Унаследовано от CompositionObject)
DispatcherQueue	Возвращает dispatcherQueue для объекта CompostionObject. (Унаследовано от CompositionObject)
ImplicitAnimations	Коллекция неявных анимаций, присоединенных к этому объекту. (Унаследовано от CompositionObject)
Properties	Коллекция свойств, связанных с CompositionObject. (Унаследовано от CompositionObject)
Size	Размер коллекции.

Методы

Clear()	Удаляет все анимации из коллекции.
Close()	Закрывает объект CompositionObject и освобождает системные ресурсы. (Унаследовано от CompositionObject)
ConnectAnimation(String, CompositionAnimation)	Соединения и анимация. (Унаследовано от CompositionObject)
DisconnectAnimation(String)	Отключает анимацию. (Унаследовано от CompositionObject)
Dispose()	Выполняет определяемые приложением задачи, связанные с удалением, высвобождением или сбросом неуправляемых ресурсов. (Унаследовано от CompositionObject)
First()	Извлекает первую анимацию в коллекции.
GetView()	Возвращает представление карты коллекции.
HasKey(String)	Возвращает логическое значение, указывающее, содержит ли коллекция указанный ключ.
Insert(String, ICompositionAnimationBase)	Вставляет анимацию в коллекцию.
Lookup(String)	Извлекает анимацию, связанную с указанным свойством.
PopulatePropertyInfo(String, AnimationPropertyInfo)	Определяет свойство, которое можно анимировать. (Унаследовано от CompositionObject)
Remove(String)	Удаляет указанную анимацию из коллекции.
StartAnimation(String, CompositionAnimation)	Подключает анимацию к указанному свойству объекта и запускает анимацию. (Унаследовано от CompositionObject)
StartAnimation(String, CompositionAnimation, AnimationController)	Подключает анимацию к указанному свойству объекта и запускает анимацию. (Унаследовано от CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)	Запускает группу анимации. Метод StartAnimationGroup в CompositionObject позволяет запустить CompositionAnimationGroup. Все анимации в группе будут запущены одновременно для объекта . (Унаследовано от CompositionObject)
StopAnimation(String)	Отключает анимацию от указанного свойства и останавливает анимацию. (Унаследовано от CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)	Останавливает группу анимации. (Унаследовано от CompositionObject)
TryGetAnimationController(String)	Возвращает AnimationController для анимации, выполняемой с указанным свойством. (Унаследовано от CompositionObject)

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