UIElement.Focus Yöntem

Tanım

Ad Alanı:

System.Windows

Bütünleştirilmiş Kod:

PresentationCore.dll

Odağı bu öğeye ayarlamaya çalışır.

public:
 virtual bool Focus();

public bool Focus ();

abstract member Focus : unit -> bool
override this.Focus : unit -> bool

Public Function Focus () As Boolean

Döndürülenler

Boolean

true klavye odağı ve mantıksal odak bu öğeye ayarlanmışsa; false yalnızca mantıksal odak bu öğeye ayarlanmışsa veya bu yöntem çağrısı odağı değiştirmeye zorlamadıysa.

Uygulamalar

Focus()

Örnekler

Aşağıdaki örnekte odak, tarafından Namebaşvuruda bulunularak TextBox ayarlanır ve imlecin içindeki TextBoxkonumu ayarlanır.

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

Açıklamalar

Odaklanılabilir Focusable olması ve IsEnabled her ikisinin de olması truegerekir.

Öğe odaklanabilir ve geçerli olsa bile, Focus önizleme olayları belirli bir ağaçta işlenebilir ve bu öğeye odaklanmaya izin verilmeyebilir (örneğin, bileşik denetimde). Böyle bir durumda, bu yöntem döndürür false.

Genel olarak, odak iki farklı kavram tarafından denetlenilir: klavye odağı ve mantıksal odak. Bu iki kavram her zaman aynı değildir. Daha fazla bilgi için bkz . Odak özeti ve Girişe Genel Bakış.

Çağrısı Focus döndürülüyorsa IsKeyboardFocusedtrueve IsKeyboardFocusWithin de trueolur.

İlgili özellikler henüz truedeğilse, çağrısı Focusyaptığınızda aşağıdaki olaylardan biri veya daha fazlası şu sırayla oluşturulur: PreviewLostKeyboardFocus, PreviewGotKeyboardFocus (kaynak yeni odak hedefidir), IsKeyboardFocusedChanged, IsKeyboardFocusWithinChanged, LostKeyboardFocus, GotKeyboardFocus (kaynak yeni odak hedefidir).

Bu çağrının başarılı olması için, uygulamadaki diğer bazı öğelerin daha önce odaklanması gerekiyordu.