UIElement.Focus UIElement.Focus UIElement.Focus UIElement.Focus Method

Definition

Versucht, den Fokus auf dieses Element festzulegen.Attempts to set focus to this element.

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.true if keyboard focus and logical focus were set to this element; false if only logical focus was set to this element, or if the call to this method did not force the focus to change.

Implementiert

Beispiele

Im folgende Beispiel legt den Fokus auf eine TextBox verwiesen wird, indem Name, und klicken Sie dann passt die Position des Cursors innerhalb der TextBox.The following example sets focus to a TextBox referenced by Name, and then adjusts the position of the cursor within the 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 den Fokus erhalten kann, werden Focusable und IsEnabled müssen true.To be focusable, Focusable and IsEnabled must both be true.

Auch wenn das Element den Fokus erhalten kann und gültig ist, ist die Focus Vorschauereignisse in einer bestimmten Struktur verarbeitet werden können, und den Fokus auf dieses Element kann (z. B. in einem zusammengesetzten Steuerelement) nicht möglich.Even if the element is focusable and valid, the Focus preview events may be processed in a specific tree, and focus on that element may not be allowed (for example, in a composite control). In diesem Fall gibt diese Methode false.In such a case, this method returns false.

Im Allgemeinen den Fokus durch zwei verschiedene Konzepte gesteuert: Tastaturfokus und logischer Fokus.In general, focus is controlled by two different concepts: keyboard focus and logical focus. Diese beiden Konzepte sind nicht immer mit identisch.These two concepts are not always the same. Weitere Informationen finden Sie unter Fokus-Übersicht und Übersicht über die Eingabe.For more information, see Focus summary and Input Overview.

Wenn der Aufruf Focus gibt true, IsKeyboardFocused und IsKeyboardFocusWithin sind auch true.If calling Focus returns true, IsKeyboardFocused and IsKeyboardFocusWithin are also true.

Wenn die zugehörigen Eigenschaften nicht bereits sind true, beim Aufrufen Focus, eine oder mehrere der folgenden Ereignisse werden in der folgenden Reihenfolge ausgelöst: PreviewLostKeyboardFocus, PreviewGotKeyboardFocus (Quelle ist die neue Ziel mit Fokus), IsKeyboardFocusedChanged, IsKeyboardFocusWithinChanged, LostKeyboardFocus, GotKeyboardFocus (Quelle ist das neue Fokusziel).If the related properties are not already true, when you call Focus, one or more of the following events are raised in the following order: PreviewLostKeyboardFocus, PreviewGotKeyboardFocus (source is the new focus target), IsKeyboardFocusedChanged, IsKeyboardFocusWithinChanged, LostKeyboardFocus, GotKeyboardFocus (source is the new focus target).

In der Reihenfolge, damit dieser Aufruf erfolgreich ist, muss ein anderes Element in der Anwendung erforderlich, um den Fokus bereits besitzen.In order for this call to be successful, some other element in the application needed to have focus previously.

Gilt für: