LinearColorKeyFrame Класс

Определение

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

Windows.UI.Xaml.Media.Animation

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

public ref class LinearColorKeyFrame 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 LinearColorKeyFrame 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 LinearColorKeyFrame : ColorKeyFrame

Public NotInheritable Class LinearColorKeyFrame
Inherits ColorKeyFrame

<LinearColorKeyFrame .../>

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

Object Platform::Object IInspectable DependencyObject ColorKeyFrame LinearColorKeyFrame

Атрибуты

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

Комментарии

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

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

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

LinearColorKeyFrame()

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

Свойства

Dispatcher	Возвращает CoreDispatcher , с которым связан этот объект. CoreDispatcher представляет средство, которое может получить доступ к DependencyObject в потоке пользовательского интерфейса, даже если код инициируется потоком, не относящегося к пользовательскому интерфейсу. (Унаследовано от DependencyObject)
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
• Раскадрованные анимации
• Анимации по ключевым кадрам и на основе функций для реалистичной анимации