SizeAnimation Класс

Определение

Пространство имен:: System.Windows.Media.Animation

Сборка:: PresentationCore.dll

Важно!

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

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

public ref class SizeAnimation : System::Windows::Media::Animation::SizeAnimationBase

public class SizeAnimation : System.Windows.Media.Animation.SizeAnimationBase

type SizeAnimation = class
    inherit SizeAnimationBase

Public Class SizeAnimation
Inherits SizeAnimationBase

Наследование: Object

DispatcherObject

DependencyObject

Freezable

Animatable

Timeline

AnimationTimeline

SizeAnimationBase
SizeAnimation

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

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

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

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

Сведения о применении нескольких анимаций к одному свойству см. в Key-Frame обзоре анимаций.

Бесплатные функции

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

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

Имя	Описание
SizeAnimation()	Инициализирует новый экземпляр класса SizeAnimation.
SizeAnimation(Size, Duration, FillBehavior)	Инициализирует новый экземпляр SizeAnimation класса, который анимирует указанное значение в течение указанной длительности и имеет указанное поведение заполнения. Начальное значение анимации — это базовое значение анимируемого свойства или выходные данные из другой анимации.
SizeAnimation(Size, Duration)	Инициализирует новый экземпляр SizeAnimation класса, который анимирует указанное значение в течение указанной длительности. Начальное значение анимации — это базовое значение анимируемого свойства или выходные данные из другой анимации.
SizeAnimation(Size, Size, Duration, FillBehavior)	Инициализирует новый экземпляр SizeAnimation класса, который анимирует из указанного начального значения в указанное целевое значение в течение указанной длительности и имеет указанное поведение заполнения.
SizeAnimation(Size, Size, Duration)	Инициализирует новый экземпляр класса, который анимирует от указанного SizeAnimation начального значения до указанного целевого значения в течение указанной длительности.

Поля

Имя	Описание
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	Возвращает тип значения, создаваемого этой анимацией. (Унаследовано от SizeAnimationBase)
To	Возвращает или задает конечное значение анимации.

Методы

Имя	Описание
AllocateClock()	Clock Создает для этого AnimationTimeline. (Унаследовано от AnimationTimeline)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Применяется к указанному объекту AnimationClock DependencyProperty. Если свойство уже анимировано, используется указанный HandoffBehavior параметр. (Унаследовано от Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock)	Применяется к указанному объекту AnimationClock DependencyProperty. Если свойство уже анимировано, 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()	Создает модификаторный клон этого SizeAnimationобъекта, делая глубокие копии значений этого объекта. При копировании свойств зависимостей этот метод копирует ссылки на ресурсы и привязки данных (но они больше не могут разрешаться), но не анимации или их текущие значения.
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()	Создает новый экземпляр SizeAnimationобъекта .
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(Object, Object, AnimationClock)	Возвращает текущее значение анимации. (Унаследовано от SizeAnimationBase)
GetCurrentValue(Size, Size, AnimationClock)	Возвращает текущее значение анимации. (Унаследовано от SizeAnimationBase)
GetCurrentValueAsFrozen()	Создает замороженную копию с использованием текущих значений Freezable свойств. Так как копия заморожена, все замороженные вложенные объекты копируются по ссылке. (Унаследовано от Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Делает этот экземпляр замороженным клоном указанного.Timeline Ссылки на ресурсы, привязки данных и анимации не копируются, но их текущие значения. (Унаследовано от Timeline)
GetCurrentValueCore(Size, Size, AnimationClock)	Вычисляет значение, представляющее текущее значение анимируемого свойства, как определено SizeAnimation.
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)

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

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

Обратная связь

Были ли сведения на этой странице полезными?

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