onkeypress event
[This documentation is preliminary and is subject to change.]
Fires when the user presses an alphanumeric key.
 |
Syntax
| HTML Attribute | <element onkeypress = "handler(event)"> |
|---|---|
| Event Property | object.onkeypress = handler; |
| attachEvent Method | object.attachEvent("onkeypress", handler) |
| addEventListener Method | object.addEventListener("keypress", handler, useCapture) |
Standards information
- HTML 4.01 Specification, Section 18.2.3
Event information
| Synchronous | No |
|---|---|
| Bubbles | No |
| Cancelable | No |
Event handler parameters
- pEvtObj [in]
-
Type: IHTMLEventObj
Remarks
As of Microsoft Internet Explorer 4.0, the HTMLDocumentEvents2::onkeypress event fires and can be canceled for the following keys:
- Letters: A - Z (uppercase and lowercase)
- Numerals: 0 - 9
- Symbols: ! @ # $ % ^ & * ( ) _ - + = < [ ] { } , . / ? \ | ' ` " ~
- System: ESC, SPACEBAR, ENTER
Returns a number specifying the Unicode value of the key that was pressed.
To invoke this event, do one of the following:
- Press any alphanumeric keyboard key.
The pEvtObj parameter is required for the following interfaces:
- HTMLAnchorEvents2
- HTMLAreaEvents2
- HTMLButtonElementEvents2
- HTMLControlElementEvents2
- HTMLDocumentEvents2
- HTMLElementEvents2
- HTMLFormElementEvents2
- HTMLImgEvents2
- HTMLFrameSiteEvents2
- HTMLInputFileElementEvents2
- HTMLInputImageEvents2
- HTMLInputTextElementEvents2
- HTMLLabelEvents2
- HTMLLinkElementEvents2
- HTMLMapEvents2
- HTMLMarqueeElementEvents2
- HTMLObjectElementEvents2
- HTMLOptionButtonElementEvents2
- HTMLScriptEvents2
- HTMLSelectElementEvents2
- HTMLStyleElementEvents2
- HTMLTableEvents2
- HTMLTextContainerEvents2
- HTMLWindowEvents2
- HTMLWindowEvents4
See also
- Reference
- HTMLSelectElementEvents::onchange
- HTMLDocumentEvents2::onkeydown
- HTMLDocumentEvents2::onkeyup
Build date: 3/8/2012
