GettingFocusEventArgs.CorrelationId Properti

Referensi

Definisi

Ruang nama:: Windows.UI.Xaml.Input

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

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

Guid

Platform::Guid

winrt::guid

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).

Berlaku untuk

Bagikan melalui