ListBox.OnKeyDown Method
[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
Provides handling for the KeyDown event that occurs when a key is pressed while the control has focus.
Assembly: System.Windows (in System.Windows.dll)
Parameters
- e
- Type: System.Windows.Input.KeyEventArgs
The event data.
It is not recommended that you rely on this method behavior because typically a soft-interface keyboard is not displayed for a ListBox control and not all devices have a hardware keyboard. The following table lists keys that will cause the KeyDown event to be marked as handled. It also describes how the ListBox handles the key.
Key | Action |
|---|---|
If the list item with focus is currently selected, it is deselected. If it is not selected, it is set as the selected item. | |
Sets the first list item is set as the selected item. | |
Sets the last list item is set as the selected item. | |
Sets the previous list item as the selected item. | |
Sets the next list item as the selected item. | |
If the ListBox is oriented vertically, scrolls the list to the left. If the ListBox is oriented horizontally, sets the previous item in the list as the selected item. | |
If the ListBox is oriented horizontally, scrolls the list to the list. If the ListBox is oriented vertically, sets the previous item in the list as the selected item. | |
If the ListBox is oriented vertically, scrolls the list to the right. If the ListBox is oriented horizontally, sets the next item in the list as the selected item. | |
If the ListBox is oriented horizontally, scrolls the list down. If the ListBox is oriented vertically, sets the next item in the list as the selected item. |
The OnKeyDown method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.
Notes to InheritorsWhen overriding OnKeyDown in a derived class, be sure to call the base class’s OnKeyDown method so that registered delegates receive the event.