UIElement.Focus Metoda

Definice

Obor názvů:

System.Windows

Sestavení:

PresentationCore.dll

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

Boolean

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

Implementuje

Focus()

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

Aby bylo možné se zaměřit, Focusable musí IsEnabled být trueobě hodnoty .

I když je prvek aktivní a platný, události náhledu Focus se můžou zpracovat 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: fokus klávesnice a logický fokus. Tyto dva koncepty nejsou vždy stejné. Další informace najdete v tématech Souhrn fokusu a Přehled vstupu.

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

Pokud související vlastnosti ještě truenejsou , při volání Focusse vygenerují některé z následujících událostí v následujícím pořadí: PreviewLostKeyboardFocus, PreviewGotKeyboardFocus (zdroj je nový cíl fokusu), IsKeyboardFocusedChanged, , IsKeyboardFocusWithinChanged, LostKeyboardFocusGotKeyboardFocus (zdroj je nový cíl fokusu).

Aby bylo toto volání úspěšné, je potřeba se dříve zaměřit na některé další prvky v aplikaci.