Microsoft.UI.Composition.Interactions Ruang nama
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Menyediakan fungsionalitas yang memungkinkan animasi berbasis input di lapisan visual.
Kelas
| Nama | Deskripsi |
|---|---|
| CompositionConditionalValue |
Memungkinkan modifikasi kondisional posisi dan skala sumber interaksi visual. |
| CompositionInteractionSourceCollection |
Kumpulan sumber interaksi. Ini adalah kumpulan sumber interaksi yang terkait dengan InteractionTracker tertentu. Satu-satunya anggota yang valid dari koleksi ini adalah VisualInteractionSource. Setiap VisualInteractionSource harus memiliki visual uji hit (sumber) yang unik. Setiap VisualInteractionSource akan dikonfigurasi satu per satu agar input yang diinginkan dikirim ke InteractionTracker. |
| InteractionSourceConfiguration |
Mewakili konfigurasi input VisualInteractionSource. |
| InteractionTracker |
Menangani logika input yang dapat digunakan sebagai target dalam ExpressionAnimations—biasanya untuk mendorong gerakan visual berdasarkan input. |
| InteractionTrackerCustomAnimationStateEnteredArgs |
Argumen untuk panggilan balik IInteractionTrackerOwner.CustomAnimationStateEntered . |
| InteractionTrackerIdleStateEnteredArgs |
Argumen untuk panggilan balik IInteractionTrackerOwner.IdleStateEntered . |
| InteractionTrackerInertiaModifier |
Kelas dasar untuk pengubah inersia. InteractionTrackerInertiaModifier mewakili kelas dasar untuk pengubah inertia. pengubah inersia dapat dianggap sebagai cara untuk mengubah perilaku di mana dan bagaimana InteractionTracker mencapai posisi istirahat terakhirnya. Mengubah perilaku InteractionTracker ini biasanya digunakan ketika lebih banyak pengalaman gerakan kustom diperlukan seperti titik rekam jepret. Ada dua variasi untuk bagaimana Anda dapat memodifikasi perilaku InteractionTracker menggunakan pengubah inertia: memodifikasi posisi istirahat terakhirnya setelah interaksi dengan kelas InteractionTrackerInertiaRestingValue atau menentukan persamaan yang digunakan untuk menghitung gerakan aktual dan posisi istirahat akhir selama Inertia dengan kelas InteractionTrackerInertiaMotion . Pengubah ini diterapkan ke Posisi X, Posisi Y, atau Skala InteractionTracker. |
| InteractionTrackerInertiaMotion |
ExpressionAnimation yang mendefinisikan gerakan InteractionTracker selama status inertianya. Kelas InteractionTrackerMotion berisi dua ExpressionAnimationyang mewakili persamaan turunan kedua dari posisi yang akan digunakan InteractionTracker untuk menentukan gerakan dari awal hingga akhir inertia ketika kondisi tertentu terpenuhi. Kelas InteractionTrackerMotion didefinisikan sebagai dua bagian: Pernyataan bersyarat untuk menentukan kapan gerakan akan terjadi dan persamaan yang menggambarkan gerakan tentang bagaimana InteractionTracker akan mencapai posisi istirahat terakhirnya. Gunakan kelas InteractionTrackerInertiaMotion saat Anda perlu menentukan gerakan yang disesuaikan (seperti gerakan musim semi) untuk digunakan InteractionTracker ketika dalam keadaan inertianya. |
| InteractionTrackerInertiaNaturalMotion |
ScalarNaturalMotionAnimation yang mendefinisikan gerakan InteractionTracker selama keadaan inertianya. |
| InteractionTrackerInertiaRestingValue |
ExpressionAnimation yang menentukan posisi istirahat setelah interaksi. Kelas InteractionTrackerInertiaRestingValue mendefinisikan dua ExpressionAnimationyang menghitung posisi istirahat eksplisit untuk InteractionTracker saat kondisi tertentu terpenuhi. InteractionTrackerInertiaRestingValue didefinisikan sebagai dua bagian: Pernyataan bersyarat di mana lokasi istirahat spesifik InteractionTracker perlu didefinisikan secara eksplisit jika benar dan persamaan yang menjelaskan hubungan matematika yang menghasilkan lokasi. Gunakan kelas InteractionTrackerInertiaRestingValue saat perlu memastikan InteractionTracker mendarat di lokasi tertentu setelah interaksi terjadi. |
| InteractionTrackerInertiaStateEnteredArgs |
Argumen untuk panggilan balik IInteractionTrackerOwner.InertiaStateEntered . Kelas InteractionTrackerOwner.InertiaStateEntered mendefinisikan nilai properti interactionTracker.InertiaStateEntered yang dapat diakses dan up-tosaat InteractionTracker memasuki status inertia. Jika terdaftar untuk peristiwa InertiaStateEntered , nilai properti objek ini mewakili hasil yang dihitung oleh sistem di awal status inertia. Menggunakan posisi istirahat yang dimodifikasi dan alami membantu memungkinkan skenario seperti menggulir virtualisasi. |
| InteractionTrackerInteractingStateEnteredArgs |
Argumen untuk panggilan balik IInteractionTrackerOwner.InteractingStateEntered . |
| InteractionTrackerRequestIgnoredArgs |
Argumen untuk panggilan balik IInteractionTrackerOwner.RequestIgnored . |
| InteractionTrackerValuesChangedArgs |
Argumen untuk panggilan balik IInteractionTrackerOwner.ValuesChanged . |
| InteractionTrackerVector2InertiaModifier |
Kelas dasar untuk InteractionTrackerVector2InertiaNaturalMotion. |
| InteractionTrackerVector2InertiaNaturalMotion |
Vector2NaturalMotionAnimation yang mendefinisikan gerakan InteractionTracker selama keadaan inertianya. |
| VisualInteractionSource |
Objek untuk mengonfigurasi input ke InteractionTracker relatif terhadap visual. VisualInteractionSource dirancang untuk digunakan hanya dengan InteractionTracker dan menentukan input mana yang akan dikirim ke InteractionTracker untuk mendorong status dan propertinya. Kelas ini berisi visual yang akan digunakan untuk pengujian hit, serta berbagai properti konfigurasi yang gerakan dan jenis inputnya akan dikirim ke InteractionTracker. |
Antarmuka
| Nama | Deskripsi |
|---|---|
| ICompositionInteractionSource |
Objek yang sedang dilacak untuk interaksi di kompositori. |
| IInteractionTrackerOwner |
Berisi panggilan balik yang akan dipicu oleh peristiwa InteractionTracker. Menerapkan antarmuka ini memungkinkan penerimaan panggilan balik mengenai status dan nilai InteractionTracker, serta apakah pembaruan yang diminta untuk properti InteractionTracker dihormati. |
Enum
| Nama | Deskripsi |
|---|---|
| InteractionBindingAxisModes |
Menentukan konstanta yang menentukan sumbu mana yang terikat di antara dua pelacak interaksi. |
| InteractionChainingMode |
Menentukan perilaku penautan untuk VisualInteractionSource. Ada tiga opsi: Selalu rantai, tidak pernah rantai atau rantai otomatis (biarkan sistem memilih). Jika penautan diaktifkan, ketika InteractionTracker mencapai batas minimum atau maksimumnya, ia akan mengirim input ke visualInteractionSource leluhur berikutnya. |
| InteractionSourceMode |
Menyediakan berbagai definisi tentang bagaimana VisualInteractionSource akan memproses interaksi. Opsi yang tersedia untuk enumerasi dinonaktifkan, EnabledWithInertia, dan EnabledWithoutInertia. InteractionSourceMode dapat digunakan untuk menentukan perilaku untuk X, Y, dan Sumbu Skala VisualInteractionSource. |
| InteractionSourceRedirectionMode |
Menentukan konstanta yang menentukan apakah input harus dialihkan ke InteractionTracker. |
| InteractionTrackerClampingOption |
Menentukan konstanta yang menentukan bagaimana nilai dijepit saat posisi InteractionTracker diperbarui. |
| InteractionTrackerPositionUpdateOption |
Menentukan konstanta yang menunjukkan apakah animasi skala kustom yang sudah berjalan harus diizinkan untuk terus berjalan. |
| VisualInteractionSourceRedirectionMode |
Menunjukkan input apa yang harus dialihkan ke InteractionTracker. |