HandoffBehavior Перечисление

Определение

Указывает, как новая анимация взаимодействует с любыми существующими анимациями, которые уже применены к свойству.Specifies how new animations interact with any existing ones that are already applied to a property.

public enum class HandoffBehavior
public enum HandoffBehavior
type HandoffBehavior = 
Public Enum HandoffBehavior
Наследование
HandoffBehavior

Поля

Compose 1

Новые анимации объединяются с существующими путем добавления новых анимаций в конец цепочки композиции.New animations are combined with existing animations by appending the new animations to the end of the composition chain.

SnapshotAndReplace 0

Новые анимации заменяют любые существующие анимации в свойствах, к которым они применяются.New animations replace any existing animations on the properties to which they are applied.

Комментарии

Когда вы Storyboardприменяете AnimationTimeline, или AnimationClock к свойству с помощью инструкции составления Clock , все объекты, ранее связанные с этим свойством, продолжают потреблять системные ресурсы; система времени не будет удалять часы автоматической.When you apply a Storyboard, AnimationTimeline, or AnimationClock to a property by using Compose, any Clock objects previously associated with that property continue to consume system resources; the timing system will not remove the clocks automatically.

Чтобы избежать проблем с производительностью при применении большого количества часов с помощью создания, следует удалить составные часы из анимированного свойства после их завершения.To avoid performance issues when you apply a large number of clocks using Compose, you should remove composing clocks from the animated property after they complete. Существует несколько способов удаления часов.There are several ways to remove a clock:

  • Чтобы удалить все часы из свойства, используйте ApplyAnimationClock(DependencyProperty, AnimationClock) метод или BeginAnimation(DependencyProperty, AnimationTimeline) анимированного объекта.To remove all clocks from a property, use the ApplyAnimationClock(DependencyProperty, AnimationClock) or BeginAnimation(DependencyProperty, AnimationTimeline) method of the animated object. Укажите свойство, которое анимируется как первый параметр, а null в качестве второго.Specify the property being animated as the first parameter, and null as the second. Это удалит из свойства все часы анимации.This will remove all animation clocks from the property.

  • Чтобы AnimationClock удалить определенное значение из списка часов, Controller используйте свойство ClockControllerобъекта AnimationClock для получения, а затем вызовите Remove метод класса ClockController.To remove a specific AnimationClock from a list of clocks, use the Controller property of the AnimationClock to retrieve a ClockController, then call the Remove method of the ClockController. Обычно это делается в Completed обработчике событий для часов.This is typically done in the Completed event handler for a clock. Обратите внимание, что только корневые часы могут управляться ClockController Controller ; свойство дочернего таймера nullвозвращает.Note that only root clocks can be controlled by a ClockController; the Controller property of a child clock returns null. Обратите внимание, Completed что событие не будет вызываться, если фактическая длительность часов бесконечно.Note also that the Completed event will not be raised if the effective duration of the clock is forever. В этом случае пользователь должен определить, когда следует вызывать Remove.In that case, the user must determine when to call Remove.

В основном это проблема для анимации объектов, имеющих длинное время жизни.This is primarily an issue for animations on objects that have a long lifetime. Когда объект собирается как мусор, его часы отсоединяются и также собираются как мусор.When an object is garbage collected, its clocks will also be disconnected and garbage collected.

Дополнительные сведения об объектах часов см. в разделе Общие сведения о анимации и системе управления временем.For more information about clock objects, see Animation and Timing System Overview.

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