UIElement.BringIntoViewRequested Kejadian
Definisi
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.
Terjadi ketika StartBringIntoView dipanggil pada elemen ini atau salah satu turunannya.
// Register
event_token BringIntoViewRequested(TypedEventHandler<UIElement, BringIntoViewRequestedEventArgs const&> const& handler) const;
// Revoke with event_token
void BringIntoViewRequested(event_token const* cookie) const;
// Revoke with event_revoker
UIElement::BringIntoViewRequested_revoker BringIntoViewRequested(auto_revoke_t, TypedEventHandler<UIElement, BringIntoViewRequestedEventArgs const&> const& handler) const;
public event TypedEventHandler<UIElement,BringIntoViewRequestedEventArgs> BringIntoViewRequested;
function onBringIntoViewRequested(eventArgs) { /* Your code */ }
uIElement.addEventListener("bringintoviewrequested", onBringIntoViewRequested);
uIElement.removeEventListener("bringintoviewrequested", onBringIntoViewRequested);
- or -
uIElement.onbringintoviewrequested = onBringIntoViewRequested;
Public Custom Event BringIntoViewRequested As TypedEventHandler(Of UIElement, BringIntoViewRequestedEventArgs)
Jenis Acara
Persyaratan Windows
Rangkaian perangkat |
Windows 10, version 1803 (diperkenalkan dalam 10.0.17134.0)
|
API contract |
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v6.0)
|
Keterangan
Catatan
Kerangka kerja juga dapat meningkatkan peristiwa sebagai respons terhadap elemen yang menerima fokus melalui keyboard atau gamepad, atau ketika teknologi bantuan menjalankan metode ScrollIntoViewIScrollItemProvider pada peer otomatisasi elemen.
Kejadian ini memungkinkan kontrol untuk berpartisipasi dalam proses menampilkan elemen. Ini menunjukkan kontrol induk, seperti ScrollViewer, bahwa elemen yang menaikkan peristiwa harus dibuat terlihat dalam wilayah yang dapat digulirkan. Kontrol non-gulir dapat menggunakan peristiwa sebagai cara untuk mengubah permintaan yang berasal dari salah satu turunannya dengan memodifikasi data peristiwa (BringIntoViewRequestedEventArgs). Misalnya, Anda dapat mendengarkan peristiwa pada elemen induk untuk memperbesar TargetRect dan memastikan jumlah minimum padding disertakan saat menampilkan salah satu elemen turunannya.
Secara umum, data peristiwa (BringIntoViewRequestedEventArgs) tidak boleh ditandai ditangani. Melakukannya dapat mengganggu tujuan yang dimaksudkan ketika StartBringIntoView dipanggil. Data peristiwa lainnya dapat dimodifikasi sebagai gelembung peristiwa hingga mengubah permintaan. Secara khusus, kontrol gulir induk diharapkan memodifikasi data peristiwa untuk mempertangungjawabkan kontribusinya, baik sebagian atau sepenuhnya memenuhi permintaan. Minimal, penggulir diharapkan untuk menetapkan dirinya sebagai TargetElement dan memperbarui TargetRect ke ruang koordinatnya sendiri. Untuk situasi di mana elemen berada dalam penggulung yang berada dalam penggulung, masing-masing harus bereaksi untuk memenuhi perataan yang diminta.
OriginalSource harus digunakan untuk menentukan elemen tempat peristiwa awalnya dinaikkan mengingat bahwa TargetElement dapat dimodifikasi sebagai gelembung peristiwa.
BringIntoViewRequested adalah peristiwa yang dirutekan. Untuk informasi selengkapnya tentang konsep peristiwa yang dirutekan, lihat Gambaran umum peristiwa dan peristiwa yang dirutekan.