DoubleAnimation Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
public ref class DoubleAnimation : System::Windows::Media::Animation::DoubleAnimationBase
public class DoubleAnimation : System.Windows.Media.Animation.DoubleAnimationBase
type DoubleAnimation = class
inherit DoubleAnimationBase
Public Class DoubleAnimation
Inherits DoubleAnimationBase
- Наследование
Комментарии
Анимация обновляет значение свойства за период времени. Эффект анимации может быть тонким, например перемещением Shape нескольких пикселей влево и вправо, или драматическим, например увеличением объекта до 200 раз в исходном размере при его спиннинге и изменении цвета. Чтобы создать анимацию в Windows Presentation Foundation (WPF), необходимо связать анимацию со значением свойства объекта.
Целевые значения
Класс DoubleAnimation создает переход между двумя целевыми значениями. Чтобы задать целевые значения, используйте его FromToи By свойства. В следующей таблице показано, как FromToсвойства и By свойства могут использоваться вместе или отдельно для определения целевых значений анимации.
| Указанные свойства | Результирующее поведение |
|---|---|
| From | Анимация выполняется от значения, указанного From свойством, к базовому значению свойства, анимируемого или к выходному значению предыдущей анимации, в зависимости от того, как настроена предыдущая анимация. |
| From и To. | Анимация выполняется от значения, указанного From свойством, к значению, указанному свойством To . |
| From и By. | Анимация выполняется от значения, указанного свойством, к значению, указанному From суммой From и By свойствами. |
| To | Анимация выполняется от базового значения анимированного свойства или выходного значения предыдущей анимации к значению, указанному свойством To . |
| By | Анимация выполняется от базового значения свойства, анимированного или выходного значения предыдущей анимации до суммы этого значения и значения, указанного свойством By . |
Чтобы использовать другие методы интерполяции или анимировать между более чем двумя целевыми значениями, используйте DoubleAnimationUsingKeyFrames объект.
Бесплатные функции
DoubleAnimation Поскольку класс наследует от Freezableобъектов, DoubleAnimation объекты получают несколько специальных функций, которые включают в себя следующие: они могут быть объявлены как ресурсы, совместно используемые для нескольких объектов, сделать доступными только для чтения, чтобы повысить производительность, клонированные и сделать потокобезопасной. Дополнительные сведения о различных функциях, предоставляемых Freezable объектами, см. в обзоре объектов Freezable.
Конструкторы
| Имя | Описание |
|---|---|
| DoubleAnimation() |
Инициализирует новый экземпляр класса DoubleAnimation. |
| DoubleAnimation(Double, Double, Duration, FillBehavior) |
Инициализирует новый экземпляр DoubleAnimation класса, который анимирует из указанного начального значения в указанное целевое значение в течение указанной длительности и имеет указанное поведение заполнения. |
| DoubleAnimation(Double, Double, Duration) |
Инициализирует новый экземпляр класса, который анимирует от указанного DoubleAnimation начального значения до указанного целевого значения в течение указанной длительности. |
| DoubleAnimation(Double, Duration, FillBehavior) |
Инициализирует новый экземпляр DoubleAnimation класса, который анимирует указанное значение в течение указанной длительности и имеет указанное поведение заполнения. Начальное значение анимации — это базовое значение анимируемого свойства или выходные данные из другой анимации. |
| DoubleAnimation(Double, Duration) |
Инициализирует новый экземпляр DoubleAnimation класса, который анимирует указанное значение в течение указанной длительности. Начальное значение анимации — это базовое значение анимируемого свойства или выходные данные из другой анимации. |
Поля
| Имя | Описание |
|---|---|
| ByProperty |
Определяет By свойство зависимостей. |
| EasingFunctionProperty |
Определяет EasingFunction свойство зависимостей. |
| FromProperty |
Определяет From свойство зависимостей. |
| ToProperty |
Определяет To свойство зависимостей. |
Свойства
| Имя | Описание |
|---|---|
| AccelerationRatio |
Возвращает или задает значение, указывающее процент времени, потраченного временной шкалой Duration , ускоряя время от нуля до максимальной скорости. (Унаследовано от Timeline) |
| AutoReverse |
Возвращает или задает значение, указывающее, воспроизводится ли временная шкала в обратном порядке после завершения итерации вперед. (Унаследовано от Timeline) |
| BeginTime |
Возвращает или задает время начала этого Timeline действия. (Унаследовано от Timeline) |
| By |
Возвращает или задает общую сумму, с помощью которой анимация изменяет начальное значение. |
| CanFreeze |
Возвращает значение, указывающее, можно ли изменить объект. (Унаследовано от Freezable) |
| DecelerationRatio |
Возвращает или задает значение, указывающее процент времени, затраченного временной шкалой Duration на уменьшение времени от максимальной скорости до нуля. (Унаследовано от Timeline) |
| DependencyObjectType |
Возвращает объект DependencyObjectType , который упаковывает тип СРЕДЫ CLR этого экземпляра. (Унаследовано от DependencyObject) |
| Dispatcher |
Dispatcher Возвращает это DispatcherObject значение, с которым связано. (Унаследовано от DispatcherObject) |
| Duration |
Возвращает или задает продолжительность времени, в течение которого эта временная шкала воспроизводится, не подсчитывая повторения. (Унаследовано от Timeline) |
| EasingFunction |
Возвращает или задает функцию упрощения, примененную к этой анимации. |
| FillBehavior |
Возвращает или задает значение, указывающее Timeline поведение после окончания его активного периода. (Унаследовано от Timeline) |
| From |
Возвращает или задает начальное значение анимации. |
| HasAnimatedProperties |
Возвращает значение, указывающее, связан ли один или несколько AnimationClock объектов с любым из свойств зависимостей этого объекта. (Унаследовано от Animatable) |
| IsAdditive |
Возвращает или задает значение, указывающее, следует ли добавить текущее значение целевого свойства в начальное значение этой анимации. |
| IsCumulative |
Возвращает или задает значение, указывающее, накапливается ли значение анимации при повторе. |
| IsDestinationDefault |
Возвращает значение, указывающее, использует ли эта анимация параметр defaultDestinationValue метода в качестве целевого GetCurrentValue(Object, Object, AnimationClock) значения. (Унаследовано от AnimationTimeline) |
| IsFrozen |
Возвращает значение, указывающее, является ли объект изменяемым в настоящее время. (Унаследовано от Freezable) |
| IsSealed |
Возвращает значение, указывающее, запечатан ли этот экземпляр (только для чтения). (Унаследовано от DependencyObject) |
| Name |
Возвращает или задает имя этого Timelineпараметра. (Унаследовано от Timeline) |
| RepeatBehavior |
Возвращает или задает повторяющееся поведение этой временной шкалы. (Унаследовано от Timeline) |
| SpeedRatio |
Возвращает или задает частоту относительно родительского элемента, в течение которого выполняется для этого Timeline. (Унаследовано от Timeline) |
| TargetPropertyType |
Возвращает тип значения, создаваемого этой анимацией. (Унаследовано от DoubleAnimationBase) |
| To |
Возвращает или задает конечное значение анимации. |
Методы
| Имя | Описание |
|---|---|
| AllocateClock() |
Clock Создает для этого AnimationTimeline. (Унаследовано от AnimationTimeline) |
| ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior) |
Применяется к указанному объекту AnimationClockDependencyProperty. Если свойство уже анимировано, используется указанный HandoffBehavior параметр. (Унаследовано от Animatable) |
| ApplyAnimationClock(DependencyProperty, AnimationClock) |
Применяется к указанному объекту AnimationClockDependencyProperty. Если свойство уже анимировано, SnapshotAndReplace используется поведение передачи. (Унаследовано от Animatable) |
| BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) |
Применяет анимацию к указанному DependencyProperty. Анимация запускается при отрисовки следующего кадра. Если указанное свойство уже анимировано, используется указанный HandoffBehavior параметр. (Унаследовано от Animatable) |
| BeginAnimation(DependencyProperty, AnimationTimeline) |
Применяет анимацию к указанному DependencyProperty. Анимация запускается при отрисовки следующего кадра. Если указанное свойство уже анимировано, SnapshotAndReplace используется поведение передачи. (Унаследовано от Animatable) |
| CheckAccess() |
Определяет, имеет ли вызывающий поток доступ к этому DispatcherObject. (Унаследовано от DispatcherObject) |
| ClearValue(DependencyProperty) |
Очищает локальное значение свойства. Свойство для очистки указывается идентификатором DependencyProperty . (Унаследовано от DependencyObject) |
| ClearValue(DependencyPropertyKey) |
Очищает локальное значение свойства только для чтения. Свойство, которое необходимо очистить, задается параметром DependencyPropertyKey. (Унаследовано от DependencyObject) |
| Clone() |
Создает модификаторный клон этого DoubleAnimationобъекта, делая глубокие копии значений этого объекта. При копировании свойств зависимостей этот метод копирует ссылки на ресурсы и привязки данных (но они больше не могут разрешаться), но не анимации или их текущие значения. |
| CloneCore(Freezable) |
Делает экземпляр клоном (глубокой копией) указанных Freezable значений свойств с использованием базовых (не анимированных) значений свойств. (Унаследовано от Freezable) |
| CloneCurrentValue() |
Создает модификаторный клон этого объекта, делая глубокие копии текущих значений этого Timeline объекта. (Унаследовано от Timeline) |
| CloneCurrentValueCore(Freezable) |
Делает экземпляр модификируемым клоном (глубокой копией) указанного Freezable с использованием текущих значений свойств. (Унаследовано от Freezable) |
| CoerceValue(DependencyProperty) |
Принуждает значение указанного свойства зависимостей. Это достигается путем вызова любой CoerceValueCallback функции, указанной в метаданных свойств для свойства зависимостей, так как он существует при вызове DependencyObject. (Унаследовано от DependencyObject) |
| CreateClock() |
Создает новое из AnimationClock этого AnimationTimeline. (Унаследовано от AnimationTimeline) |
| CreateClock(Boolean) |
Создает новое из Clock этого Timeline и указывает, можно ли управлять новым Clock . Если у него Timeline есть дочерние элементы, дерево часов создается в Timeline качестве корневого элемента. (Унаследовано от Timeline) |
| CreateInstance() |
Инициализирует новый экземпляр класса Freezable. (Унаследовано от Freezable) |
| CreateInstanceCore() |
Создает новый экземпляр DoubleAnimationобъекта . |
| Equals(Object) |
Определяет, эквивалентен ли предоставленный DependencyObject объект текущему DependencyObject. (Унаследовано от DependencyObject) |
| Freeze() |
Делает текущий объект неизменяемым и задает для свойства значение IsFrozen |
| FreezeCore(Boolean) |
Делает это Timeline неизменяемым или определяет, может ли он быть изменен. (Унаследовано от Timeline) |
| GetAnimationBaseValue(DependencyProperty) |
Возвращает неанимированное значение указанного DependencyProperty. (Унаследовано от Animatable) |
| GetAsFrozen() |
Создает замороженную копию базовых Freezable(не анимированных) значений свойств. Так как копия заморожена, все замороженные вложенные объекты копируются по ссылке. (Унаследовано от Freezable) |
| GetAsFrozenCore(Freezable) |
Делает этот экземпляр клоном указанного Timeline объекта. (Унаследовано от Timeline) |
| GetCurrentValue(Double, Double, AnimationClock) |
Возвращает текущее значение анимации. (Унаследовано от DoubleAnimationBase) |
| GetCurrentValue(Object, Object, AnimationClock) |
Возвращает текущее значение анимации. (Унаследовано от DoubleAnimationBase) |
| GetCurrentValueAsFrozen() |
Создает замороженную копию с использованием текущих значений Freezable свойств. Так как копия заморожена, все замороженные вложенные объекты копируются по ссылке. (Унаследовано от Freezable) |
| GetCurrentValueAsFrozenCore(Freezable) |
Делает этот экземпляр замороженным клоном указанного.Timeline Ссылки на ресурсы, привязки данных и анимации не копируются, но их текущие значения. (Унаследовано от Timeline) |
| GetCurrentValueCore(Double, Double, AnimationClock) |
Вычисляет значение, представляющее текущее значение анимируемого свойства, как определено DoubleAnimation. |
| GetHashCode() |
Получает хэш-код для этого DependencyObject. (Унаследовано от DependencyObject) |
| GetLocalValueEnumerator() |
Создает специализированный перечислитель для определения того, какие свойства зависимостей имеют локальные значения для этого DependencyObject. (Унаследовано от DependencyObject) |
| GetNaturalDuration(Clock) |
Возвращает длину одной итерации этого Timeline. (Унаследовано от Timeline) |
| GetNaturalDurationCore(Clock) |
Возвращает длину одной итерации этого AnimationTimeline. (Унаследовано от AnimationTimeline) |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| GetValue(DependencyProperty) |
Возвращает текущее эффективное значение свойства зависимостей для этого экземпляра DependencyObject. (Унаследовано от DependencyObject) |
| InvalidateProperty(DependencyProperty) |
Повторно вычисляет эффективное значение для указанного свойства зависимостей. (Унаследовано от DependencyObject) |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| OnChanged() |
Вызывается при изменении текущего Freezable объекта. (Унаследовано от Freezable) |
| OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty) |
Этот член поддерживает инфраструктуру Windows Presentation Foundation (WPF) и не предназначен для использования непосредственно из кода. (Унаследовано от Freezable) |
| OnFreezablePropertyChanged(DependencyObject, DependencyObject) |
Убедитесь, что для элемента данных, который только что был установлен, установлены DependencyObjectType соответствующие указатели контекста. (Унаследовано от Freezable) |
| OnPropertyChanged(DependencyPropertyChangedEventArgs) |
Переопределяет DependencyObject реализацию OnPropertyChanged(DependencyPropertyChangedEventArgs) для вызова всех Changed обработчиков в ответ на изменение свойства зависимостей типа Freezable. (Унаследовано от Freezable) |
| ReadLocalValue(DependencyProperty) |
Возвращает локальное значение свойства зависимостей, если оно существует. (Унаследовано от DependencyObject) |
| ReadPreamble() |
Гарантирует, что Freezable доступ к ней осуществляется из допустимого потока. Наследующие метод Freezable должны вызывать этот метод в начале любого API, который считывает элементы данных, которые не являются свойствами зависимостей. (Унаследовано от Freezable) |
| SetCurrentValue(DependencyProperty, Object) |
Задает значение свойства зависимостей, не изменяя его источник значений. (Унаследовано от DependencyObject) |
| SetValue(DependencyProperty, Object) |
Задает локальное значение свойства зависимостей, указанное его идентификатором свойства зависимостей. (Унаследовано от DependencyObject) |
| SetValue(DependencyPropertyKey, Object) |
Задает локальное значение свойства зависимостей только для чтения, указанное DependencyPropertyKey идентификатором свойства зависимости. (Унаследовано от DependencyObject) |
| ShouldSerializeProperty(DependencyProperty) |
Возвращает значение, указывающее, должны ли процессы сериализации сериализовать значение для указанного свойства зависимостей. (Унаследовано от DependencyObject) |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
| VerifyAccess() |
Принудительно применяет, что вызывающий поток имеет доступ к этому DispatcherObject. (Унаследовано от DispatcherObject) |
| WritePostscript() |
Changed Вызывает событие для Freezable метода и вызывает его OnChanged() метод. Классы, производные от Freezable этого метода, должны вызываться в конце любого API, который изменяет элементы класса, которые не хранятся в качестве свойств зависимостей. (Унаследовано от Freezable) |
| WritePreamble() |
Проверяет, что Freezable он не заморожен и к нему осуществляется доступ из допустимого контекста потоков. Freezable наследующие метод должны вызывать этот метод в начале любого API, записывающего элементы данных, которые не являются свойствами зависимостей. (Унаследовано от Freezable) |
События
| Имя | Описание |
|---|---|
| Changed |
Происходит при Freezable изменении объекта или объекта, содержащего его. (Унаследовано от Freezable) |
| Completed |
Происходит, когда эта временная шкала полностью завершена воспроизведение: она больше не будет вводить свой активный период. (Унаследовано от Timeline) |
| CurrentGlobalSpeedInvalidated |
Происходит при изменении скорости, в течение которой время выполняется для часов временной шкалы. (Унаследовано от Timeline) |
| CurrentStateInvalidated |
Происходит при CurrentState обновлении свойства временной шкалы Clock . (Унаследовано от Timeline) |
| CurrentTimeInvalidated |
Происходит при CurrentTime обновлении свойства временной шкалы Clock . (Унаследовано от Timeline) |
| RemoveRequested |
Происходит при удалении часов для этой временной шкалы или одной из родительских временных шкал. (Унаследовано от Timeline) |