ASPxClientGridBase.KeyDown Event

Occurs when a user presses a key while the control has focus.

Declaration

KeyDown: ASPxClientEvent<ASPxClientGridKeyboardEventHandler<ASPxClientGridBase>>

Event Data

The KeyDown event's data class is ASPxClientGridKeyboardEventArgs. The following properties provide information specific to this event:

Property	Description
handled	Specifies whether to suppress the keyboard key’s default action. Inherited from ASPxClientGridKeyboardEventArgsBase.
htmlEvent	Gets a DHTML event object that relates to the processed event. Inherited from ASPxClientGridKeyboardEventArgsBase.
isAltPressed	Specifies whether a user presses the Alt key when the event occurs. Inherited from ASPxClientGridKeyboardEventArgsBase.
isCtrlPressed	Specifies whether a user presses the Ctrl key when the event occurs. Inherited from ASPxClientGridKeyboardEventArgsBase.
isShiftPressed	Specifies whether a user presses the Shift key when the event occurs. Inherited from ASPxClientGridKeyboardEventArgsBase.
keyCode	Gets a key code. Inherited from ASPxClientGridKeyboardEventArgsBase.

Remarks

Handle the KeyDown event to process press actions for specific keys. To get information on the pressed key (for instance, its key or code value), use the e.htmlEvent property. You can also use the e.keyCode event property to get the key code as an integer value.

In the example below, ASPxGridView expands all group rows when a user presses the custom Ctrl+Space shortcut (the Space key’s integer code is 32).

JS

var spaceKeyCode = 32;

function onKeyDown(s, e) {
    if (e.isCtrlPressed && e.keyCode == spaceKeyCode) {
        s.ExpandAll()   
    }
}

ASPX

<dx:ASPxGridView ID="grid" runat="server" ...>
    <Settings ShowGroupPanel="true" />
    <ClientSideEvents KeyDown="onKeyDown" />
    <Columns>
        <dx:GridViewDataColumn FieldName="ShipName" />
        <!--...-->
    </Columns>
</dx:ASPxGridView>