UIElement.GotFocus Kejadian

  • Referensi

Definisi

Ruang nama:
Microsoft.UI.Xaml
Edit

Terjadi ketika UIElement menerima fokus. Kejadian ini dinaikkan secara asinkron, sehingga fokus dapat bergerak lagi sebelum gelembung selesai.

// Register
event_token GotFocus(RoutedEventHandler const& handler) const;

// Revoke with event_token
void GotFocus(event_token const* cookie) const;

// Revoke with event_revoker
UIElement::GotFocus_revoker GotFocus(auto_revoke_t, RoutedEventHandler const& handler) const;
public event RoutedEventHandler GotFocus;
function onGotFocus(eventArgs) { /* Your code */ }
uIElement.addEventListener("gotfocus", onGotFocus);
uIElement.removeEventListener("gotfocus", onGotFocus);
- or -
uIElement.ongotfocus = onGotFocus;
Public Custom Event GotFocus As RoutedEventHandler 
<uiElement GotFocus="eventhandler"/>

Jenis Acara

RoutedEventHandler

Keterangan

Sebaiknya gunakan fokus UIElement merutekan peristiwa alih-alih peristiwa FocusManager jika memungkinkan.

Hanya satu elemen UI pada satu waktu yang dapat memiliki fokus.

Kontrol bisa mendapatkan fokus ketika kontrol lain kehilangan fokus, tampilan aplikasi berubah, pengguna beralih aplikasi, atau pengguna berinteraksi dengan sistem sehingga aplikasi tidak lagi berada di latar depan.

LostFocus dinaikkan sebelum GotFocus.

Jika Anda menggunakan komposit kontrol atau komposit UI dan penanganan GotFocus pada kontainer seperti Panel atau GridView, tentukan elemen mana dalam komposisi yang menerima fokus dengan memeriksa OriginalSource pada data peristiwa.

GotFocus Karena peristiwa tidak memiliki data peristiwa khusus, Anda dapat memeriksa properti UIElement.FocusState untuk menentukan apakah itu kode pengguna atau aplikasi yang menyebabkan elemen mendapatkan fokus.

private void panel_GotFocus(object sender, RoutedEventArgs e)
{
    UIElement uie = e.OriginalSource as UIElement;
    FocusState fc = uie.FocusState;
}

Fokus keyboard sangat relevan untuk penanganan peristiwa keyboard, karena hanya UIElement yang saat ini berfokus pada keyboard yang dapat menjadi sumber peristiwa kunci KeyUp dan KeyDown . Aplikasi mungkin memanggil UIElement.Focus(Microsoft.UI.Xaml.FocusState) sebagai tindakan inisialisasi sehingga peristiwa utama di aplikasi secara keseluruhan dapat digunakan untuk mendeteksi kunci akses atau akselerator. Untuk informasi selengkapnya, lihat Interaksi keyboard.

GotFocus adalah peristiwa yang dirutekan. Untuk informasi selengkapnya tentang konsep peristiwa yang dirutekan, lihat Gambaran umum peristiwa dan peristiwa yang dirutekan.

Kontrol Windows Runtime tertentu mungkin memiliki penanganan berbasis kelas untuk peristiwa tersebut GotFocus . Jika demikian, kontrol mungkin memiliki penimpaan untuk metode OnGotFocus. Biasanya peristiwa ditandai ditangani oleh handler kelas, dan peristiwa GotFocus tidak dinaikkan untuk ditangani oleh penangan kode pengguna apa pun pada kontrol tersebut. Kontrol mungkin menangani peristiwa untuk memuat properti status visual yang menampilkan persegi panjang fokus.

Persegi panjang fokus kontrol adalah komponen visual penting yang membantu aksesibilitas dengan mengidentifikasi elemen yang berfokus saat ini dan menunjukkan di mana pengguna berada dalam urutan tab UI aplikasi. Dalam beberapa kasus, FocusState tindakan fokus relevan untuk apakah indikator fokus yang terlihat harus ditampilkan.

Untuk informasi selengkapnya tentang cara kerja penanganan berbasis kelas untuk peristiwa, lihat Gambaran umum peristiwa dan peristiwa yang dirutekan. Untuk informasi selengkapnya tentang urutan dan aksesibilitas tab, lihat Aksesibilitas keyboard.

Berlaku untuk

Lihat juga