Sdílet prostřednictvím


UIElement.Focus Metoda

Definice

Pokusí se nastavit fokus na tento prvek.

public:
 virtual bool Focus();
public bool Focus ();
abstract member Focus : unit -> bool
override this.Focus : unit -> bool
Public Function Focus () As Boolean

Návraty

true pokud fokus klávesnice a logické fokus byly nastaveny na tento prvek; false pokud byl na tento prvek nastaven pouze logický fokus nebo pokud volání této metody nevynutilo změnu fokusu.

Implementuje

Příklady

Následující příklad nastaví fokus na objekt, na který TextBoxNameodkazuje , a pak upraví pozici kurzoru v objektu 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

Poznámky

Chcete-li být prioritní, Focusable a IsEnabled musí být trueoba .

I když je prvek aktivní a platný, události náhledu Focus se můžou zpracovávat v určitém stromu a fokus na tento prvek nemusí být povolený (například ve složeného ovládacím prvku). V takovém případě tato metoda vrátí false.

Obecně platí, že fokus je řízen dvěma různými koncepty: fokusem klávesnice a logickým fokusem. Tyto dva koncepty nejsou vždy stejné. Další informace najdete v tématu Souhrn fokusu a Přehled vstupu.

Pokud volání Focus vrátí , IsKeyboardFocusedtruea IsKeyboardFocusWithin jsou také true.

Pokud související vlastnosti ještě truenejsou , při volání Focusse vyvolá jedna nebo více následujících událostí v následujícím pořadí: PreviewLostKeyboardFocus, PreviewGotKeyboardFocus (zdroj je nový cíl fokusu), IsKeyboardFocusedChanged, IsKeyboardFocusWithinChanged, LostKeyboardFocus( GotKeyboardFocus zdroj je nový cíl fokusu).

Aby bylo toto volání úspěšné, je potřeba, aby se na některé další prvky v aplikaci dříve zaměřily. Pokud nadřazený element kontejneru volá tuto metodu, v určitých situacích získá podřízený objekt fokus a návratová hodnota bude false. Pokud chcete otestovat, jestli má prvek fokus IsKeyboardFocusWithin , použijte vlastnosti a IsKeyboardFocused .

Platí pro