SplineColorKeyFrame Класс

Определение

Пространство имен:

Windows.UI.Xaml.Media.Animation

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

public ref class SplineColorKeyFrame sealed : ColorKeyFrame

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class SplineColorKeyFrame final : ColorKeyFrame

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class SplineColorKeyFrame : ColorKeyFrame

Public NotInheritable Class SplineColorKeyFrame
Inherits ColorKeyFrame

<SplineColorKeyFrame .../>

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

Object Platform::Object IInspectable DependencyObject ColorKeyFrame SplineColorKeyFrame

Атрибуты

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Требования к Windows

Семейство устройств	Windows 10 (появилось в 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v1.0)

Примеры

В этом примере XAML используется класс ColorAnimationUsingKeyFrames для анимации свойства BackgroundStackPanel. Эта анимация использует три ключевых кадра следующим образом:

1. В течение первых двух секунд LinearColorKeyFrame постепенно меняет цвет с зеленого на красный. Линейные ключевые кадры, такие как LinearColorKeyFrame , создают плавный линейный переход между значениями.
2. В конце следующей половины дискретный цветKeyFrame быстро меняет цвет с красного на желтый. Дискретные ключевые кадры, такие как DiscreteColorKeyFrame , создают внезапные изменения между значениями; анимация выполняется быстро и вообще не имеет интерполяции между значениями.
3. В течение последних двух секунд SplineColorKeyFrame снова изменяет цвет, на этот раз с желтого на зеленый. Ключевые кадры сплайна, такие как SplineColorKeyFrame, создают переход между значениями переменных в соответствии со значениями свойства KeySpline . KeySpline позволяет изменить связь времени и значения во время анимации, чтобы она была нелинейной, и, в частности, связь может быть кривой, которую было бы трудно создать с отдельными ключевыми кадрами. В этом примере изменение цвета начинается медленно и ускоряется экспоненциально к концу временного сегмента.

<StackPanel x:Name="myStackPanel" Background="Red"
Loaded="Start_Animation">
    <StackPanel.Resources>
        <Storyboard x:Name="colorStoryboard">

            <ColorAnimationUsingKeyFrames Storyboard.TargetName="myStackPanel" 
      Storyboard.TargetProperty="(Panel.Background).(SolidColorBrush.Color)">
                
                <!-- Go from green to red in the first 2 seconds. LinearColorKeyFrame creates
                a smooth, linear animation between values. -->
                <LinearColorKeyFrame Value="Blue" KeyTime="00:00:02" />

                <!-- In the next half second, go to yellow. DiscreteColorKeyFrame creates a 
                sudden jump between values. -->
                <DiscreteColorKeyFrame Value="Yellow" KeyTime="00:00:2.5" />

                <!-- In the final 2 seconds of the animation, go from yellow back to green. SplineColorKeyFrame 
                creates a variable transition between values depending on the KeySpline property. In this example,
                the animation starts off slow but toward the end of the time segment, it speeds up exponentially.-->
                <SplineColorKeyFrame Value="Green" KeyTime="00:00:4.5" KeySpline="0.6,0.0 0.9,0.00" />

            </ColorAnimationUsingKeyFrames>
        </Storyboard>
    </StackPanel.Resources>
</StackPanel>

// Start the animation when the object loads
private void Start_Animation(object sender, RoutedEventArgs e)
{
    colorStoryboard.Begin();
}

' Start the animation when the object loads
Private Sub Start_Animation(ByVal sender As Object, ByVal e As EventArgs)
    colorStoryboard.Begin()
End Sub

Комментарии

Анимации по ключевым кадрам допускают несколько целевых значений, которые достигаются в определенный момент по временной шкале анимации. Другими словами, каждый ключевой кадр может указывать различное промежуточное значение, последний достигнутый ключевой кадр является конечным значением анимации. Указав несколько значений для анимирования, вы можете создавать более сложные анимации. В одной коллекции ключевых кадров можно сочетать дискретные, линейные и сплайновые ключевые кадры.

Дополнительные сведения об использовании анимации по ключевым кадрам см. в разделах Анимация по ключевым кадрам и анимация с функцией облегчения.

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

SplineColorKeyFrame()

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

Свойства

Dispatcher	Возвращает CoreDispatcher , с которым связан этот объект. CoreDispatcher представляет средство, которое может получить доступ к DependencyObject в потоке пользовательского интерфейса, даже если код инициируется потоком, не относящегося к пользовательскому интерфейсу. (Унаследовано от DependencyObject)
KeySpline	Получает или задает две контрольные точки, определяющие ход выполнения анимации для данного ключевого кадра.
KeySplineProperty	Определяет свойство зависимости KeySpline .
KeyTime	Возвращает или задает время достижения целевого значения ключевого кадра. (Унаследовано от ColorKeyFrame)
Value	Получает или задает целевое значение опорного кадра. (Унаследовано от ColorKeyFrame)

Методы

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)

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

• ColorKeyFrame
• ColorAnimationUsingKeyFrames
• ColorKeyFrameCollection
• KeyTime
• Value
• Раскадрованные анимации
• Анимации по ключевым кадрам и на основе функций для реалистичной анимации