android.view
public
class
android.view.KeyCharacterMap
Nested Classes
Summary
Constants
|
|
|
Value |
|
int |
ALPHA |
A keyboard with all the letters, and maybe some numbers. |
3 |
0x00000003 |
int |
BUILT_IN_KEYBOARD |
The id of the device's primary built in keyboard is always 0. |
0 |
0x00000000 |
int |
COMBINING_ACCENT |
|
-2147483648 |
0x80000000 |
int |
COMBINING_ACCENT_MASK |
Mask the return value from get(int, int) with this value to get
a printable representation of the accent character of a "dead key."
|
2147483647 |
0x7fffffff |
char |
HEX_INPUT |
This private-use character is used to trigger Unicode character
input by hex digits. |
61184 |
0x0000ef00 |
int |
NUMERIC |
A numeric (12-key) keyboard. |
1 |
0x00000001 |
char |
PICKER_DIALOG_INPUT |
This private-use character is used to bring up a character picker for
miscellaneous symbols. |
61185 |
0x0000ef01 |
int |
PREDICTIVE |
A keyboard with all the letters, but with more than one letter
per key. |
2 |
0x00000002 |
Public Methods
Protected Methods
clone,
equals,
finalize,
getClass,
hashCode,
notify,
notifyAll,
toString,
wait,
wait,
wait
Details
Constants
public
static
final
int
ALPHA
A keyboard with all the letters, and maybe some numbers.
Constant Value:
3
(0x00000003)
public
static
final
int
BUILT_IN_KEYBOARD
The id of the device's primary built in keyboard is always 0.
Constant Value:
0
(0x00000000)
public
static
final
int
COMBINING_ACCENT
Constant Value:
-2147483648
(0x80000000)
public
static
final
int
COMBINING_ACCENT_MASK
Mask the return value from
get(int, int) with this value to get
a printable representation of the accent character of a "dead key."
Constant Value:
2147483647
(0x7fffffff)
public
static
final
char
HEX_INPUT
This private-use character is used to trigger Unicode character
input by hex digits.
Constant Value:
61184
(0x0000ef00)
public
static
final
int
NUMERIC
A numeric (12-key) keyboard.
Constant Value:
1
(0x00000001)
public
static
final
char
PICKER_DIALOG_INPUT
This private-use character is used to bring up a character picker for
miscellaneous symbols.
Constant Value:
61185
(0x0000ef01)
public
static
final
int
PREDICTIVE
A keyboard with all the letters, but with more than one letter
per key.
Constant Value:
2
(0x00000002)
Public Methods
public
int
get(int keyCode, int meta)
Returns the Unicode character that the specified key would produce
when the specified meta bits (see MetaKeyKeyListener)
were active.
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.
public
static
int
getDeadChar(int accent, int c)
Get the character that is produced by putting accent on the character
c.
For example, getDeadChar('`', 'e') returns è.
public
char
getDisplayLabel(int keyCode)
Get the primary character for this key. In other words, the label
that is physically printed on it.
public
KeyEvent[]
getEvents(char[] chars)
Get an array of KeyEvent objects that if put into the input stream
could plausibly generate the provided sequence of characters. It is
not guaranteed that the sequence is the only way to generate these
events or that it is optimal.
Returns
- an array of KeyEvent objects, or null if the given char array
can not be generated using the current key character map.
public
boolean
getKeyData(int keyCode, KeyCharacterMap.KeyData results)
Get the characters conversion data for a given keyCode.
Returns
- whether the key was mapped or not. If the key was not mapped,
results is not modified.
public
int
getKeyboardType()
public
char
getMatch(int keyCode, char[] chars, int modifiers)
If one of the chars in the array can be generated by keyCode,
return the char; otherwise return '\0'.
Parameters
keyCode
| the key code to look at |
chars
| the characters to try to find |
modifiers
| the modifier bits to prefer. If any of these bits
are set, if there are multiple choices, that could
work, the one for this modifier will be set.
|
public
char
getMatch(int keyCode, char[] chars)
public
char
getNumber(int keyCode)
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.
public
boolean
isPrintingKey(int keyCode)
Does this character key produce a glyph?
Protected Methods
protected
void
finalize()
Called by the virtual machine when there are no longer any (non-weak)
references to the receiver. Subclasses can use this facility to guarantee
that any associated resources are cleaned up before the receiver is
garbage collected. Uncaught exceptions which are thrown during the
running of the method cause it to terminate immediately, but are
otherwise ignored.
Note: The virtual machine assumes that the implementation in class Object
is empty.