UIElement.Focus Metode

Referensi

Definisi

Ruang nama:: System.Windows

Rakitan:: PresentationCore.dll

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

Boolean

true jika fokus keyboard dan fokus logis diatur ke elemen ini; false jika hanya fokus logis yang diatur ke elemen ini, atau jika panggilan ke metode ini tidak memaksa fokus untuk berubah.

Penerapan

Focus()

Contoh

Contoh berikut mengatur fokus ke yang dirujuk TextBox oleh Name, lalu menyesuaikan posisi kursor dalam TextBox.

void OnClickMoveToStart(object sender, RoutedEventArgs e)
{
    tbPositionCursor.Focus();
    tbPositionCursor.Select(0, 0);
}

Private Sub OnClickMoveToStart(ByVal sender As Object, ByVal e As RoutedEventArgs)

    tbPositionCursor.Focus()
    tbPositionCursor.Select(0, 0)

End Sub

Keterangan

Agar dapat difokuskan, Focusable dan IsEnabled keduanya harus true.

Bahkan jika elemen dapat difokuskan dan valid, Focus peristiwa pratinjau dapat diproses di pohon tertentu, dan fokus pada elemen tersebut mungkin tidak diizinkan (misalnya, dalam kontrol komposit). Dalam kasus seperti itu, metode ini mengembalikan false.

Secara umum, fokus dikendalikan oleh dua konsep berbeda: fokus keyboard dan fokus logis. Kedua konsep ini tidak selalu sama. Untuk informasi selengkapnya, lihat Ringkasan 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).

Agar panggilan ini berhasil, beberapa elemen lain dalam aplikasi perlu memiliki fokus sebelumnya. Selain itu, ketika elemen kontainer induk memanggil metode ini, dalam situasi tertentu anak mendapatkan fokus dan nilai yang dikembalikan adalah false. Untuk menguji apakah elemen memiliki fokus, gunakan IsKeyboardFocusWithin properti dan IsKeyboardFocused .

Berlaku untuk

Bagikan melalui