ContentElement.Focus Metode
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.
Mencoba mengatur fokus ke elemen ini.
public:
virtual bool Focus();
public bool Focus ();
abstract member Focus : unit -> bool
override this.Focus : unit -> bool
Public Function Focus () As Boolean
Mengembalikan
true
jika fokus keyboard dapat diatur ke elemen ini; false
jika panggilan metode ini tidak memaksa fokus.
Penerapan
Contoh
Contoh berikut adalah penanganan aktivitas yang dimuat halaman yang menemukan paragraf bernama tertentu dalam dokumen dan mengatur fokus ke dalamnya. Paragraf tidak dapat difokuskan secara default; paragraf khusus ini memiliki gaya yang diterapkan (tidak ditampilkan) yang menggunakan gaya Setter untuk membuatnya dapat difokuskan.
void FocusOnParagraph(object sender, RoutedEventArgs e)
{
ContentElement ce = this.FindName("focusableP") as ContentElement;
ce.Focus();
}
Private Sub FocusOnParagraph(ByVal sender As Object, ByVal e As RoutedEventArgs)
Dim ce As ContentElement = TryCast(Me.FindName("focusableP"), ContentElement)
ce.Focus()
End Sub
Keterangan
Agar dapat difokuskan, Focusable dan IsEnabled keduanya harus true
. Perhatikan bahwa hampir semua ContentElement kelas turunan tidak Focusable secara default.
Bahkan jika elemen dapat difokuskan dan diaktifkan, penanganan peristiwa dalam pohon tertentu, (seperti untuk kontrol komposit) mungkin merespons peristiwa fokus pratinjau dengan tidak mengizinkan fokus di sana, sehingga metode ini akan mengembalikan false
.
Fokus secara umum diatur oleh dua konsep terpisah: fokus keyboard dan fokus logis, yang tidak selalu identik. Metode ini menetapkan fokus logis. Tidak ada cara terprogram untuk mengatur fokus keyboard secara khusus; fokus keyboard ditentukan oleh input pengguna. Untuk informasi selengkapnya, lihat Gambaran Umum Fokus dan Gambaran Umum Input.
Jika panggilan Focus mengembalikan true
, IsKeyboardFocused dan IsKeyboardFocusWithin juga true
.
Jika properti terkait belum true
, saat Anda memanggil Focus, satu atau beberapa peristiwa berikut dinaikkan dalam urutan berikut: PreviewLostKeyboardFocus, ( PreviewGotKeyboardFocus sumber adalah target fokus baru), IsKeyboardFocusedChanged, IsKeyboardFocusWithinChanged, LostKeyboardFocus, GotKeyboardFocus (sumber adalah target fokus baru).