CompositionTarget.Rendering Kejadian

Definisi

Ruang nama:

Microsoft.UI.Xaml.Media

Terjadi ketika proses penyajian inti merender bingkai.

// Register
static event_token Rendering(EventHandler<IInspectable> const& handler) const;

// Revoke with event_token
static void Rendering(event_token const* cookie) const;

// Revoke with event_revoker
static CompositionTarget::Rendering_revoker Rendering(auto_revoke_t, EventHandler<IInspectable> const& handler) const;

public static event System.EventHandler<object> Rendering;

function onRendering(eventArgs) { /* Your code */ }
Microsoft.UI.Xaml.Media.CompositionTarget.addEventListener("rendering", onRendering);
Microsoft.UI.Xaml.Media.CompositionTarget.removeEventListener("rendering", onRendering);
- or -
Microsoft.UI.Xaml.Media.CompositionTarget.onrendering = onRendering;

Public Shared Custom Event Rendering As EventHandler(Of Object) 

Jenis Acara

EventHandler<Object>

EventHandler<Object>

EventHandler<IInspectable>

Keterangan

Menangani Penyajian dapat berguna jika Anda memiliki skenario interop dengan konten Microsoft DirectX. Misalnya Anda mungkin ingin tahu kapan kerangka kerja XAML merender bingkai dan menyinkronkan itu dengan konten yang dihasilkan Microsoft DirectX Anda dalam SwapChainPanel atau SurfaceImageSource sehingga pembaruan visual disajikan ke layar secara bersamaan. Untuk informasi selengkapnya, lihat Interop DirectX dan XAML.

Untuk memenuhi pengompilasi, parameter e/args kedua dari handler Anda untuk peristiwa Rendering harus Objek. Jangan gunakan EventArgs. Namun, dalam handler, Anda dapat mentransmisikan referensi e/args sebagai RenderingEventArgs. RenderingEventArgs memiliki satu properti, RenderingTime, yang mungkin berguna dalam skenario penyajian Anda, tetapi tidak semua penangan akan membutuhkan info ini. Mungkin cukup hanya untuk mengetahui bahwa peristiwa terjadi dan menangani setiap kejadian.

Handler untuk Rendering berjalan pada utas UI meskipun tidak terikat dengan elemen UI tertentu. Ini mirip dengan menjalankan animasi tak terbatas. Biasanya utas UI hanya aktif ketika ada pekerjaan yang harus dilakukan, tetapi menambahkan handler untuk peristiwa ini memaksanya untuk menjalankan setiap bingkai yang dapat mencegah pengoptimalan penggunaan daya sistem. Oleh karena itu ada baiknya untuk menghapus handler Rendering ketika Anda tidak lagi membutuhkannya, dan menambahkannya hanya ketika Anda membutuhkannya. Misalnya tambahkan handler hanya ketika halaman tertentu dengan konten DirectX yang disinkronkan dimuat, lalu hapus handler sebagai bagian dari pembersihan halaman (Page.OnNavigatedFrom). Untuk informasi selengkapnya, lihat bagian Menggunakan animasi tak terbatas dari panduan performa.

Lihat juga

• Rendered
• Interop DirectX dan XAML
• Mengoptimalkan animasi dan media