ContentElement.Focus Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Versucht, den Fokus auf dieses Element festzulegen.
public:
virtual bool Focus();public bool Focus ();abstract member Focus : unit -> bool
override this.Focus : unit -> boolPublic Function Focus () As BooleanGibt zurück
true, wenn der Tastaturfokus auf dieses Element festgelegt werden konnte, false, wenn dieser Methodenaufruf keinen Fokus erzwungen hat.
Implementiert
Beispiele
Das folgende Beispiel ist ein seitengeladener Ereignishandler, der einen angegebenen benannten Absatz im Dokument findet und den Fokus auf diesen festlegt. Absätze können standardmäßig nicht fokussiert werden. In diesem speziellen Absatz wurde eine Formatvorlage angewendet (nicht angezeigt), die eine Formatvorlage Setter verwendet hat, um sie fokussierbar zu machen.
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 fokussierbar zu sein, Focusable und IsEnabled müssen beide sein true. Beachten Sie, dass fast alle ContentElement abgeleiteten Klassen nicht Focusable standardmäßig sind.
Selbst wenn ein Element fokussierbar und aktiviert ist, kann die Ereignisbehandlung in einer bestimmten Struktur (z. B. für ein zusammengesetztes Steuerelement) auf die Vorschaufokusereignisse reagieren, indem der Fokus dort nicht zugelassen wird. Daher würde diese Methode zurückgeben false.
Der Fokus im Allgemeinen wird durch zwei separate Konzepte geregelt: Tastaturfokus und logischer Fokus, die nicht immer identisch sind. Diese Methode legt den logischen Fokus fest. Es gibt keine programmgesteuerten Mittel, um den Tastaturfokus speziell festzulegen. Der Tastaturfokus wird durch Benutzereingaben bestimmt. Weitere Informationen finden Sie unter Fokusübersicht 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).
