UIElement.Focus Methode

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 folgenden Beispiel wird der Fokus auf eine TextBox, auf die Nameverweist, festgelegt und dann die Position des Cursors innerhalb der TextBoxangepasst.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

Focusable und IsEnabled müssen beide truesein, damit Sie als focbrauchbar sind.To be focusable, Focusable and IsEnabled must both be true.

Auch wenn das-Element fokussierbar und gültig ist, können die Focus Vorschau Ereignisse in einer bestimmten Struktur verarbeitet werden, und der Fokus auf dieses Element ist möglicherweise nicht zulässig (z. b. in einem zusammengesetzten Steuerelement).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 einem solchen Fall gibt diese Methode falsezurück.In such a case, this method returns false.

Im Allgemeinen wird der 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 identisch.These two concepts are not always the same. Weitere Informationen finden Sie unter Fokus Übersicht und Eingabe Übersicht.For more information, see Focus summary and Input Overview.

Wenn das Aufrufen von Focus truezurückgibt, werden IsKeyboardFocused und IsKeyboardFocusWithin ebenfalls true.If calling Focus returns true, IsKeyboardFocused and IsKeyboardFocusWithin are also true.

Wenn die zugehörigen Eigenschaften nicht bereits truesind, werden beim aufzurufen von Focusmindestens eines der folgenden Ereignisse in der folgenden Reihenfolge ausgelöst: PreviewLostKeyboardFocus, PreviewGotKeyboardFocus (Quelle ist das neue Fokus Ziel), IsKeyboardFocusedChanged, IsKeyboardFocusWithinChanged, LostKeyboardFocusGotKeyboardFocus (Quelle ist das neue Fokus Ziel).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).

Damit dieser-Befehl erfolgreich ausgeführt werden kann, musste ein anderes Element in der Anwendung zuvor den Fokus haben.In order for this call to be successful, some other element in the application needed to have focus previously.

Gilt für: