Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

Keyboard.Focus Method

Sets keyboard focus on the specified element.

Namespace: System.Windows.Input
Assembly: PresentationCore (in presentationcore.dll)

public:
static IInputElement^ Focus (
	IInputElement^ element
)
public static IInputElement Focus (
	IInputElement element
)
public static function Focus (
	element : IInputElement
) : IInputElement
You cannot use methods in XAML.

Parameters

element

The element on which to set keyboard focus.

Return Value

The element with keyboard focus.

For an element to receive keyboard input, the element must be focusable. To make an element focusable set the Focusable property on the base element to true. For more information on the base elements, see the Base Elements Overview. Panel classes, such as StackPanel and Canvas, set the default value of Focusable is false; therefore, for these objects to obtain keyboard focus Focusable must be set to true.

Keyboard focus refers to the object that is receiving keyboard input. The element with keyboard focus will have IsKeyboardFocused set to true. There can be only one element with keyboard focus on the entire desktop. Logical focus refers to the object within a focus scope that has focus. For more information on focus, keyboard focus, and logical focus, see the Input Overview and the Focus Overview.

An element with keyboard focus will also have logical focus for the focus scope the element belongs to. An element with logical focus may or may not have keyboard focus.

The following example shows a Loaded event handler that sets keyboard focus on a Button.

private void OnLoaded(object sender, RoutedEventArgs e)
{
    // Sets keyboard focus on the first Button in the sample.
    Keyboard.Focus(firstButton);
}

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

Show:
© 2014 Microsoft