KeyEvent

getAction() value: the key has been pressed down.

getAction() value: multiple duplicate key events have occurred in a row, or a complex string is being delivered. If the key code is not {#link KEYCODE_UNKNOWN then the {#link getRepeatCount() method returns the number of times the given key code should be executed. Otherwise, if the key code KEYCODE_UNKNOWN, then this is a sequence of characters as returned by getCharacters().

getAction() value: the key has been released.

This mask is used for compatibility, to identify enter keys that are coming from an IME whose enter key has been auto-labelled "next" or "done". This allows TextView to dispatch these as normal enter keys for old applications, but still do the appropriate action when receiving them.

This mask is set if an event was known to come from a trusted part of the system. That is, the event is known to come from the user, and could not have been spoofed by a third party component.

This mask is set if we don't want the key event to cause us to leave touch mode.

This mask is set if the key event was generated by a software keyboard.

This mask is set if the device woke because of this key event.

This mask is used to check whether the left ALT meta key is pressed.

This mask is used to check whether one of the ALT meta keys is pressed.

This mask is used to check whether the right the ALT meta key is pressed.

This mask is used to check whether the left SHIFT meta key is pressed.

This mask is used to check whether one of the SHIFT meta keys is pressed.

This mask is used to check whether the right SHIFT meta key is pressed.

This mask is used to check whether the SYM meta key is pressed.

Create a new key event.

Create a new key event.

Create a new key event.

Create a new key event.

Create a new key event.

Create a new key event for a string of characters. The key code, action, and repeat could will automatically be set to KEYCODE_UNKNOWN, ACTION_MULTIPLE, and 0 for you.

Make an exact copy of an existing key event.

Copy an existing key event, modifying its time and repeat count.

Create a new key event that is the same as the given one, but whose action is replaced with the given value.

Create a new key event that is the same as the given one, but whose flags are replaced with the given value.

Create a new key event that is the same as the given one, but whose event time and repeat count are replaced with the given value.

Describe the kinds of special objects contained in this Parcelable's marshalled representation.

Deliver this key event to a KeyEvent.Callback interface. If this is an ACTION_MULTIPLE event and it is not handled, then an attempt will be made to deliver a single normal event.

Retrieve the action of this key event. May be either ACTION_DOWN, ACTION_UP, or ACTION_MULTIPLE.

For the special case of a ACTION_MULTIPLE event with key code of KEYCODE_UNKNOWN, this is a raw string of characters associated with the event. In all other cases it is null.

Get the character that is produced by putting accent on the character c. For example, getDeadChar('`', 'e') returns è.

Return the id for the keyboard that this event came from. A device id of 0 indicates the event didn't come from a physical device and maps to the default keymap. The other numbers are arbitrary and you shouldn't depend on the values.

Get the primary character for this key. In other words, the label that is physically printed on it.

Retrieve the time of the most recent key down event, in the uptimeMillis() time base. If this is a down event, this will be the same as getEventTime(). Note that when chording keys, this value is the down time of the most recently pressed key, which may not be the same physical key of this event.

Retrieve the time this event occurred, in the uptimeMillis() time base.

Returns the flags for this key event.

Retrieve the key code of the key event. This is the physical key that was pressed, not the Unicode character.

Get the characters conversion data for the key event..

If one of the chars in the array can be generated by the keyCode of this key event, return the char; otherwise return '\0'.

The same as getMatch(chars, 0).

Returns the maximum keycode.

Returns the state of the meta keys.

Gets the number or symbol associated with the key. The character value is returned, not the numeric value. If the key is not a number, but is a symbol, the symbol is retuned.

Retrieve the repeat count of the event. For both key up and key down events, this is the number of times the key has repeated with the first down starting at 0 and counting up from there. For multiple key events, this is the number of down/up pairs that have occurred.

Retrieve the hardware key id of this key event. These values are not reliable and vary from device to device.

Mostly this is here for debugging purposes.

Returns the Unicode character that the key would produce.

Returns 0 if the key is not one that is used to type Unicode characters.

If the return value has bit COMBINING_ACCENT set, the key is a "dead key" that should be combined with another to actually produce a character -- see getDeadChar(int, int) -- after masking with COMBINING_ACCENT_MASK.

Returns the Unicode character that the key would produce.

Returns 0 if the key is not one that is used to type Unicode characters.

If the return value has bit COMBINING_ACCENT set, the key is a "dead key" that should be combined with another to actually produce a character -- see getDeadChar(int, int) -- after masking with COMBINING_ACCENT_MASK.

Returns the pressed state of the ALT meta key.

Returns true if this key code is a modifier key.

Does the key code of this key produce a glyph?

Returns the pressed state of the SHIFT meta key.

Returns the pressed state of the SYM meta key.

Is this a system key? System keys can not be used for menu shortcuts. TODO: this information should come from a table somewhere. TODO: should the dpad keys be here? arguably, because they also shouldn't be menu shortcuts

Returns a string containing a concise, human-readable description of this object. Subclasses are encouraged to override this method and provide an implementation that takes into account the object's type and data. The default implementation simply concatenates the class name, the '@' sign and a hexadecimal representation of the object's hashCode(), that is, it is equivalent to the following expression:

 getClass().getName() + '@' + Integer.toHexString(hashCode())
 

Flatten this object in to a Parcel.