KeyboardEvent Class

KeyboardEvent class

The KeyboardEvent interface provides specific contextual information associated with keyboard devices. Each keyboard event references a key using a value. Keyboard events are commonly directed at the element that has the focus.

public class KeyboardEvent : UIEvent

Constructors

NameDescription
KeyboardEvent(string)Initializes a new instance of the KeyboardEvent class.
KeyboardEvent(string, IDictionary<string, object>)

Properties

NameDescription
AltKey { get; }true if the Alt (alternative) (or “Option”) key modifier was active. The un-initialized value of this attribute MUST be false.
Bubbles { get; }Used to indicate whether or not an event is a bubbling event. If the event can bubble the value is true, else the value is false.
Cancelable { get; }Used to indicate whether or not an event can have its default action prevented. If the default action can be prevented the value is true, else the value is false.
Code { get; }The code holds a string that identifies the physical key being pressed. The value is not affected by the current keyboard layout or modifier state, so a particular key will always return the same value.
CtrlKey { get; }true if the Control (control) key modifier was active. The un-initialized value of this attribute MUST be false.
CurrentTarget { get; }Used to indicate the IEventTarget whose IEventListeners are currently being processed. This is particularly useful during capturing and bubbling.
DefaultPrevented { get; }Returns true if preventDefault() was invoked while the cancelable attribute value is true, and false otherwise.
Detail { get; }Specifies some detail information about the Event, depending on the type of event.
EventPhase { get; }Used to indicate which phase of event flow is currently being evaluated.
IsComposing { get; }true if the key event occurs as part of a composition session, i.e., after a compositionstart event and before the corresponding compositionend event. The un-initialized value of this attribute MUST be false.
IsTrusted { get; }The isTrusted attribute must return the value it was initialized to. When an event is created the attribute must be initialized to false.
Key { get; }The key holds the key value of the key pressed. If the value is has a printed representation, it MUST be a non-empty Unicode character string, conforming to the algorithm for determining the key value defined in this specification. If the value is a control key which has no printed representation, it MUST be one of the key values defined in the key values set, as determined by the algorithm for determining the key value. Implementations that are unable to identify a key MUST use the key value Unidentified.
Location { get; }The location attribute contains an indication of the logical location of the key on the device.
MetaKey { get; }true if the meta (Meta) key modifier was active.
Repeat { get; }true if the key has been pressed in a sustained manner. Holding down a key MUST result in the repeating the events keydown, beforeinput, input in this order, at a rate determined by the system configuration. For mobile devices which have long-key-press behavior, the first key event with a repeat attribute value of true MUST serve as an indication of a long-key-press. The length of time that the key MUST be pressed in order to begin repeating is configuration-dependent.
ShiftKey { get; }true if the shift (Shift) key modifier was active.
Target { get; }Used to indicate the IEventTarget to which the event was originally dispatched.
TimeStamp { get; }Used to specify the time (in milliseconds relative to the epoch) at which the event was created. Due to the fact that some systems may not provide this information the value of timeStamp may be not available for all events. When not available, a value of 0 will be returned. Examples of epoch time are the time of the system start or 0:0:0 UTC 1st January 1970.
Type { get; }The name of the event (case-insensitive). The name must be an XML name.
View { get; }The view attribute identifies the Window from which the event was generated. The un-initialized value of this attribute MUST be null.

Methods

NameDescription
virtual GetPlatformType()This method is used to retrieve the ECMAScript object .
InitEvent(string, bool, bool)The InitEvent method is used to initialize the value of an Event created through theIDocumentEvent interface.
PreventDefault()If an event is cancelable, the PreventDefault method is used to signify that the event is to be canceled, meaning any default action normally taken by the implementation as a result of the event will not occur.
StopImmediatePropagation()Invoking this method prevents event from reaching any event listeners registered after the current one and when dispatched in a tree also prevents event from reaching any other objects.
StopPropagation()The StopPropagation method is used prevent further propagation of an event during event flow.

Fields

NameDescription
const DOM_KEY_LOCATION_LEFTThe key activated originated from the left key location (when there is more than one possible location for this key).
const DOM_KEY_LOCATION_NUMPADThe key activation originated on the numeric keypad or with a virtual key corresponding to the numeric keypad (when there is more than one possible location for this key). Note that the NumLock key should always be encoded with a location of DOM_KEY_LOCATION_STANDARD.
const DOM_KEY_LOCATION_RIGHTThe key activation originated from the right key location (when there is more than one possible location for this key).
const DOM_KEY_LOCATION_STANDARDThe key activation MUST NOT be distinguished as the left or right version of the key, and (other than the NumLock key) did not originate from the numeric keypad (or did not originate with a virtual key corresponding to the numeric keypad).

See Also