GettingFocusEventArgs.CorrelationId Properti
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.
Mendapatkan ID unik yang dihasilkan saat peristiwa gerakan fokus dimulai.
public:
property Platform::Guid CorrelationId { Platform::Guid get(); };
winrt::guid CorrelationId();
public Guid CorrelationId { get; }
var guid = gettingFocusEventArgs.correlationId;
Public ReadOnly Property CorrelationId As Guid
Nilai Properti
ID unik, jika ada. Jika tidak, null.
Defaultnya adalah null.
Persyaratan Windows
Rangkaian perangkat |
Windows 10, version 1809 (diperkenalkan dalam 10.0.17763.0)
|
API contract |
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v7.0)
|
Keterangan
Pemindahan fokus dapat menghasilkan sejumlah tindakan langsung dan tidak langsung.
Misalnya, ada urutan standar peristiwa yang dimulai dengan LosingFocus dan bergerak melalui LostFocus, GettingFocus, ke GotFocus. Peristiwa fokus ini biasanya dirutekan melalui beberapa elemen di pohon elemen (termasuk FocusManager).
Dalam beberapa kasus, peristiwa fokus juga bisa dirutekan kembali. Misalnya, jika elemen target tidak valid karena alasan tertentu, Anda mungkin memanggil TrySetNewFocusedElement dari peristiwa LosingFocus untuk menargetkan kembali fokus ke elemen lain.
Dalam kasus lain, Anda mungkin perlu membatalkan perubahan fokus dari salah satu penanganan aktivitas fokus Anda.
Selain itu, karena peristiwa fokus dimunculkan secara asinkron, fokus mungkin berubah lagi sebelum peristiwa fokus sebelumnya selesai dieksekusi.
Setiap kali peristiwa fokus dimulai, CorrelationId unik dibuat untuk membantu Anda melacak peristiwa fokus di seluruh tindakan fokus ini.
CorrelationId baru dihasilkan ketika:
- Pengguna memindahkan fokus.
- Aplikasi memindahkan fokus menggunakan metode seperti Control.Focus atau FocusManager.TryFocusAsync.
- Aplikasi mendapatkan/kehilangan fokus karena aktivasi jendela (lihat CoreWindow.Activated).