UIElement.PreviewKeyDown Event


Occurs when a key is pressed while focus is on this element.

public event System.Windows.Input.KeyEventHandler PreviewKeyDown;


Key handling interacts with other platform features such as commanding and text composition. The KeyDown event is a lower-level text input event that might not behave as expected on certain controls. This is because some controls have control compositing or class handling that provides a higher-level version of text input handling and related events.

This event creates an alias for the <xref:System.Windows.Input.Keyboard.PreviewKeyDown?displayProperty=nameWithType> attached event for this class, so that PreviewKeyDown is part of the class members list when UIElement is inherited as a base element. Event handlers that are attached to the PreviewKeyDown event are attached to the underlying <xref:System.Windows.Input.Keyboard.PreviewKeyDown?displayProperty=nameWithType> attached event and receive the same event data instance.

Routed Event Information

Identifier field PreviewKeyDownEvent
Routing strategy Tunneling
Delegate KeyEventHandler
  • The corresponding bubbling event is KeyDown.

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

Applies to

See Also