Keyboard.Focus Method

Sets keyboard focus on the specified element.

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

Public Shared Function Focus ( _
	element As IInputElement _
) As IInputElement
Dim element As IInputElement
Dim returnValue As IInputElement

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



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.

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

Community Additions