UIElement.Focus Methode

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 Tastaturfokus und der logische Fokus auf dieses Element festgelegt wurden; false wenn nur der logische Fokus auf dieses Element festgelegt wurde oder wenn der Aufruf dieser Methode die Änderung des Fokus nicht erzwungen hat.

Implementiert

Beispiele

Im folgenden Beispiel wird der Fokus auf einen TextBox Verweis Namefestgelegt, und anschließend wird die Position des Cursors innerhalb TextBoxdes Cursors angepasst.

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 muss beides sein true.

Auch wenn das Element fokussierbar und gültig ist, werden die Focus Vorschauereignisse möglicherweise in einer bestimmten Struktur verarbeitet, 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ückgegeben trueIsKeyboardFocusedwird und IsKeyboardFocusWithin auch true.

Wenn die zugehörigen Eigenschaften noch nicht truevorhanden sind, werden beim Aufrufen Focuseines 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 ist, muss 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 lautet false. Um zu testen, ob das Element den Fokus hat, verwenden Sie die und IsKeyboardFocusWithin die IsKeyboardFocused Eigenschaften.