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 ayarlandıysa veya bu yönteme yapılan çağrı odağı değiştirmeye zorlamadıysa.

Uygulamalar

Focus()

Örnekler

Aşağıdaki örnek, odağı tarafından Namebaşvuruda bulunan bir TextBox olarak ayarlar ve sonra imlecin içindeki TextBoxkonumunu ayarlar.

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

Odaklanabilir 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 denetlener: 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ğırdığınızda Focusaş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 başka bir öğenin daha önce odaklanması gerekiyordu. Ayrıca, bir üst kapsayıcı öğesi bu yöntemi çağırdığında, bazı durumlarda alt odak alır ve dönüş değeri olur false. Öğenin odağı olup olmadığını test etmek için ve IsKeyboardFocused özelliklerini kullanınIsKeyboardFocusWithin.