Язык

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 .../>
Наследование
Object Platform::Object IInspectable DependencyObject 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

Всегда возвращается null в приложении пакета SDK для приложений windows. Вместо этого используйте DispatcherQueue .

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

Возвращает, DispatcherQueue с которым связан этот объект. Представляет DispatcherQueue собой объект, который может получить доступ к DependencyObject потоку пользовательского интерфейса, даже если код инициируется потоком, отличным от пользовательского интерфейса.

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

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

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