Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
OnKeyDown Method

ButtonBase::OnKeyDown Method

Provides class handling for the KeyDown routed event that occurs when the user presses a key while this control has focus.

Namespace:  System.Windows.Controls.Primitives
Assembly:  PresentationFramework (in PresentationFramework.dll)

protected:
virtual void OnKeyDown(
	KeyEventArgs^ e
) override

Parameters

e
Type: System.Windows.Input::KeyEventArgs

The event data.

This implementation marks the KeyDown event as handled by setting the Handled property of the event data to true when ClickMode is not set to Hover and one of the following cases are true:

  • The user presses the SPACEBAR.

  • The user presses ENTER and AcceptsReturn is true for this control.

In all other cases, this implementation does not change the handled state (the Handled property) of the KeyDown event data.

Notes to Inheritors

If you override OnKeyDown, always call the base implementation in your OnKeyDown implementation. Failure to call the base implementation prevents base classes from handling the event with a class handler, which might change the run-time behavior of the final class. You can call the base implementation either before or after your special handling, depending on your requirements.

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Show:
© 2015 Microsoft