NavigationThemeTransition Kelas

Referensi

Definisi

Ruang nama:: Microsoft.UI.Xaml.Media.Animation

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.

Edit

Menyediakan animasi navigasi halaman.

public ref class NavigationThemeTransition sealed : Transition

/// [Microsoft.UI.Xaml.Markup.ContentProperty(Name="DefaultNavigationTransitionInfo")]
/// [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 NavigationThemeTransition final : Transition

[Microsoft.UI.Xaml.Markup.ContentProperty(Name="DefaultNavigationTransitionInfo")]
[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 NavigationThemeTransition : Transition

Public NotInheritable Class NavigationThemeTransition
Inherits Transition

<NavigationThemeTransition .../>

Warisan: Object Platform::Object IInspectable DependencyObject Transition NavigationThemeTransition

Atribut: ContentPropertyAttribute ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Contoh

Tip

Untuk informasi selengkapnya, panduan desain, dan contoh kode, lihat Transisi halaman.

Buka aplikasi Galeri WinUI 3 dan lihat PageTransitions beraksi.

Aplikasi WinUI 3 Gallery mencakup contoh interaktif sebagian besar kontrol, fitur, dan fungsi WinUI 3. Dapatkan aplikasi dari Microsoft Store atau dapatkan kode sumber di GitHub.

Keterangan

Dengan Windows 10, versi 1803, Bingkai menggunakan NavigationThemeTransition untuk menganimasikan navigasi antar Halaman secara default.

Anda dapat menggunakan NavigationThemeTransition untuk menambahkan transisi animasi saat aplikasi Anda menavigasi di antara berbagai bagian konten dalam Bingkai. Anda dapat menambahkan NavigationThemeTransition ke koleksi Transisi Halaman yang sedang dinavigasi, atau koleksi ContentTransitions untuk Bingkai navigasi. Secara umum, kami sarankan Anda menggunakan properti ContentTransitions bingkai untuk memastikan bahwa transisi terjadi untuk semua halaman navigasi.

Contoh ini memperlihatkan NavigationThemeTransition yang ditambahkan ke koleksi ContentTransitions dari Bingkai.

<Frame ...>
    <Frame.ContentTransitions>
        <TransitionCollection>
            <NavigationThemeTransition/> 
        </TransitionCollection> 
    </Frame.ContentTransitions> 
    ...
</Frame>

var frame = new Frame(); 
frame.ContentTransitions = new TransitionCollection(); 
frame.ContentTransitions.Add(new NavigationThemeTransition());

Dalam Windows 10, dua animasi berbeda disediakan untuk navigasi antar halaman dalam aplikasi. Animasi navigasi diwakili oleh subkelas NavigationTransitionInfo.

Penyegaran Halaman: Penyegaran halaman adalah animasi default untuk navigasi halaman. Ini adalah kombinasi dari animasi slide up dan memudar dalam animasi untuk konten masuk. Anda harus menggunakan refresh halaman saat menggunakan navigasi tingkat atas seperti menu navigasi.

Animasi refresh halaman diwakili oleh kelas EntranceNavigationTransitionInfo . Anda dapat menggunakan properti terlampir EntranceNavigationTransitionInfo.IsTargetElement untuk menerapkan gerakan refresh halaman ke subset halaman; misalnya, semua konten tidak termasuk UI perintah halaman.

Penelusuran Masuk: Anda harus menggunakan penelusuran animasi saat pengguna berinteraksi dengan UI di halaman yang mewakili tautan ke halaman lain. Misalnya, di halaman yang mewakili daftar album, ketika pengguna mengklik item album, harus ada latihan dalam transisi ke halaman album.

Latihan dalam animasi diwakili oleh kelas DrillInNavigationTransitionInfo .

Secara default, NavigationThemeTransition memutar animasi refresh halaman. Namun, Anda dapat mengambil alih perilaku ini dengan mengatur properti DefaultNavigationTransitionInfo dari NavigationThemeTransition. Nilai NavigationTransitionInfo dari properti ini digunakan untuk semua navigasi secara default.

Anda dapat menentukan animasi yang akan digunakan untuk navigasi tertentu dengan menggunakan kelebihan beban Frame.Navigate yang mengambil 3 parameter.

Dalam contoh ini, saat pengguna "menelusuri" dari daftar album ke halaman yang mewakili album tertentu, aplikasi penjelajahan musik meminta latihan di animasi.

void AlbumsListView_ItemClick(object sender, ItemClickEventArgs e) 
{
    // Get albumId from clicked item... 
    Frame.Navigate(typeof(AlbumPage), albumId, new DrillInNavigationTransitionInfo());
}

Selain itu, Anda dapat menggunakan Frame.GoBack(NavigationTransitionInfo) untuk memutar transisi tertentu saat menavigasi kembali di tumpukan belakang Bingkai . Ini dapat berguna ketika Anda memodifikasi perilaku navigasi secara dinamis berdasarkan ukuran layar; misalnya, dalam skenario master/detail responsif. Untuk contoh selengkapnya, lihat sampel master/detail XAML.

SuppressNavigationTransitionInfo

Anda dapat menggunakan SuppressNavigationTransitionInfo di tempat subjenis NavigationTransitionInfo lainnya ketika Anda ingin menghindari pemutaran animasi apa pun selama navigasi.

// Navigate to your first page without a transition 
Frame.Navigate(typeof(MainPage), null, new SuppressNavigationTransitionInfo());

Konstruktor

NavigationThemeTransition()

Menginisialisasi instans baru dari kelas NavigationThemeTransition .

Properti

DefaultNavigationTransitionInfo	Mendapatkan atau mengatur transisi default yang digunakan saat menavigasi antar halaman.
DefaultNavigationTransitionInfoProperty	Mengidentifikasi properti dependensi DefaultNavigationTransitionInfo .
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)

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)

Berlaku untuk

Bagikan melalui