ContentElement.Focus ContentElement.Focus ContentElement.Focus ContentElement.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 Tastaturfokus auf dieses Element festgelegt werden konnte, false, wenn dieser Methodenaufruf keinen Fokus erzwungen hat.true if keyboard focus could be set to this element; false if this method call did not force focus.

Implementiert

Beispiele

Im folgenden Beispiel ist ein Ereignishandler Laden der Seite, der einem angegebenen mit dem Namen Absatz des Dokuments sucht und legt den Fokus zuzuweisen.The following example is a page-loaded event handler that finds a specified named paragraph in the document and sets focus to it. Absätze sind nicht standardmäßig den Fokus erhalten. diesem spezifischen Absatz wurde ein Format angewendet wird (nicht gezeigt), verwendet einen Stil Setter zu vereinfachen den Fokus erhalten kann.Paragraphs are not focusable by default; this particular paragraph had a style applied (not shown) that used a style Setter to make it focusable.

void FocusOnParagraph(object sender, RoutedEventArgs e)
{
  ContentElement ce = this.FindName("focusableP") as ContentElement;
  ce.Focus();
}
Private Sub FocusOnParagraph(ByVal sender As Object, ByVal e As RoutedEventArgs)
  Dim ce As ContentElement = TryCast(Me.FindName("focusableP"), ContentElement)
  ce.Focus()
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. Beachten Sie, dass fast alle ContentElement abgeleitete Klassen sind nicht Focusable standardmäßig.Note that nearly all ContentElement derived classes are not Focusable by default.

Auch wenn ein Element den Fokus erhalten kann und aktiviert ist, Ereignisbehandlung in einer bestimmten Struktur ist, (z.B. für ein zusammengesetztes Steuerelement) mit nicht zugelassen, Fokus auf die Vorschau Fokusereignisse Antworten daher diese Methode würde zurückgeben false.Even if an element is focusable and enabled, event handling within a specific tree, (such as for a composite control) might respond to the preview focus events by not allowing focus there, thus this method would return false.

Fokus wird im Allgemeinen durch zwei getrennte Konzepte gesteuert: Tastaturfokus und logischer Fokus, die nicht immer identisch sind.Focus in general is governed by two separate concepts: keyboard focus and logical focus, which are not always identical. Diese Methode legt den logischen Fokus.This method sets the logical focus. Es gibt keine programmgesteuerte Möglichkeit zum Festlegen des Tastaturfokus. über den Tastaturfokus richtet sich nach Eingabe des Benutzers.There is no programmatic means to set keyboard focus specifically; keyboard focus is determined by user input. Weitere Informationen finden Sie unter Fokus – Übersicht und Übersicht über die Eingabe.For more information, see Focus Overview 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).

Gilt für:

Siehe auch