/* * Copyright (C) 2007 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package android.view; import android.text.method.MetaKeyKeyListener; import android.util.AndroidRuntimeException; import android.util.SparseIntArray; import android.os.RemoteException; import android.util.SparseArray; import java.lang.Character; /** * Describes the keys provided by a keyboard device and their associated labels. */ public class KeyCharacterMap { /** * The id of the device's primary built in keyboard is always 0. * * @deprecated This constant should no longer be used because there is no * guarantee that a device has a built-in keyboard that can be used for * typing text. There might not be a built-in keyboard, the built-in keyboard * might be a {@link #NUMERIC} or {@link #SPECIAL_FUNCTION} keyboard, or there * might be multiple keyboards installed including external keyboards. * When interpreting key presses received from the framework, applications should * use the device id specified in the {@link KeyEvent} received. * When synthesizing key presses for delivery elsewhere or when translating key presses * from unknown keyboards, applications should use the special {@link #VIRTUAL_KEYBOARD} * device id. */ @Deprecated public static final int BUILT_IN_KEYBOARD = 0; /** * The id of a generic virtual keyboard with a full layout that can be used to * synthesize key events. Typically used with {@link #getEvents}. */ public static final int VIRTUAL_KEYBOARD = -1; /** * A numeric (12-key) keyboard. * <p> * A numeric keyboard supports text entry using a multi-tap approach. * It may be necessary to tap a key multiple times to generate the desired letter * or symbol. * </p><p> * This type of keyboard is generally designed for thumb typing. * </p> */ public static final int NUMERIC = 1; /** * A keyboard with all the letters, but with more than one letter per key. * <p> * This type of keyboard is generally designed for thumb typing. * </p> */ public static final int PREDICTIVE = 2; /** * A keyboard with all the letters, and maybe some numbers. * <p> * An alphabetic keyboard supports text entry directly but may have a condensed * layout with a small form factor. In contrast to a {@link #FULL full keyboard}, some * symbols may only be accessible using special on-screen character pickers. * In addition, to improve typing speed and accuracy, the framework provides * special affordances for alphabetic keyboards such as auto-capitalization * and toggled / locked shift and alt keys. * </p><p> * This type of keyboard is generally designed for thumb typing. * </p> */ public static final int ALPHA = 3; /** * A full PC-style keyboard. * <p> * A full keyboard behaves like a PC keyboard. All symbols are accessed directly * by pressing keys on the keyboard without on-screen support or affordances such * as auto-capitalization. * </p><p> * This type of keyboard is generally designed for full two hand typing. * </p> */ public static final int FULL = 4; /** * A keyboard that is only used to control special functions rather than for typing. * <p> * A special function keyboard consists only of non-printing keys such as * HOME and POWER that are not actually used for typing. * </p> */ public static final int SPECIAL_FUNCTION = 5; /** * This private-use character is used to trigger Unicode character * input by hex digits. */ public static final char HEX_INPUT = '\uEF00'; /** * This private-use character is used to bring up a character picker for * miscellaneous symbols. */ public static final char PICKER_DIALOG_INPUT = '\uEF01'; /** * Modifier keys may be chorded with character keys. * * @see {#link #getModifierBehavior()} for more details. */ public static final int MODIFIER_BEHAVIOR_CHORDED = 0; /** * Modifier keys may be chorded with character keys or they may toggle * into latched or locked states when pressed independently. * * @see {#link #getModifierBehavior()} for more details. */ public static final int MODIFIER_BEHAVIOR_CHORDED_OR_TOGGLED = 1; private static SparseArray<KeyCharacterMap> sInstances = new SparseArray<KeyCharacterMap>(); private final int mDeviceId; private int mPtr; private static native int nativeLoad(String file); private static native void nativeDispose(int ptr); private static native char nativeGetCharacter(int ptr, int keyCode, int metaState); private static native boolean nativeGetFallbackAction(int ptr, int keyCode, int metaState, FallbackAction outFallbackAction); private static native char nativeGetNumber(int ptr, int keyCode); private static native char nativeGetMatch(int ptr, int keyCode, char[] chars, int metaState); private static native char nativeGetDisplayLabel(int ptr, int keyCode); private static native int nativeGetKeyboardType(int ptr); private static native KeyEvent[] nativeGetEvents(int ptr, int deviceId, char[] chars); private KeyCharacterMap(int deviceId, int ptr) { mDeviceId = deviceId; mPtr = ptr; } @Override protected void finalize() throws Throwable { if (mPtr != 0) { nativeDispose(mPtr); mPtr = 0; } } /** * Loads the key character maps for the keyboard with the specified device id. * * @param deviceId The device id of the keyboard. * @return The associated key character map. * @throws {@link UnavailableException} if the key character map * could not be loaded because it was malformed or the default key character map * is missing from the system. */ public static KeyCharacterMap load(int deviceId) { synchronized (sInstances) { KeyCharacterMap map = sInstances.get(deviceId); if (map == null) { String kcm = null; if (deviceId != VIRTUAL_KEYBOARD) { InputDevice device = InputDevice.getDevice(deviceId); if (device != null) { kcm = device.getKeyCharacterMapFile(); } } if (kcm == null || kcm.length() == 0) { kcm = "/system/usr/keychars/Virtual.kcm"; } int ptr = nativeLoad(kcm); // might throw map = new KeyCharacterMap(deviceId, ptr); sInstances.put(deviceId, map); } return map; } } /** * Gets the Unicode character generated by the specified key and meta * key state combination. * <p> * Returns the Unicode character that the specified key would produce * when the specified meta bits (see {@link MetaKeyKeyListener}) * were active. * </p><p> * Returns 0 if the key is not one that is used to type Unicode * characters. * </p><p> * If the return value has bit {@link #COMBINING_ACCENT} set, the * key is a "dead key" that should be combined with another to * actually produce a character -- see {@link #getDeadChar} -- * after masking with {@link #COMBINING_ACCENT_MASK}. * </p> * * @param keyCode The key code. * @param metaState The meta key modifier state. * @return The associated character or combining accent, or 0 if none. */ public int get(int keyCode, int metaState) { metaState = KeyEvent.normalizeMetaState(metaState); char ch = nativeGetCharacter(mPtr, keyCode, metaState); int map = COMBINING.get(ch); if (map != 0) { return map; } else { return ch; } } /** * Gets the fallback action to perform if the application does not * handle the specified key. * <p> * When an application does not handle a particular key, the system may * translate the key to an alternate fallback key (specified in the * fallback action) and dispatch it to the application. * The event containing the fallback key is flagged * with {@link KeyEvent#FLAG_FALLBACK}. * </p> * * @param keyCode The key code. * @param metaState The meta key modifier state. * @param outFallbackAction The fallback action object to populate. * @return True if a fallback action was found, false otherwise. * * @hide */ public boolean getFallbackAction(int keyCode, int metaState, FallbackAction outFallbackAction) { if (outFallbackAction == null) { throw new IllegalArgumentException("fallbackAction must not be null"); } metaState = KeyEvent.normalizeMetaState(metaState); return nativeGetFallbackAction(mPtr, keyCode, metaState, outFallbackAction); } /** * Gets the number or symbol associated with the key. * <p> * The character value is returned, not the numeric value. * If the key is not a number, but is a symbol, the symbol is retuned. * </p><p> * This method is intended to to support dial pads and other numeric or * symbolic entry on keyboards where certain keys serve dual function * as alphabetic and symbolic keys. This method returns the number * or symbol associated with the key independent of whether the user * has pressed the required modifier. * </p><p> * For example, on one particular keyboard the keys on the top QWERTY row generate * numbers when ALT is pressed such that ALT-Q maps to '1'. So for that keyboard * when {@link #getNumber} is called with {@link KeyEvent#KEYCODE_Q} it returns '1' * so that the user can type numbers without pressing ALT when it makes sense. * </p> * * @param keyCode The key code. * @return The associated numeric or symbolic character, or 0 if none. */ public char getNumber(int keyCode) { return nativeGetNumber(mPtr, keyCode); } /** * Gets the first character in the character array that can be generated * by the specified key code. * <p> * This is a convenience function that returns the same value as * {@link #getMatch(int,char[],int) getMatch(keyCode, chars, 0)}. * </p> * * @param keyCode The keycode. * @param chars The array of matching characters to consider. * @return The matching associated character, or 0 if none. */ public char getMatch(int keyCode, char[] chars) { return getMatch(keyCode, chars, 0); } /** * Gets the first character in the character array that can be generated * by the specified key code. If there are multiple choices, prefers * the one that would be generated with the specified meta key modifier state. * * @param keyCode The key code. * @param chars The array of matching characters to consider. * @param metaState The preferred meta key modifier state. * @return The matching associated character, or 0 if none. */ public char getMatch(int keyCode, char[] chars, int metaState) { if (chars == null) { throw new IllegalArgumentException("chars must not be null."); } metaState = KeyEvent.normalizeMetaState(metaState); return nativeGetMatch(mPtr, keyCode, chars, metaState); } /** * Gets the primary character for this key. * In other words, the label that is physically printed on it. * * @param keyCode The key code. * @return The display label character, or 0 if none (eg. for non-printing keys). */ public char getDisplayLabel(int keyCode) { return nativeGetDisplayLabel(mPtr, keyCode); } /** * Get the character that is produced by putting accent on the character c. * For example, getDeadChar('`', 'e') returns è. * * @param accent The accent character. eg. '`' * @param c The basic character. * @return The combined character, or 0 if the characters cannot be combined. */ public static int getDeadChar(int accent, int c) { return DEAD.get((accent << 16) | c); } /** * Describes the character mappings associated with a key. * * @deprecated instead use {@link KeyCharacterMap#getDisplayLabel(int)}, * {@link KeyCharacterMap#getNumber(int)} and {@link KeyCharacterMap#get(int, int)}. */ @Deprecated public static class KeyData { public static final int META_LENGTH = 4; /** * The display label (see {@link #getDisplayLabel}). */ public char displayLabel; /** * The "number" value (see {@link #getNumber}). */ public char number; /** * The character that will be generated in various meta states * (the same ones used for {@link #get} and defined as * {@link KeyEvent#META_SHIFT_ON} and {@link KeyEvent#META_ALT_ON}). * <table> * <tr><th>Index</th><th align="left">Value</th></tr> * <tr><td>0</td><td>no modifiers</td></tr> * <tr><td>1</td><td>caps</td></tr> * <tr><td>2</td><td>alt</td></tr> * <tr><td>3</td><td>caps + alt</td></tr> * </table> */ public char[] meta = new char[META_LENGTH]; } /** * Get the character conversion data for a given key code. * * @param keyCode The keyCode to query. * @param results A {@link KeyData} instance that will be filled with the results. * @return True if the key was mapped. If the key was not mapped, results is not modified. * * @deprecated instead use {@link KeyCharacterMap#getDisplayLabel(int)}, * {@link KeyCharacterMap#getNumber(int)} or {@link KeyCharacterMap#get(int, int)}. */ @Deprecated public boolean getKeyData(int keyCode, KeyData results) { if (results.meta.length < KeyData.META_LENGTH) { throw new IndexOutOfBoundsException( "results.meta.length must be >= " + KeyData.META_LENGTH); } char displayLabel = nativeGetDisplayLabel(mPtr, keyCode); if (displayLabel == 0) { return false; } results.displayLabel = displayLabel; results.number = nativeGetNumber(mPtr, keyCode); results.meta[0] = nativeGetCharacter(mPtr, keyCode, 0); results.meta[1] = nativeGetCharacter(mPtr, keyCode, KeyEvent.META_SHIFT_ON); results.meta[2] = nativeGetCharacter(mPtr, keyCode, KeyEvent.META_ALT_ON); results.meta[3] = nativeGetCharacter(mPtr, keyCode, KeyEvent.META_ALT_ON | KeyEvent.META_SHIFT_ON); return true; } /** * 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. * <p> * This function is primarily offered for instrumentation and testing purposes. * It may fail to map characters to key codes. In particular, the key character * map for the {@link #BUILT_IN_KEYBOARD built-in keyboard} device id may be empty. * Consider using the key character map associated with the * {@link #VIRTUAL_KEYBOARD virtual keyboard} device id instead. * </p><p> * For robust text entry, do not use this function. Instead construct a * {@link KeyEvent} with action code {@link KeyEvent#ACTION_MULTIPLE} that contains * the desired string using {@link KeyEvent#KeyEvent(long, String, int, int)}. * </p> * * @param chars The sequence of characters to generate. * @return An array of {@link KeyEvent} objects, or null if the given char array * can not be generated using the current key character map. */ public KeyEvent[] getEvents(char[] chars) { if (chars == null) { throw new IllegalArgumentException("chars must not be null."); } return nativeGetEvents(mPtr, mDeviceId, chars); } /** * Returns true if the specified key produces a glyph. * * @param keyCode The key code. * @return True if the key is a printing key. */ public boolean isPrintingKey(int keyCode) { int type = Character.getType(nativeGetDisplayLabel(mPtr, keyCode)); switch (type) { case Character.SPACE_SEPARATOR: case Character.LINE_SEPARATOR: case Character.PARAGRAPH_SEPARATOR: case Character.CONTROL: case Character.FORMAT: return false; default: return true; } } /** * Gets the keyboard type. * Returns {@link #NUMERIC}, {@link #PREDICTIVE}, {@link #ALPHA} or {@link #FULL}. * <p> * Different keyboard types have different semantics. Refer to the documentation * associated with the keyboard type constants for details. * </p> * * @return The keyboard type. */ public int getKeyboardType() { return nativeGetKeyboardType(mPtr); } /** * Gets a constant that describes the behavior of this keyboard's modifier keys * such as {@link KeyEvent#KEYCODE_SHIFT_LEFT}. * <p> * Currently there are two behaviors that may be combined: * </p> * <ul> * <li>Chorded behavior: When the modifier key is pressed together with one or more * character keys, the keyboard inserts the modified keys and * then resets the modifier state when the modifier key is released.</li> * <li>Toggled behavior: When the modifier key is pressed and released on its own * it first toggles into a latched state. When latched, the modifier will apply * to next character key that is pressed and will then reset itself to the initial state. * If the modifier is already latched and the modifier key is pressed and release on * its own again, then it toggles into a locked state. When locked, the modifier will * apply to all subsequent character keys that are pressed until unlocked by pressing * the modifier key on its own one more time to reset it to the initial state. * Toggled behavior is useful for small profile keyboards designed for thumb typing. * </ul> * <p> * This function currently returns {@link #MODIFIER_BEHAVIOR_CHORDED} when the * {@link #getKeyboardType() keyboard type} is {@link #FULL} or {@link #SPECIAL_FUNCTION} and * {@link #MODIFIER_BEHAVIOR_CHORDED_OR_TOGGLED} otherwise. * In the future, the function may also take into account global keyboard * accessibility settings, other user preferences, or new device capabilities. * </p> * * @return The modifier behavior for this keyboard. * * @see {@link #MODIFIER_BEHAVIOR_CHORDED} * @see {@link #MODIFIER_BEHAVIOR_CHORDED_OR_TOGGLED} */ public int getModifierBehavior() { switch (getKeyboardType()) { case FULL: case SPECIAL_FUNCTION: return MODIFIER_BEHAVIOR_CHORDED; default: return MODIFIER_BEHAVIOR_CHORDED_OR_TOGGLED; } } /** * Queries the framework about whether any physical keys exist on the * any keyboard attached to the device that are capable of producing the given key code. * * @param keyCode The key code to query. * @return True if at least one attached keyboard supports the specified key code. */ public static boolean deviceHasKey(int keyCode) { int[] codeArray = new int[1]; codeArray[0] = keyCode; boolean[] ret = deviceHasKeys(codeArray); return ret[0]; } /** * Queries the framework about whether any physical keys exist on the * any keyboard attached to the device that are capable of producing the given * array of key codes. * * @param keyCodes The array of key codes to query. * @return A new array of the same size as the key codes array whose elements * are set to true if at least one attached keyboard supports the corresponding key code * at the same index in the key codes array. */ public static boolean[] deviceHasKeys(int[] keyCodes) { boolean[] ret = new boolean[keyCodes.length]; IWindowManager wm = Display.getWindowManager(); try { wm.hasKeys(keyCodes, ret); } catch (RemoteException e) { // no fallback; just return the empty array } return ret; } /** * Maps Unicode combining diacritical to display-form dead key * (display character shifted left 16 bits). */ private static SparseIntArray COMBINING = new SparseIntArray(); /** * Maps combinations of (display-form) dead key and second character * to combined output character. */ private static SparseIntArray DEAD = new SparseIntArray(); /* * TODO: Change the table format to support full 21-bit-wide * accent characters and combined characters if ever necessary. */ private static final int ACUTE = '\u00B4' << 16; private static final int GRAVE = '`' << 16; private static final int CIRCUMFLEX = '^' << 16; private static final int TILDE = '~' << 16; private static final int UMLAUT = '\u00A8' << 16; /* * This bit will be set in the return value of {@link #get(int, int)} if the * key is a "dead key." */ public static final int COMBINING_ACCENT = 0x80000000; /** * Mask the return value from {@link #get(int, int)} with this value to get * a printable representation of the accent character of a "dead key." */ public static final int COMBINING_ACCENT_MASK = 0x7FFFFFFF; static { COMBINING.put('\u0300', (GRAVE >> 16) | COMBINING_ACCENT); COMBINING.put('\u0301', (ACUTE >> 16) | COMBINING_ACCENT); COMBINING.put('\u0302', (CIRCUMFLEX >> 16) | COMBINING_ACCENT); COMBINING.put('\u0303', (TILDE >> 16) | COMBINING_ACCENT); COMBINING.put('\u0308', (UMLAUT >> 16) | COMBINING_ACCENT); DEAD.put(ACUTE | 'A', '\u00C1'); DEAD.put(ACUTE | 'C', '\u0106'); DEAD.put(ACUTE | 'E', '\u00C9'); DEAD.put(ACUTE | 'G', '\u01F4'); DEAD.put(ACUTE | 'I', '\u00CD'); DEAD.put(ACUTE | 'K', '\u1E30'); DEAD.put(ACUTE | 'L', '\u0139'); DEAD.put(ACUTE | 'M', '\u1E3E'); DEAD.put(ACUTE | 'N', '\u0143'); DEAD.put(ACUTE | 'O', '\u00D3'); DEAD.put(ACUTE | 'P', '\u1E54'); DEAD.put(ACUTE | 'R', '\u0154'); DEAD.put(ACUTE | 'S', '\u015A'); DEAD.put(ACUTE | 'U', '\u00DA'); DEAD.put(ACUTE | 'W', '\u1E82'); DEAD.put(ACUTE | 'Y', '\u00DD'); DEAD.put(ACUTE | 'Z', '\u0179'); DEAD.put(ACUTE | 'a', '\u00E1'); DEAD.put(ACUTE | 'c', '\u0107'); DEAD.put(ACUTE | 'e', '\u00E9'); DEAD.put(ACUTE | 'g', '\u01F5'); DEAD.put(ACUTE | 'i', '\u00ED'); DEAD.put(ACUTE | 'k', '\u1E31'); DEAD.put(ACUTE | 'l', '\u013A'); DEAD.put(ACUTE | 'm', '\u1E3F'); DEAD.put(ACUTE | 'n', '\u0144'); DEAD.put(ACUTE | 'o', '\u00F3'); DEAD.put(ACUTE | 'p', '\u1E55'); DEAD.put(ACUTE | 'r', '\u0155'); DEAD.put(ACUTE | 's', '\u015B'); DEAD.put(ACUTE | 'u', '\u00FA'); DEAD.put(ACUTE | 'w', '\u1E83'); DEAD.put(ACUTE | 'y', '\u00FD'); DEAD.put(ACUTE | 'z', '\u017A'); DEAD.put(CIRCUMFLEX | 'A', '\u00C2'); DEAD.put(CIRCUMFLEX | 'C', '\u0108'); DEAD.put(CIRCUMFLEX | 'E', '\u00CA'); DEAD.put(CIRCUMFLEX | 'G', '\u011C'); DEAD.put(CIRCUMFLEX | 'H', '\u0124'); DEAD.put(CIRCUMFLEX | 'I', '\u00CE'); DEAD.put(CIRCUMFLEX | 'J', '\u0134'); DEAD.put(CIRCUMFLEX | 'O', '\u00D4'); DEAD.put(CIRCUMFLEX | 'S', '\u015C'); DEAD.put(CIRCUMFLEX | 'U', '\u00DB'); DEAD.put(CIRCUMFLEX | 'W', '\u0174'); DEAD.put(CIRCUMFLEX | 'Y', '\u0176'); DEAD.put(CIRCUMFLEX | 'Z', '\u1E90'); DEAD.put(CIRCUMFLEX | 'a', '\u00E2'); DEAD.put(CIRCUMFLEX | 'c', '\u0109'); DEAD.put(CIRCUMFLEX | 'e', '\u00EA'); DEAD.put(CIRCUMFLEX | 'g', '\u011D'); DEAD.put(CIRCUMFLEX | 'h', '\u0125'); DEAD.put(CIRCUMFLEX | 'i', '\u00EE'); DEAD.put(CIRCUMFLEX | 'j', '\u0135'); DEAD.put(CIRCUMFLEX | 'o', '\u00F4'); DEAD.put(CIRCUMFLEX | 's', '\u015D'); DEAD.put(CIRCUMFLEX | 'u', '\u00FB'); DEAD.put(CIRCUMFLEX | 'w', '\u0175'); DEAD.put(CIRCUMFLEX | 'y', '\u0177'); DEAD.put(CIRCUMFLEX | 'z', '\u1E91'); DEAD.put(GRAVE | 'A', '\u00C0'); DEAD.put(GRAVE | 'E', '\u00C8'); DEAD.put(GRAVE | 'I', '\u00CC'); DEAD.put(GRAVE | 'N', '\u01F8'); DEAD.put(GRAVE | 'O', '\u00D2'); DEAD.put(GRAVE | 'U', '\u00D9'); DEAD.put(GRAVE | 'W', '\u1E80'); DEAD.put(GRAVE | 'Y', '\u1EF2'); DEAD.put(GRAVE | 'a', '\u00E0'); DEAD.put(GRAVE | 'e', '\u00E8'); DEAD.put(GRAVE | 'i', '\u00EC'); DEAD.put(GRAVE | 'n', '\u01F9'); DEAD.put(GRAVE | 'o', '\u00F2'); DEAD.put(GRAVE | 'u', '\u00F9'); DEAD.put(GRAVE | 'w', '\u1E81'); DEAD.put(GRAVE | 'y', '\u1EF3'); DEAD.put(TILDE | 'A', '\u00C3'); DEAD.put(TILDE | 'E', '\u1EBC'); DEAD.put(TILDE | 'I', '\u0128'); DEAD.put(TILDE | 'N', '\u00D1'); DEAD.put(TILDE | 'O', '\u00D5'); DEAD.put(TILDE | 'U', '\u0168'); DEAD.put(TILDE | 'V', '\u1E7C'); DEAD.put(TILDE | 'Y', '\u1EF8'); DEAD.put(TILDE | 'a', '\u00E3'); DEAD.put(TILDE | 'e', '\u1EBD'); DEAD.put(TILDE | 'i', '\u0129'); DEAD.put(TILDE | 'n', '\u00F1'); DEAD.put(TILDE | 'o', '\u00F5'); DEAD.put(TILDE | 'u', '\u0169'); DEAD.put(TILDE | 'v', '\u1E7D'); DEAD.put(TILDE | 'y', '\u1EF9'); DEAD.put(UMLAUT | 'A', '\u00C4'); DEAD.put(UMLAUT | 'E', '\u00CB'); DEAD.put(UMLAUT | 'H', '\u1E26'); DEAD.put(UMLAUT | 'I', '\u00CF'); DEAD.put(UMLAUT | 'O', '\u00D6'); DEAD.put(UMLAUT | 'U', '\u00DC'); DEAD.put(UMLAUT | 'W', '\u1E84'); DEAD.put(UMLAUT | 'X', '\u1E8C'); DEAD.put(UMLAUT | 'Y', '\u0178'); DEAD.put(UMLAUT | 'a', '\u00E4'); DEAD.put(UMLAUT | 'e', '\u00EB'); DEAD.put(UMLAUT | 'h', '\u1E27'); DEAD.put(UMLAUT | 'i', '\u00EF'); DEAD.put(UMLAUT | 'o', '\u00F6'); DEAD.put(UMLAUT | 't', '\u1E97'); DEAD.put(UMLAUT | 'u', '\u00FC'); DEAD.put(UMLAUT | 'w', '\u1E85'); DEAD.put(UMLAUT | 'x', '\u1E8D'); DEAD.put(UMLAUT | 'y', '\u00FF'); } /** * Thrown by {@link KeyCharacterMap#load} when a key character map could not be loaded. */ public static class UnavailableException extends AndroidRuntimeException { public UnavailableException(String msg) { super(msg); } } /** * Specifies a substitute key code and meta state as a fallback action * for an unhandled key. * @hide */ public static final class FallbackAction { public int keyCode; public int metaState; } }