UIElement.Focus Methode

Definition

Versucht, den Fokus auf dieses Element festzulegen.

public:
 virtual bool Focus();
public bool Focus ();
abstract member Focus : unit -> bool
override this.Focus : unit -> bool
Public Function Focus () As Boolean

Gibt zurück

true, wenn der logische und der Tastaturfokus auf dieses Element festgelegt wurden, false, wenn nur der logische Fokus auf dieses Element festgelegt wurde oder wenn durch den Aufruf dieser Methode keine Fokusänderung erzwungen wurde.

Implementiert

Beispiele

Im folgenden Beispiel wird der Fokus auf eine TextBox festgelegt, auf die von verwiesen wird Name, und dann die Position des Cursors innerhalb von TextBoxangepasst.

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

Hinweise

Um fokussierbar zu sein, Focusable und IsEnabled müssen beide sein true.

Selbst wenn das Element fokussierbar und gültig ist, können die Focus Vorschauereignisse in einer bestimmten Struktur verarbeitet werden, und der Fokus auf dieses Element ist möglicherweise nicht zulässig (z. B. in einem zusammengesetzten Steuerelement). In diesem Fall gibt diese Methode zurück false.

Im Allgemeinen wird der Fokus durch zwei verschiedene Konzepte gesteuert: Tastaturfokus und logischer Fokus. Diese beiden Konzepte sind nicht immer gleich. Weitere Informationen finden Sie unter Fokuszusammenfassung und Eingabeübersicht.

Wenn der Aufruf Focus zurückgibt true, IsKeyboardFocused und IsKeyboardFocusWithin sind ebenfalls true.

Wenn die zugehörigen Eigenschaften noch nicht truesind, wird beim Aufrufen Focusvon eines oder mehrerer der folgenden Ereignisse in der folgenden Reihenfolge ausgelöst: PreviewLostKeyboardFocus, PreviewGotKeyboardFocus (Quelle ist das neue Fokusziel), IsKeyboardFocusedChanged, IsKeyboardFocusWithinChanged, LostKeyboardFocus, GotKeyboardFocus (Quelle ist das neue Fokusziel).

Damit dieser Aufruf erfolgreich war, musste ein anderes Element in der Anwendung zuvor den Fokus haben.

Gilt für: