UIElement.LostKeyboardFocus Event

public event KeyboardFocusChangedEventHandler LostKeyboardFocus

<object LostKeyboardFocus="KeyboardFocusChangedEventHandler" .../>

Implements

• The corresponding tunneling event is PreviewLostKeyboardFocus.

• Override OnLostKeyboardFocus to implement class handling for this event in derived classes.

Because this event uses bubbling routing, the element that lost focus might be a child element instead of the element where the event handler is actually attached. Check the Source in the event data to determine the actual element that lost focus.

This event creates an alias for the Keyboard.LostKeyboardFocus attached event for this class, so that LostKeyboardFocus is part of the class members list when UIElement is inherited as a base element. Event handlers that are attached to the LostKeyboardFocus event are attached to the underlying Keyboard.LostKeyboardFocus attached event and receive the same event data instance.

This example shows how to change the color of an element when it gains and loses focus by using the GotFocus and LostFocus events.

This example consists of a Extensible Application Markup Language (XAML) file and a code-behind file.

The following XAML creates the user interface, which consists of two Button objects, and attaches event handlers for the GotFocus and LostFocus events to the Button objects.

<StackPanel>
  <StackPanel.Resources>
    <Style TargetType="{x:Type Button}">
      <Setter Property="Height" Value="20"/>
      <Setter Property="Width" Value="250"/>
      <Setter Property="HorizontalAlignment" Value="Left"/>
    </Style>
  </StackPanel.Resources>
  <Button
      GotFocus="OnGotFocusHandler"
      LostFocus="OnLostFocusHandler">Click Or Tab To Give Keyboard Focus</Button>
  <Button
      GotFocus="OnGotFocusHandler"
      LostFocus="OnLostFocusHandler">Click Or Tab To Give Keyborad Focus</Button>
</StackPanel>

The following code behind creates the GotFocus and LostFocus event handlers. When the Button gains keyboard focus, the Background of the Button is changed to red. When the Button loses keyboard focus, the Background of the Button is changed back to white.

public partial class Window1 : Window
{
    public Window1()
    {
        InitializeComponent();
    }

    // Raised when Button gains focus. 
    // Changes the color of the Button to Red. 
    private void OnGotFocusHandler(object sender, RoutedEventArgs e)
    {
        Button tb = e.Source as Button;
        tb.Background = Brushes.Red;
    }
    // Raised when Button losses focus.  
    // Changes the color of the Button back to white. 
    private void OnLostFocusHandler(object sender, RoutedEventArgs e)
    {
        Button tb = e.Source as Button;
        tb.Background = Brushes.White;
    }
}

.NET Framework

.NET Framework Client Profile

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Reference

Other Resources