UIElement.PreviewKeyDown Event
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Occurs when a key is pressed while focus is on this element.
public:
virtual event System::Windows::Input::KeyEventHandler ^ PreviewKeyDown;public event System.Windows.Input.KeyEventHandler PreviewKeyDown;member this.PreviewKeyDown : System.Windows.Input.KeyEventHandler Public Custom Event PreviewKeyDown As KeyEventHandler Event Type
Implements
Remarks
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 Keyboard.PreviewKeyDown 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 Keyboard.PreviewKeyDown 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.
