DataTemplate.RecycleElement(ElementFactoryRecycleArgs) Metode

  • Referensi

Definisi

Ruang nama:
Windows.UI.Xaml
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)

Persyaratan Windows

Rangkaian perangkat
Windows 10, version 1809 (diperkenalkan dalam 10.0.17763.0)
API contract
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v7.0)

Keterangan

Metode RecycleElement digunakan untuk menyisihkan elemen untuk digunakan kembali nanti, tetapi tidak secara otomatis mengatur ulang status elemen saat ini. Misalnya, jika Latar BelakangKontrol 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 instans baru akan membuat instans baru menggunakan LoadContent.

Mendaur ulang elemen mungkin tidak segera menyebabkan elemen dihapus dari pohon elemen langsung. Dalam situasi tersebut peristiwa Yang Dimuat Tidak Dimuat/ tidak dinaikkan 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 , getElement akan mencari elemen tempat didaur ulang untuk Induk yang sama. Jika masih dilampirkan ke elemen induk, elemen tersebut 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, 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

Lihat juga