UIElement.Focus Method
Updated: January 2010
Attempts to set focus to this element.
Assembly: PresentationCore (in PresentationCore.dll)
You cannot use methods in XAML.
Return Value
Type: System.Booleantrue if keyboard focus and logical focus were set to this element; false if only logical focus was set to this element, or if the call to this method did not force the focus to change.
Implements
IInputElement.Focus()To be focusable, Focusable and IsEnabled must both be true.
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.
Focus in general is governed by two separate concepts: keyboard focus and logical focus, which are not always identical. For more information, see Focus Overview or Input Overview.
If calling Focus returns true, IsKeyboardFocused and IsKeyboardFocusWithin are also true.
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).
In order for this call to be successful, some other element in the application needed to have focus previously.
Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003
The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.