Bagikan melalui


PointAnimation Kelas

Definisi

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

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 .../>
Warisan
Object Platform::Object IInspectable DependencyObject Timeline PointAnimation
Atribut

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

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

Selalu kembali null di aplikasi SDK Aplikasi Windows. Gunakan DispatcherQueue sebagai gantinya .

(Diperoleh dari DependencyObject)
DispatcherQueue

DispatcherQueue Mendapatkan yang dikaitkan dengan objek ini. DispatcherQueue 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)

Berlaku untuk

Lihat juga