Share via

  • Article

TreeViewItem.OnKeyDown Method

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Provides handling for the KeyDown event when the TreeViewItem has focus.

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

Syntax

'Declaration
Protected Overrides Sub OnKeyDown ( _
    e As KeyEventArgs _
)

protected override void OnKeyDown(
    KeyEventArgs e
)

Parameters

Remarks

The OnKeyDown method is called before any event handler for the KeyDown is called. This method allows derived classes to handle the KeyDown event without attaching a delegate. This is the preferred technique for handling the event in a derived class.

This implementation marks the KeyDown event as handled by setting the Handled property of the event data to true in the following situations:

  • The PageUp key is pressed and the TreeViewItem scrolls by page.

  • The Home key is pressed and the control successfully puts focus on the first item.

  • The End key is pressed and the control successfully puts focus on the last item.

  • The Up or Down key is pressed when there is no selected item and the control can focus on the first or last item.

  • The Left or Right is pressed and the control expands or collapses.

  • The Add or Subtract key is pressed and the control expands or collapses.

Notes to Inheritors

If you override OnKeyDown, you can prevent registered delegates from receiving events by setting Handled to true. For more information about routed events and the Handled property, see Events Overview for Silverlight.

Version Information

Silverlight

Supported in: 5, 4, 3

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.