UIElement.Focus Methode

Definition

Namespace:

System.Windows

Assembly:

PresentationCore.dll

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

Boolean

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

Focus()

Beispiele

Das folgende Beispiel legt den Fokus auf einen TextBox fest, auf den von verwiesen wird Name, und passt dann die Position des Cursors innerhalb von an 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

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 einem solchen 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 identisch. Weitere Informationen finden Sie unter Fokuszusammenfassung und Eingabeübersicht.

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

Wenn die zugehörigen Eigenschaften nicht bereits truesind, werden beim Aufrufen Focusmindestens eines 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 ist, musste ein anderes Element in der Anwendung zuvor den Fokus haben. Wenn ein übergeordnetes Containerelement diese Methode aufruft, erhält das untergeordnete Element in bestimmten Situationen den Fokus, und der Rückgabewert ist false. Um zu testen, ob das Element den Fokus hat, verwenden Sie die IsKeyboardFocusWithin Eigenschaften und IsKeyboardFocused .