PointAnimation Kelas

Definisi

Ruang nama:

Windows.UI.Xaml.Media.Animation

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

public ref class PointAnimation 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 PointAnimation 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 PointAnimation : Timeline

Public NotInheritable Class PointAnimation
Inherits Timeline

<PointAnimation .../>

Warisan

Object Platform::Object IInspectable DependencyObject Timeline PointAnimation

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 PointAnimation untuk menganimasikan properti Tengah dari EllipseGeometry.

// 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();
}

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

Keterangan

Gunakan PointAnimation untuk menganimasikan nilai properti dari properti dependensi apa pun yang berjenis Point.

Interpolasi linier untuk Titik berarti bahwa nilai X dan Y diperlakukan sebagai angka dan interpolasi hanyalah operasi matematika.

Terkadang Anda harus menggunakan penargetan properti tidak langsung untuk menargetkan sub-properti objek lain yang merupakan nilai properti pada target. Misalnya, untuk menganimasikan bagian dari PathGeometry, Anda perlu mereferensikan beberapa nilai properti objek perantara, hingga langkah terakhir dalam jalur properti tidak langsung benar-benar nilai Titik . Untuk informasi selengkapnya tentang penargetan properti tidak langsung dan konsep animasi papan cerita lainnya, lihat Animasi papan cerita atau sintaks jalur Properti.

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

• Hanya dari: Animasi berkembang dari nilai yang ditentukan oleh properti Dari ke nilai dasar properti yang dianimasikan.
• Dari dan Ke: Animasi maju dari nilai yang ditentukan oleh properti Dari ke nilai yang ditentukan oleh properti Kepada .
• Dari dan Menurut: Animasi maju dari nilai yang ditentukan oleh properti Dari ke nilai yang ditentukan oleh jumlah properti Dari dan Menurut .
• Hanya untuk: Animasi berkembang dari nilai dasar properti animasi atau nilai output animasi sebelumnya ke nilai yang ditentukan oleh properti Kepada .
• Hanya dengan: Animasi berkembang 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 , atau Ke dari PointAnimation bukan nilai Titik . Sebaliknya ini adalah Nullable untuk Point. Nilai default untuk ini adalah null, bukan struktur yang tidak diinisialisasi. Nilai null tersebut 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

PointAnimation()

Menginisialisasi instans baru kelas PointAnimation .

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 bahkan jika kode dimulai oleh utas non-UI. (Diperoleh dari DependencyObject)
Duration	Mendapatkan atau mengatur lamanya waktu pemutaran garis waktu ini, bukan menghitung pengulangan. (Diperoleh dari Timeline)
EasingFunction	Mendapatkan atau mengatur fungsi permudah yang Anda terapkan ke animasi.
EasingFunctionProperty	Mengidentifikasi properti dependensi EasingFunction .
EnableDependentAnimation	Mendapatkan atau menetapkan nilai yang menyatakan apakah properti animasi yang dianggap 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 laju, 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
• Point
• PointAnimationUsingKeyFrames
• Animasi papan cerita
• Sampel animasi XAML