FocusManagerGotFocusEventArgs.CorrelationId Properti

Definisi

Ruang nama:

Windows.UI.Xaml.Input

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 = focusManagerGotFocusEventArgs.correlationId;

Public ReadOnly Property CorrelationId As Guid

Nilai Properti

Guid

Platform::Guid

winrt::guid

ID unik, jika ada. Jika tidak, null.

Defaultnya adalah null.

Keterangan

Sebaiknya gunakan peristiwa yang dirutekan fokus UIElement alih-alih peristiwa FocusManager jika memungkinkan.

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 ulang. Misalnya, jika elemen target tidak valid karena alasan tertentu, Anda dapat 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 dinaikkan secara asinkron, fokus mungkin berubah lagi sebelum peristiwa fokus sebelumnya selesai dieksekusi.

Setiap kali peristiwa fokus dimulai, CorrelationId unik dihasilkan 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).

Lihat juga

• CorrelationId
• Interaksi keyboard
• Navigasi fokus untuk keyboard, gamepad, remote control, dan alat aksesibilitas
• Navigasi fokus terprogram