PointAnimation Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Анимирует значение свойства Point между двумя целевыми значениями с помощью линейной интерполяции в течение указанной длительности.
public ref class PointAnimation sealed : Timeline
/// [Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class PointAnimation final : Timeline
[Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class PointAnimation : Timeline
Public NotInheritable Class PointAnimation
Inherits Timeline
<PointAnimation .../>
- Наследование
- Атрибуты
Примеры
В следующем примере показано, как использовать PointAnimation для анимации свойства ЦентраэллипсеGeometry.
// Start the animation when the object loads
void SampleApp::Page::Start_Animation(Platform::Object^ sender, Windows::UI::Xaml::RoutedEventArgs^ e)
{
myStoryboard->Begin();
}
<Canvas Width="450" Height="350">
<Canvas.Resources>
<Storyboard x:Name="myStoryboard">
<!-- Animate the center point of the ellipse from 100 X, 300 Y
to 400 X, 100 Y over 5 seconds. -->
<PointAnimation
Storyboard.TargetProperty="Center"
Storyboard.TargetName="MyAnimatedEllipseGeometry"
Duration="0:0:5"
From="100,300"
To="400,100"
RepeatBehavior="Forever" EnableDependentAnimation="True"/>
</Storyboard>
</Canvas.Resources>
<Path Fill="Blue" Loaded="Start_Animation">
<Path.Data>
<!-- Describes an ellipse. -->
<EllipseGeometry x:Name="MyAnimatedEllipseGeometry"
Center="200,100" RadiusX="15" RadiusY="15" />
</Path.Data>
</Path>
</Canvas>
// Start the animation when the object loads
private void Start_Animation(object sender, RoutedEventArgs e)
{
myStoryboard.Begin();
}
Комментарии
Используйте PointAnimation, чтобы анимировать значение свойства любого свойства зависимостей, которое имеет тип Point.
Линейная интерполяция для точки означает, что значения X и Y обрабатываются как число, и интерполяция является просто математической операцией.
Иногда необходимо использовать непрямое свойство, предназначенное для назначения под свойств другого объекта, которое является значением свойства в целевом объекте. Например, чтобы анимировать части PathGeometry, необходимо ссылаться на некоторые из промежуточных значений свойств объекта, пока последний шаг в пути косвенного свойства не является действительно значением Point . Дополнительные сведения о косвенном целевых свойствах и других концепциях раскадровки анимации см. в разделе "Раскадрованная анимация" или синтаксис пути свойств.
PointAnimation обычно имеет по крайней мере один из наборов свойств From, By или To , но никогда не все три.
- Только из: Анимация выполняется из значения, указанного свойством From , к базовому значению анимируемого свойства.
- От и до: Анимация выполняется из значения, указанного свойством From , к значению, указанному свойством To .
- От и по: Анимация выполняется из значения, указанного свойством From , к значению, указанному суммой свойств From и By .
- Только для: Анимация выполняется из базового значения анимированного свойства или выходного значения предыдущей анимации в значение, указанное свойством To .
- Только: Анимация выполняется из базового значения свойства, анимируемого или предыдущего значения анимации, к сумме этого значения и значению, заданному свойством By .
Свойства From, By или To объекта PointAnimation не являются значением Point . Вместо этого они являются допустимыми для point. Значение по умолчанию для этих значений равно NULL, а не неинициализированной структуре. Это значение NULL — это то, как система анимации различает, что вы не задали конкретное значение. C++ не имеет типа NULL , поэтому вместо этого используется IReference .
Конструкторы
| Имя | Описание |
|---|---|
| PointAnimation() |
Инициализирует новый экземпляр класса PointAnimation . |
Свойства
| Имя | Описание |
|---|---|
| AutoReverse |
Возвращает или задает значение, указывающее, воспроизводится ли временная шкала в обратном порядке после завершения итерации вперед. (Унаследовано от Timeline) |
| BeginTime |
Возвращает или задает время начала этой временной шкалы . (Унаследовано от Timeline) |
| By |
Возвращает или задает общую сумму, с помощью которой анимация изменяет начальное значение. |
| ByProperty |
Определяет свойство зависимостей By . |
| Dispatcher |
Всегда возвращается |
| DispatcherQueue |
Возвращает, |
| Duration |
Возвращает или задает продолжительность времени, в течение которого эта временная шкала воспроизводится, не подсчитывая повторения. (Унаследовано от Timeline) |
| EasingFunction |
Возвращает или задает функцию упрощения, применяемую к анимации. |
| EasingFunctionProperty |
Определяет свойство зависимостей EasingFunction . |
| EnableDependentAnimation |
Возвращает или задает значение, указывающее, должны ли анимированные свойства, которые считаются зависимыми анимациями, использовать это объявление анимации. |
| EnableDependentAnimationProperty |
Определяет свойство зависимости EnableDependentAnimation . |
| FillBehavior |
Возвращает или задает значение, указывающее, как работает анимация после окончания его активного периода. (Унаследовано от Timeline) |
| From |
Возвращает или задает начальное значение анимации. |
| FromProperty |
Определяет свойство зависимостей From . |
| RepeatBehavior |
Возвращает или задает повторяющееся поведение этой временной шкалы. (Унаследовано от Timeline) |
| SpeedRatio |
Получает или задает частоту относительно родительского элемента, в течение которого выполняется для этой временной шкалы. (Унаследовано от Timeline) |
| To |
Возвращает или задает конечное значение анимации. |
| ToProperty |
Определяет свойство зависимостей To . |
Методы
| Имя | Описание |
|---|---|
| ClearValue(DependencyProperty) |
Очищает локальное значение свойства зависимостей. (Унаследовано от DependencyObject) |
| GetAnimationBaseValue(DependencyProperty) |
Возвращает любое базовое значение, установленное для свойства зависимостей, которое будет применяться в случаях, когда анимация не активна. (Унаследовано от DependencyObject) |
| GetValue(DependencyProperty) |
Возвращает текущее эффективное значение свойства зависимостей из DependencyObject. (Унаследовано от DependencyObject) |
| ReadLocalValue(DependencyProperty) |
Возвращает локальное значение свойства зависимостей, если задано локальное значение. (Унаследовано от DependencyObject) |
| RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback) |
Регистрирует функцию уведомлений для прослушивания изменений в определенном экземпляре DependencyProperty в этом экземпляре DependencyObject . (Унаследовано от DependencyObject) |
| SetValue(DependencyProperty, Object) |
Задает локальное значение свойства зависимостей в DependencyObject. (Унаследовано от DependencyObject) |
| UnregisterPropertyChangedCallback(DependencyProperty, Int64) |
Отменяет уведомление об изменении, которое ранее было зарегистрировано путем вызова RegisterPropertyChangedCallback. (Унаследовано от DependencyObject) |
События
| Имя | Описание |
|---|---|
| Completed |
Происходит при завершении воспроизведения объекта Storyboard . (Унаследовано от Timeline) |