Поделиться через


DecimalAnimation Класс

Определение

Выполняет анимацию значения свойства Decimal между двумя целевыми значениями с помощью линейной интерполяции в течение указанного времени Duration.

public ref class DecimalAnimation : System::Windows::Media::Animation::DecimalAnimationBase
public class DecimalAnimation : System.Windows.Media.Animation.DecimalAnimationBase
type DecimalAnimation = class
    inherit DecimalAnimationBase
Public Class DecimalAnimation
Inherits DecimalAnimationBase
Наследование

Комментарии

Анимация обновляет значение свойства в течение определенного периода времени. Эффект анимации может быть незначительным, например перемещением Shape на несколько пикселей влево и вправо, или эффектным, например увеличением объекта до 200 раз его первоначального размера при его вращении и изменении его цвета. Чтобы создать анимацию в Windows Presentation Foundation (WPF), необходимо связать анимацию со значением свойства объекта.

Целевые значения

Класс DecimalAnimation создает переход между двумя целевыми значениями. Чтобы задать целевые значения, используйте свойства From, Toи By . В следующей таблице указано, как свойства From, To и By могут использоваться вместе или по отдельности для определения целевых значений анимации.

Заданные свойства Результаты выполнения операции
From Анимация выполняется от значения, определенного свойством From до базового значения анимируемого свойства либо до результата выполнения предыдущей анимации, в зависимости от того, как настроена предыдущая анимация.
From и To Анимация выполняется от значения, указанного свойством From, до значения, указанного свойством To.
From и By Анимация выполняется от значения, указанного свойством From, до значения, указанного свойствами From и By в совокупности.
To Анимация выполняется от базового значения анимируемого свойства или от результата выполнения предыдущей анимации до значения, определенного свойством To.
By Анимация выполняется от базового значения анимируемого свойства или от результата выполнения предыдущей анимации до значения, равного сумме этого значения и значения, определенного свойством By.

Примечание

Если заданы To оба свойства и By , To свойство имеет приоритет, а By свойство игнорируется.

Чтобы использовать другие методы интерполяции или анимировать более двух целевых значений, используйте DecimalAnimationUsingKeyFrames объект .

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

Возможности объектов Freezable

DecimalAnimation Так как класс наследуется от Freezable, DecimalAnimation объекты получают несколько специальных возможностей, включая следующие: их можно объявить как ресурсы, совместно использовать для нескольких объектов, сделать доступными только для чтения для повышения производительности, клонировать и сделать потокобезопасной. Дополнительные сведения о различных функциях, предоставляемых объектами Freezable, см. в разделе Общие сведения об объектах класса Freezable.

Конструкторы

DecimalAnimation()

Инициализирует новый экземпляр класса DecimalAnimation.

DecimalAnimation(Decimal, Decimal, Duration)

Инициализирует новый экземпляр класса DecimalAnimation, который выполняет анимацию с указанного начального значения до указанного конечного значения за указанный период времени.

DecimalAnimation(Decimal, Decimal, Duration, FillBehavior)

Инициализирует новый экземпляр класса DecimalAnimation, который выполняет анимацию с указанного начального значения до указанного конечного значения за указанный период времени и реализует заданное поведение заполнения.

DecimalAnimation(Decimal, Duration)

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

DecimalAnimation(Decimal, Duration, FillBehavior)

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

Поля

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

Получает тип значения, создаваемого этой анимацией.

(Унаследовано от DecimalAnimationBase)
To

Возвращает или задает конечное значение анимации.

Методы

AllocateClock()

Создает Clock для этого элемента управления AnimationTimeline.

(Унаследовано от AnimationTimeline)
ApplyAnimationClock(DependencyProperty, AnimationClock)

Применяет AnimationClock к заданному DependencyProperty. Если свойство уже анимировано, используется эстафетное поведение SnapshotAndReplace.

(Унаследовано от Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

Применяет AnimationClock к заданному DependencyProperty. Если свойство уже является анимированным, используется указанное поведение HandoffBehavior.

(Унаследовано от Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)

Применяет анимацию к указанному DependencyProperty. Анимация начинается при отрисовке следующего кадра. Если указанное свойство уже анимировано, используется поведение перемещения SnapshotAndReplace.

(Унаследовано от Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)

Применяет анимацию к указанному DependencyProperty. Анимация начинается при отрисовке следующего кадра. Если указанное свойство уже является анимированным, используется указанное поведение HandoffBehavior.

(Унаследовано от Animatable)
CheckAccess()

Определяет, имеет ли вызывающий поток доступ к этому DispatcherObject.

(Унаследовано от DispatcherObject)
ClearValue(DependencyProperty)

Очищает локальное значение свойства. Очищаемое свойство задается идентификатором DependencyProperty.

(Унаследовано от DependencyObject)
ClearValue(DependencyPropertyKey)

Очищает локальное значение доступного только для чтения свойства. Очищаемое свойство задается ключом DependencyPropertyKey.

(Унаследовано от DependencyObject)
Clone()

Создает изменяемый клон данного объекта DecimalAnimation, делая глубокие копии значений этого объекта. При копировании свойств зависимостей этот метод копирует ссылки на ресурсы и привязки данных (которые могут уже не быть разрешимыми), но не копирует анимации и их текущие значения.

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()

Создает новый экземпляр класса DecimalAnimation.

Equals(Object)

Определяет, является ли указанный DependencyObject эквивалентом текущего DependencyObject.

(Унаследовано от DependencyObject)
Freeze()

Делает текущий объект неизменяемым и присваивает его свойству IsFrozen значение true.

(Унаследовано от Freezable)
FreezeCore(Boolean)

Делает данный объект Timeline неизменяемым или определяет, может ли он быть сделан неизменяемым.

(Унаследовано от Timeline)
GetAnimationBaseValue(DependencyProperty)

Возвращает не анимированное значение указанного объекта DependencyProperty.

(Унаследовано от Animatable)
GetAsFrozen()

Создает фиксированную копию объекта Freezable, используя базовые (не анимационные) значения свойств. Так как копия является фиксированной, копируются только ссылки на фиксированные вложенные объекты.

(Унаследовано от Freezable)
GetAsFrozenCore(Freezable)

Делает этот экземпляр клоном указанного объекта Timeline.

(Унаследовано от Timeline)
GetCurrentValue(Decimal, Decimal, AnimationClock)

Получает текущее значении анимации.

(Унаследовано от DecimalAnimationBase)
GetCurrentValue(Object, Object, AnimationClock)

Получает текущее значении анимации.

(Унаследовано от DecimalAnimationBase)
GetCurrentValueAsFrozen()

Создает фиксированную копию объекта Freezable с использованием текущих значений свойств. Так как копия является фиксированной, копируются только ссылки на фиксированные вложенные объекты.

(Унаследовано от Freezable)
GetCurrentValueAsFrozenCore(Freezable)

Делает этот экземпляр зафиксированным клоном указанного объекта Timeline. Ссылки на ресурсы, привязки данных и анимации не копируются, но копируются их текущие значения.

(Унаследовано от Timeline)
GetCurrentValueCore(Decimal, Decimal, AnimationClock)

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

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)

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

(Унаследовано от Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)

Этот элемент поддерживает инфраструктуру Windows Presentation Foundation (WPF) и не предназначен для использования непосредственно из кода.

(Унаследовано от 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)

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

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