ContentElement.Focus Methode

Referenz

Definition

Namespace:: System.Windows

Assembly:: PresentationCore.dll

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 -> bool

Public Function Focus () As Boolean

Gibt zurück

Boolean

true, wenn der Tastaturfokus auf dieses Element festgelegt werden konnte, false, wenn dieser Methodenaufruf keinen Fokus erzwungen hat.

Implementiert

Focus()

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).

Gilt für: