ColorAnimation Kelas

Definisi

Ruang nama:

Windows.UI.Xaml.Media.Animation

Menganimasikan nilai properti Warna di antara dua nilai target menggunakan interpolasi linier selama Durasi tertentu.

public ref class ColorAnimation sealed : Timeline

/// [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 ColorAnimation final : Timeline

[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 ColorAnimation : Timeline

Public NotInheritable Class ColorAnimation
Inherits Timeline

<ColorAnimation .../>

Warisan

Object Platform::Object IInspectable DependencyObject Timeline ColorAnimation

Atribut

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Contoh

Contoh berikut menunjukkan cara menggunakan ColorAnimation untuk menganimasikan warna latar belakang StackPanel.

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

      <!-- Animate the background color of the canvas from red to green
        over 4 seconds. -->
      <ColorAnimation Storyboard.TargetName="myStackPanel" 
        Storyboard.TargetProperty="(Panel.Background).(SolidColorBrush.Color)"
        From="Red" To="Blue" Duration="0:0:4"/>

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

<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>

<StackPanel Loaded="Start_Animation">
  <StackPanel.Resources>
    <Storyboard x:Name="colorStoryboard">
      <!-- Animate the background color of the canvas from red to green
        over 4 seconds. -->
      <ColorAnimation Storyboard.TargetName="mySolidColorBrush"
        Storyboard.TargetProperty="Color" From="Red" To="Blue" Duration="0:0:4"/>
    </Storyboard>
  </StackPanel.Resources>

  <StackPanel.Background>
    <SolidColorBrush x:Name="mySolidColorBrush" Color="Red" />
  </StackPanel.Background>

</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

Storyboard.TargetProperty="(Panel.Background).(SolidColorBrush.Color)"

Atau, Anda dapat secara eksplisit membuat SolidColorBrush, menamainya, dan menargetkan properti Color-nya secara langsung. Contoh di bawah ini menunjukkan cara membuat animasi yang sama dengan animasi sebelumnya kecuali menggunakan penargetan properti langsung.

<StackPanel Loaded="Start_Animation">
  <StackPanel.Resources>
    <Storyboard x:Name="colorStoryboard">
      <!-- Animate the background color of the canvas from red to green
        over 4 seconds. -->
      <ColorAnimation Storyboard.TargetName="mySolidColorBrush"
        Storyboard.TargetProperty="Color" From="Red" To="Blue" Duration="0:0:4"/>
    </Storyboard>
  </StackPanel.Resources>

  <StackPanel.Background>
    <SolidColorBrush x:Name="mySolidColorBrush" Color="Red" />
  </StackPanel.Background>

</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

Keterangan

Gunakan ColorAnimation untuk menganimasikan nilai properti dari properti dependensi apa pun yang berjenis Warna.

Interpolasi linier untuk Warna berarti bahwa masing-masing nilai ARGB diperlakukan sebagai byte dan interpolasi hanyalah operasi matematika. Anda mendapatkan hasil terbaik dari interpolasi warna jika setidaknya salah satu komponen RGB sama atau dekat dengan yang sama dalam nilai awal dan nilai akhir.

Anda biasanya perlu menggunakan penargetan properti tidak langsung untuk menargetkan sub-properti objek lain yang merupakan nilai properti pada target. Ini karena sangat sedikit properti yang menampilkan informasi warna dalam elemen UI sebenarnya berjenis Warna. Sebagian besar bukan jenis Brush. Untuk menggunakan ColorAnimation pada elemen UI, Anda biasanya menargetkan properti Warna dari SolidColorBrush yang merupakan nilai sub-properti. Sintaks untuk ini ditampilkan dalam contoh XAML di bagian "Contoh". Untuk informasi selengkapnya tentang penargetan properti tidak langsung dan konsep animasi papan cerita lainnya, lihat Animasi papan cerita atau Sintaks jalur properti.

ColorAnimation biasanya memiliki setidaknya salah satu properti Dari, Menurut , atau Ke yang ditetapkan, tetapi tidak pernah ketiganya.

• Hanya dari: Animasi maju dari nilai yang ditentukan oleh properti Dari ke nilai dasar properti yang dianimasikan.
• Dari dan Ke: Animasi berlanjut dari nilai yang ditentukan oleh properti Dari ke nilai yang ditentukan oleh properti Kepada .
• Dari dan Oleh: Animasi berlangsung dari nilai yang ditentukan oleh properti Dari ke nilai yang ditentukan oleh jumlah properti Dari dan Menurut .
• Hanya untuk: Animasi berlanjut dari nilai dasar properti animasi atau nilai output animasi sebelumnya ke nilai yang ditentukan oleh properti Kepada .
• Hanya dengan: Animasi berlanjut dari nilai dasar properti yang dianimasikan atau nilai output animasi sebelumnya ke jumlah nilai tersebut dan nilai yang ditentukan oleh properti Menurut .

Properti Dari, Menurut , dan Ke dari ColorAnimation tidak benar-benar Warna. Sebaliknya ini adalah Nullable untuk Color. Nilai default untuk ini adalah null, bukan struktur yang tidak diinisialisasi. Nilai null itu adalah bagaimana sistem animasi membedakan bahwa Anda belum secara khusus menetapkan nilai. Ekstensi komponen Visual C++ (C++/CX) tidak memiliki jenis Nullable , sehingga menggunakan IReference sebagai gantinya .

Konstruktor

ColorAnimation()

Menginisialisasi instans baru kelas ColorAnimation .

Properti

AutoReverse	Mendapatkan atau menetapkan nilai yang menunjukkan apakah garis waktu diputar secara terbalik setelah menyelesaikan perulangan ke depan. (Diperoleh dari Timeline)
BeginTime	Mendapatkan atau mengatur waktu di mana Garis Waktu ini harus dimulai. (Diperoleh dari Timeline)
By	Mendapatkan atau mengatur jumlah total di mana animasi mengubah nilai awalnya.
ByProperty	Mengidentifikasi properti Berdasarkan dependensi.
Dispatcher	Mendapatkan CoreDispatcher yang dikaitkan dengan objek ini. CoreDispatcher mewakili fasilitas yang dapat mengakses DependencyObject pada utas UI meskipun kode dimulai oleh utas non-UI. (Diperoleh dari DependencyObject)
Duration	Mendapatkan atau mengatur lamanya waktu diputarnya garis waktu ini, tidak menghitung pengulangan. (Diperoleh dari Timeline)
EasingFunction	Mendapatkan atau menyetel fungsi permudah yang diterapkan ke animasi ini.
EasingFunctionProperty	Mengidentifikasi properti dependensi EasingFunction .
EnableDependentAnimation	Mendapatkan atau menetapkan nilai yang menyatakan apakah properti animasi yang dianggap sebagai animasi dependen harus diizinkan untuk menggunakan deklarasi animasi ini.
EnableDependentAnimationProperty	Mengidentifikasi properti dependensi EnableDependentAnimation .
FillBehavior	Mendapatkan atau menetapkan nilai yang menentukan bagaimana animasi berperilaku setelah mencapai akhir periode aktifnya. (Diperoleh dari Timeline)
From	Mendapatkan atau mengatur nilai awal animasi.
FromProperty	Mengidentifikasi properti Dari dependensi.
RepeatBehavior	Mendapatkan atau mengatur perilaku berulang dari garis waktu ini. (Diperoleh dari Timeline)
SpeedRatio	Mendapatkan atau menetapkan tarif, relatif terhadap induknya, pada saat itu berlangsung untuk Garis Waktu ini. (Diperoleh dari Timeline)
To	Mendapatkan atau mengatur nilai akhir animasi.
ToProperty	Mengidentifikasi properti Ke dependensi.

Metode

ClearValue(DependencyProperty)	Menghapus nilai lokal properti dependensi. (Diperoleh dari DependencyObject)
GetAnimationBaseValue(DependencyProperty)	Mengembalikan nilai dasar apa pun yang ditetapkan untuk properti dependensi, yang akan berlaku dalam kasus di mana animasi tidak aktif. (Diperoleh dari DependencyObject)
GetValue(DependencyProperty)	Mengembalikan nilai efektif properti dependensi saat ini dari DependencyObject. (Diperoleh dari DependencyObject)
ReadLocalValue(DependencyProperty)	Mengembalikan nilai lokal properti dependensi, jika nilai lokal ditetapkan. (Diperoleh dari DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Mendaftarkan fungsi pemberitahuan untuk mendengarkan perubahan pada DependencyProperty tertentu pada instans DependencyObject ini. (Diperoleh dari DependencyObject)
SetValue(DependencyProperty, Object)	Mengatur nilai lokal properti dependensi pada DependencyObject. (Diperoleh dari DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Membatalkan pemberitahuan perubahan yang sebelumnya terdaftar dengan memanggil RegisterPropertyChangedCallback. (Diperoleh dari DependencyObject)

Acara

Completed

Terjadi ketika objek Storyboard telah selesai diputar. (Diperoleh dari Timeline)

Lihat juga

• Timeline
• SolidColorBrush
• LinearGradientBrush
• Color
• Colors
• Animasi papan cerita
• Sampel animasi XAML