DataTemplate.RecycleElement(ElementFactoryRecycleArgs) Metode

Referensi

Definisi

Ruang nama:: Microsoft.UI.Xaml

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

Mendaur ulang UIElement yang sebelumnya diambil menggunakan GetElement.

void RecycleElement(ElementFactoryRecycleArgs const& args);

public void RecycleElement(ElementFactoryRecycleArgs args);

function recycleElement(args)

Public Sub RecycleElement (args As ElementFactoryRecycleArgs)

Parameter

args: ElementFactoryRecycleArgs

Instans ElementFactoryRecycleArgs.

Penerapan

RecycleElement(ElementFactoryRecycleArgs)

Keterangan

Metode RecycleElement digunakan untuk menyisihkan elemen untuk digunakan kembali nanti, tetapi tidak secara otomatis mengatur ulang status elemen saat ini. Misalnya, jika Latar Belakang Kontrol secara terprogram mengatur nilai tetap ada saat ditambahkan ke pohon langsung lagi.

Elemen daur ulang yang dikembalikan dari GetElement dapat ditambahkan ke pohon langsung dengan cara yang sama seperti elemen yang baru dibuat.

GetElement mencoba mengambil instans yang ada dari instans yang didaur ulang. Jika tidak ada yang ditemukan maka akan membuat instans baru menggunakan LoadContent.

Mendaur ulang elemen mungkin tidak segera menyebabkannya dihapus dari pohon elemen langsung. Dalam situasi itu, peristiwa Yang Dimuat Tidak Dimuat/ tidakdinaikkan kecuali ditambahkan ke elemen induk yang berbeda di pohon langsung.

Menentukan Induk tidak diperlukan saat memanggil RecycleElement. Namun, penggunaannya disarankan untuk mengaktifkan pengoptimalan performa. Ketika GetElement dipanggil dengan nilai Induk , ia akan mencari elemen di mana didaur ulang untuk Induk yang sama. Jika masih melekat pada elemen induk, maka mereka dapat digunakan kembali tanpa menimbulkan overhead tambahan untuk mengasuh kembali elemen.

Catatan

RecycleElement tidak secara otomatis mengecualikan elemen daur ulang agar tidak berpartisipasi dalam urutan tab. Juga tidak menyembunyikan peer otomatisasi elemen agar tidak muncul di pohon otomatisasi. Kontrol virtualisasi bawaan platform mengelola ini untuk elemen di bawah kendali mereka.

Jika Anda membuat kontrol virtualisasi kustom dari awal atau memanggil RecycleElement dalam skenario satu kali, maka ketahuilah bahwa Anda bertanggung jawab untuk mengecualikan elemen daur ulang dari urutan tab dan pohon rekan otomatisasi.

Anda dapat mengambil alih GetChildrenInTabFocusOrder dan menyediakan subset elemen yang direalisasikan yang harus digunakan kerangka kerja untuk Fokus tab. Demikian pula, peer otomatisasi untuk kontrol harus mengambil alih GetChildrenCore dan mengecualikan elemen daur ulang.

Berlaku untuk

Bagikan melalui