MetaKeyKeyListener.java revision 52715a7c10eeb798692ffdb4bc8c4305cb0aa705
19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2006 The Android Open Source Project 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you may not use this file except in compliance with the License. 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You may obtain a copy of the License at 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License. 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpackage android.text.method; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brownimport android.text.Editable; 20497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brownimport android.text.NoCopySpan; 21497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brownimport android.text.Spannable; 22497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brownimport android.text.Spanned; 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.view.KeyEvent; 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.view.View; 256b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brownimport android.view.KeyCharacterMap; 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 286b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown * This base class encapsulates the behavior for tracking the state of 296b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown * meta keys such as SHIFT, ALT and SYM as well as the pseudo-meta state of selecting text. 306b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown * <p> 316b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown * Key listeners that care about meta state should inherit from this class; 326b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown * you should not instantiate this class directly in a client. 336b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown * </p><p> 346b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown * This class provides two mechanisms for tracking meta state that can be used 356b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown * together or independently. 366b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown * </p> 376b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown * <ul> 386b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown * <li>Methods such as {@link #handleKeyDown(long, int, KeyEvent)} and 396b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown * {@link #getMetaState(long)} operate on a meta key state bit mask.</li> 406b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown * <li>Methods such as {@link #onKeyDown(View, Editable, int, KeyEvent)} and 416b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown * {@link #getMetaState(CharSequence, int)} operate on meta key state flags stored 426b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown * as spans in an {@link Editable} text buffer. The spans only describe the current 436b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown * meta key state of the text editor; they do not carry any positional information.</li> 446b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown * </ul> 456b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown * <p> 466b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown * The behavior of this class varies according to the keyboard capabilities 476b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown * described by the {@link KeyCharacterMap} of the keyboard device such as 486b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown * the {@link KeyCharacterMap#getModifierBehavior() key modifier behavior}. 496b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown * </p><p> 506b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown * {@link MetaKeyKeyListener} implements chorded and toggled key modifiers. 516b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown * When key modifiers are toggled into a latched or locked state, the state 526b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown * of the modifier is stored in the {@link Editable} text buffer or in a 536b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown * meta state integer managed by the client. These latched or locked modifiers 546b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown * should be considered to be held <b>in addition to</b> those that the 556b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown * keyboard already reported as being pressed in {@link KeyEvent#getMetaState()}. 566b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown * In other words, the {@link MetaKeyKeyListener} augments the meta state 576b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown * provided by the keyboard; it does not replace it. This distinction is important 586b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown * to ensure that meta keys not handled by {@link MetaKeyKeyListener} such as 596b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown * {@link KeyEvent#KEYCODE_CAPS_LOCK} or {@link KeyEvent#KEYCODE_NUM_LOCK} are 606b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown * taken into consideration. 616b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown * </p><p> 626b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown * To ensure correct meta key behavior, the following pattern should be used 636b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown * when mapping key codes to characters: 646b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown * </p> 656b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown * <code> 666b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown * private char getUnicodeChar(TextKeyListener listener, KeyEvent event, Editable textBuffer) { 676b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown * // Use the combined meta states from the event and the key listener. 686b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown * int metaState = event.getMetaState() | listener.getMetaState(textBuffer); 696b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown * return event.getUnicodeChar(metaState); 706b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown * } 716b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown * </code> 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic abstract class MetaKeyKeyListener { 74497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown /** 75497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown * Flag that indicates that the SHIFT key is on. 76497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown * Value equals {@link KeyEvent#META_SHIFT_ON}. 77497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown */ 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int META_SHIFT_ON = KeyEvent.META_SHIFT_ON; 79497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown /** 80497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown * Flag that indicates that the ALT key is on. 81497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown * Value equals {@link KeyEvent#META_ALT_ON}. 82497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown */ 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int META_ALT_ON = KeyEvent.META_ALT_ON; 84497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown /** 85497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown * Flag that indicates that the SYM key is on. 86497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown * Value equals {@link KeyEvent#META_SYM_ON}. 87497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown */ 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int META_SYM_ON = KeyEvent.META_SYM_ON; 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 90497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown /** 91497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown * Flag that indicates that the SHIFT key is locked in CAPS mode. 92497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown */ 93497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown public static final int META_CAP_LOCKED = KeyEvent.META_CAP_LOCKED; 94497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown /** 95497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown * Flag that indicates that the ALT key is locked. 96497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown */ 97497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown public static final int META_ALT_LOCKED = KeyEvent.META_ALT_LOCKED; 98497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown /** 99497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown * Flag that indicates that the SYM key is locked. 100497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown */ 101497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown public static final int META_SYM_LOCKED = KeyEvent.META_SYM_LOCKED; 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide pending API review 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 106497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown public static final int META_SELECTING = KeyEvent.META_SELECTING; 107497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown 108497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown // These bits are privately used by the meta key key listener. 109497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown // They are deliberately assigned values outside of the representable range of an 'int' 110497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown // so as not to conflict with any meta key states publicly defined by KeyEvent. 111497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown private static final long META_CAP_USED = 1L << 32; 112497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown private static final long META_ALT_USED = 1L << 33; 113497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown private static final long META_SYM_USED = 1L << 34; 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 115497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown private static final long META_CAP_PRESSED = 1L << 40; 116497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown private static final long META_ALT_PRESSED = 1L << 41; 117497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown private static final long META_SYM_PRESSED = 1L << 42; 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 119497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown private static final long META_CAP_RELEASED = 1L << 48; 120497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown private static final long META_ALT_RELEASED = 1L << 49; 121497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown private static final long META_SYM_RELEASED = 1L << 50; 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final long META_SHIFT_MASK = META_SHIFT_ON 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project | META_CAP_LOCKED | META_CAP_USED 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project | META_CAP_PRESSED | META_CAP_RELEASED; 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final long META_ALT_MASK = META_ALT_ON 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project | META_ALT_LOCKED | META_ALT_USED 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project | META_ALT_PRESSED | META_ALT_RELEASED; 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final long META_SYM_MASK = META_SYM_ON 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project | META_SYM_LOCKED | META_SYM_USED 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project | META_SYM_PRESSED | META_SYM_RELEASED; 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final Object CAP = new NoCopySpan.Concrete(); 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final Object ALT = new NoCopySpan.Concrete(); 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final Object SYM = new NoCopySpan.Concrete(); 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final Object SELECTING = new NoCopySpan.Concrete(); 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Resets all meta state to inactive. 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static void resetMetaState(Spannable text) { 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project text.removeSpan(CAP); 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project text.removeSpan(ALT); 1449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project text.removeSpan(SYM); 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project text.removeSpan(SELECTING); 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets the state of the meta keys. 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text the buffer in which the meta key would have been pressed. 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return an integer in which each bit set to one represents a pressed 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or locked meta key. 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int getMetaState(CharSequence text) { 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return getActive(text, CAP, META_SHIFT_ON, META_CAP_LOCKED) | 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project getActive(text, ALT, META_ALT_ON, META_ALT_LOCKED) | 1599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project getActive(text, SYM, META_SYM_ON, META_SYM_LOCKED) | 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project getActive(text, SELECTING, META_SELECTING, META_SELECTING); 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets the state of a particular meta key. 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param meta META_SHIFT_ON, META_ALT_ON, META_SYM_ON, or META_SELECTING 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text the buffer in which the meta key would have been pressed. 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return 0 if inactive, 1 if active, 2 if locked. 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int getMetaState(CharSequence text, int meta) { 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project switch (meta) { 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case META_SHIFT_ON: 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return getActive(text, CAP, 1, 2); 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case META_ALT_ON: 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return getActive(text, ALT, 1, 2); 1789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case META_SYM_ON: 1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return getActive(text, SYM, 1, 2); 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case META_SELECTING: 1839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return getActive(text, SELECTING, 1, 2); 1849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project default: 1869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return 0; 1879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static int getActive(CharSequence text, Object meta, 1919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int on, int lock) { 1929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!(text instanceof Spanned)) { 1939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return 0; 1949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Spanned sp = (Spanned) text; 1979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int flag = sp.getSpanFlags(meta); 1989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (flag == LOCKED) { 2009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return lock; 2019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (flag != 0) { 2029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return on; 2039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 2049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return 0; 2059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Call this method after you handle a keypress so that the meta 2109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * state will be reset to unshifted (if it is not still down) 2119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or primed to be reset to unshifted (once it is released). 2129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static void adjustMetaAfterKeypress(Spannable content) { 2149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project adjust(content, CAP); 2159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project adjust(content, ALT); 2169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project adjust(content, SYM); 2179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns true if this object is one that this class would use to 221b2a3dd88a53cc8c6d19f6dc8ec4f3d6c4abd9b54The Android Open Source Project * keep track of any meta state in the specified text. 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static boolean isMetaTracker(CharSequence text, Object what) { 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return what == CAP || what == ALT || what == SYM || 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project what == SELECTING; 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 228b2a3dd88a53cc8c6d19f6dc8ec4f3d6c4abd9b54The Android Open Source Project /** 229b2a3dd88a53cc8c6d19f6dc8ec4f3d6c4abd9b54The Android Open Source Project * Returns true if this object is one that this class would use to 230b2a3dd88a53cc8c6d19f6dc8ec4f3d6c4abd9b54The Android Open Source Project * keep track of the selecting meta state in the specified text. 231b2a3dd88a53cc8c6d19f6dc8ec4f3d6c4abd9b54The Android Open Source Project */ 232b2a3dd88a53cc8c6d19f6dc8ec4f3d6c4abd9b54The Android Open Source Project public static boolean isSelectingMetaTracker(CharSequence text, Object what) { 233b2a3dd88a53cc8c6d19f6dc8ec4f3d6c4abd9b54The Android Open Source Project return what == SELECTING; 234b2a3dd88a53cc8c6d19f6dc8ec4f3d6c4abd9b54The Android Open Source Project } 235b2a3dd88a53cc8c6d19f6dc8ec4f3d6c4abd9b54The Android Open Source Project 2369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static void adjust(Spannable content, Object what) { 2379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int current = content.getSpanFlags(what); 2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (current == PRESSED) 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project content.setSpan(what, 0, 0, USED); 2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project else if (current == RELEASED) 2429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project content.removeSpan(what); 2439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Call this if you are a method that ignores the locked meta state 2479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (arrow keys, for example) and you handle a key. 2489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected static void resetLockedMeta(Spannable content) { 2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project resetLock(content, CAP); 2519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project resetLock(content, ALT); 2529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project resetLock(content, SYM); 2539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project resetLock(content, SELECTING); 2549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static void resetLock(Spannable content, Object what) { 2579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int current = content.getSpanFlags(what); 2589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (current == LOCKED) 2609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project content.removeSpan(what); 2619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Handles presses of the meta keys. 2659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2666b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown public boolean onKeyDown(View view, Editable content, int keyCode, KeyEvent event) { 2679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (keyCode == KeyEvent.KEYCODE_SHIFT_LEFT || keyCode == KeyEvent.KEYCODE_SHIFT_RIGHT) { 2689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project press(content, CAP); 2699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return true; 2709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (keyCode == KeyEvent.KEYCODE_ALT_LEFT || keyCode == KeyEvent.KEYCODE_ALT_RIGHT 2739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project || keyCode == KeyEvent.KEYCODE_NUM) { 2749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project press(content, ALT); 2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return true; 2769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (keyCode == KeyEvent.KEYCODE_SYM) { 2799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project press(content, SYM); 2809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return true; 2819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; // no super to call through to 2849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private void press(Editable content, Object what) { 2879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int state = content.getSpanFlags(what); 2889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (state == PRESSED) 2909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ; // repeat before use 2919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project else if (state == RELEASED) 2929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project content.setSpan(what, 0, 0, LOCKED); 2939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project else if (state == USED) 2949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ; // repeat after use 2959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project else if (state == LOCKED) 2969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project content.removeSpan(what); 2979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project else 2989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project content.setSpan(what, 0, 0, PRESSED); 2999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Start selecting text. 3039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide pending API review 3049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static void startSelecting(View view, Spannable content) { 3069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project content.setSpan(SELECTING, 0, 0, PRESSED); 3079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Stop selecting text. This does not actually collapse the selection; 3119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * call {@link android.text.Selection#setSelection} too. 3129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide pending API review 3139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static void stopSelecting(View view, Spannable content) { 3159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project content.removeSpan(SELECTING); 3169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Handles release of the meta keys. 3209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3216b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown public boolean onKeyUp(View view, Editable content, int keyCode, KeyEvent event) { 3229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (keyCode == KeyEvent.KEYCODE_SHIFT_LEFT || keyCode == KeyEvent.KEYCODE_SHIFT_RIGHT) { 3236b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown release(content, CAP, event); 3249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return true; 3259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (keyCode == KeyEvent.KEYCODE_ALT_LEFT || keyCode == KeyEvent.KEYCODE_ALT_RIGHT 3289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project || keyCode == KeyEvent.KEYCODE_NUM) { 3296b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown release(content, ALT, event); 3309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return true; 3319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (keyCode == KeyEvent.KEYCODE_SYM) { 3346b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown release(content, SYM, event); 3359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return true; 3369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; // no super to call through to 3399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3416b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown private void release(Editable content, Object what, KeyEvent event) { 3429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int current = content.getSpanFlags(what); 3439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3446b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown switch (event.getKeyCharacterMap().getModifierBehavior()) { 3456b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown case KeyCharacterMap.MODIFIER_BEHAVIOR_CHORDED_OR_TOGGLED: 3466b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown if (current == USED) 3476b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown content.removeSpan(what); 3486b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown else if (current == PRESSED) 3496b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown content.setSpan(what, 0, 0, RELEASED); 3506b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown break; 3516b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown 3526b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown default: 3536b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown content.removeSpan(what); 3546b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown break; 3556b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown } 3569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void clearMetaKeyState(View view, Editable content, int states) { 3599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project clearMetaKeyState(content, states); 3609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static void clearMetaKeyState(Editable content, int states) { 3639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((states&META_SHIFT_ON) != 0) content.removeSpan(CAP); 3649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((states&META_ALT_ON) != 0) content.removeSpan(ALT); 3659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((states&META_SYM_ON) != 0) content.removeSpan(SYM); 3669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((states&META_SELECTING) != 0) content.removeSpan(SELECTING); 3679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Call this if you are a method that ignores the locked meta state 3719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (arrow keys, for example) and you handle a key. 3729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static long resetLockedMeta(long state) { 374497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown if ((state & META_CAP_LOCKED) != 0) { 375497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown state &= ~META_SHIFT_MASK; 376497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown } 377497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown if ((state & META_ALT_LOCKED) != 0) { 378497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown state &= ~META_ALT_MASK; 379497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown } 380497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown if ((state & META_SYM_LOCKED) != 0) { 381497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown state &= ~META_SYM_MASK; 3829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return state; 3849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // --------------------------------------------------------------------- 3879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Version of API that operates on a state bit mask 3889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // --------------------------------------------------------------------- 3899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets the state of the meta keys. 3929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param state the current meta state bits. 3949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return an integer in which each bit set to one represents a pressed 3969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or locked meta key. 3979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int getMetaState(long state) { 399497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown int result = 0; 400497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown 401497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown if ((state & META_CAP_LOCKED) != 0) { 402497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown result |= META_CAP_LOCKED; 403497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown } else if ((state & META_SHIFT_ON) != 0) { 404497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown result |= META_SHIFT_ON; 405497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown } 406497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown 407497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown if ((state & META_ALT_LOCKED) != 0) { 408497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown result |= META_ALT_LOCKED; 409497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown } else if ((state & META_ALT_ON) != 0) { 410497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown result |= META_ALT_ON; 411497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown } 412497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown 413497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown if ((state & META_SYM_LOCKED) != 0) { 414497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown result |= META_SYM_LOCKED; 415497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown } else if ((state & META_SYM_ON) != 0) { 416497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown result |= META_SYM_ON; 417497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown } 418497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown 419497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown return result; 4209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets the state of a particular meta key. 4249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param state the current state bits. 4269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param meta META_SHIFT_ON, META_ALT_ON, or META_SYM_ON 4279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return 0 if inactive, 1 if active, 2 if locked. 4299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int getMetaState(long state, int meta) { 4319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project switch (meta) { 4329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case META_SHIFT_ON: 433497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown if ((state & META_CAP_LOCKED) != 0) return 2; 434497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown if ((state & META_SHIFT_ON) != 0) return 1; 435497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown return 0; 4369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case META_ALT_ON: 438497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown if ((state & META_ALT_LOCKED) != 0) return 2; 439497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown if ((state & META_ALT_ON) != 0) return 1; 440497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown return 0; 4419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case META_SYM_ON: 443497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown if ((state & META_SYM_LOCKED) != 0) return 2; 444497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown if ((state & META_SYM_ON) != 0) return 1; 445497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown return 0; 4469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project default: 4489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return 0; 4499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Call this method after you handle a keypress so that the meta 4549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * state will be reset to unshifted (if it is not still down) 4559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or primed to be reset to unshifted (once it is released). Takes 4569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the current state, returns the new state. 4579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static long adjustMetaAfterKeypress(long state) { 459497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown if ((state & META_CAP_PRESSED) != 0) { 460497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown state = (state & ~META_SHIFT_MASK) | META_SHIFT_ON | META_CAP_USED; 461497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown } else if ((state & META_CAP_RELEASED) != 0) { 462497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown state &= ~META_SHIFT_MASK; 463497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown } 464497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown 465497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown if ((state & META_ALT_PRESSED) != 0) { 466497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown state = (state & ~META_ALT_MASK) | META_ALT_ON | META_ALT_USED; 467497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown } else if ((state & META_ALT_RELEASED) != 0) { 468497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown state &= ~META_ALT_MASK; 469497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown } 4709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 471497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown if ((state & META_SYM_PRESSED) != 0) { 472497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown state = (state & ~META_SYM_MASK) | META_SYM_ON | META_SYM_USED; 473497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown } else if ((state & META_SYM_RELEASED) != 0) { 474497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown state &= ~META_SYM_MASK; 475497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown } 4769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return state; 4779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Handles presses of the meta keys. 4819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static long handleKeyDown(long state, int keyCode, KeyEvent event) { 4839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (keyCode == KeyEvent.KEYCODE_SHIFT_LEFT || keyCode == KeyEvent.KEYCODE_SHIFT_RIGHT) { 484497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown return press(state, META_SHIFT_ON, META_SHIFT_MASK, 485497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown META_CAP_LOCKED, META_CAP_PRESSED, META_CAP_RELEASED, META_CAP_USED); 4869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (keyCode == KeyEvent.KEYCODE_ALT_LEFT || keyCode == KeyEvent.KEYCODE_ALT_RIGHT 4899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project || keyCode == KeyEvent.KEYCODE_NUM) { 490497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown return press(state, META_ALT_ON, META_ALT_MASK, 491497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown META_ALT_LOCKED, META_ALT_PRESSED, META_ALT_RELEASED, META_ALT_USED); 4929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (keyCode == KeyEvent.KEYCODE_SYM) { 495497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown return press(state, META_SYM_ON, META_SYM_MASK, 496497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown META_SYM_LOCKED, META_SYM_PRESSED, META_SYM_RELEASED, META_SYM_USED); 4979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return state; 4999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 501497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown private static long press(long state, int what, long mask, 502497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown long locked, long pressed, long released, long used) { 503497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown if ((state & pressed) != 0) { 504497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown // repeat before use 505497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown } else if ((state & released) != 0) { 506497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown state = (state &~ mask) | what | locked; 507497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown } else if ((state & used) != 0) { 508497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown // repeat after use 509497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown } else if ((state & locked) != 0) { 510497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown state &= ~mask; 511497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown } else { 512497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown state |= what | pressed; 513497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown } 5149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return state; 5159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Handles release of the meta keys. 5199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static long handleKeyUp(long state, int keyCode, KeyEvent event) { 5219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (keyCode == KeyEvent.KEYCODE_SHIFT_LEFT || keyCode == KeyEvent.KEYCODE_SHIFT_RIGHT) { 522497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown return release(state, META_SHIFT_ON, META_SHIFT_MASK, 5236b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown META_CAP_PRESSED, META_CAP_RELEASED, META_CAP_USED, event); 5249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (keyCode == KeyEvent.KEYCODE_ALT_LEFT || keyCode == KeyEvent.KEYCODE_ALT_RIGHT 5279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project || keyCode == KeyEvent.KEYCODE_NUM) { 528497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown return release(state, META_ALT_ON, META_ALT_MASK, 5296b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown META_ALT_PRESSED, META_ALT_RELEASED, META_ALT_USED, event); 5309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (keyCode == KeyEvent.KEYCODE_SYM) { 533497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown return release(state, META_SYM_ON, META_SYM_MASK, 5346b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown META_SYM_PRESSED, META_SYM_RELEASED, META_SYM_USED, event); 5359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return state; 5379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 539497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown private static long release(long state, int what, long mask, 5406b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown long pressed, long released, long used, KeyEvent event) { 5416b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown switch (event.getKeyCharacterMap().getModifierBehavior()) { 5426b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown case KeyCharacterMap.MODIFIER_BEHAVIOR_CHORDED_OR_TOGGLED: 5436b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown if ((state & used) != 0) { 5446b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown state &= ~mask; 5456b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown } else if ((state & pressed) != 0) { 5466b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown state |= what | released; 5476b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown } 5486b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown break; 5496b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown 5506b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown default: 5516b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown state &= ~mask; 5526b53e8daa69cba1a2a5a7c95a01e37ce9c53226cJeff Brown break; 553497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown } 5549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return state; 5559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 557497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown /** 558497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown * Clears the state of the specified meta key if it is locked. 559497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown * @param state the meta key state 560497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown * @param which meta keys to clear, may be a combination of {@link #META_SHIFT_ON}, 561497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown * {@link #META_ALT_ON} or {@link #META_SYM_ON}. 562497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown */ 5639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public long clearMetaKeyState(long state, int which) { 56452715a7c10eeb798692ffdb4bc8c4305cb0aa705Jeff Brown if ((which & META_SHIFT_ON) != 0 && (state & META_CAP_LOCKED) != 0) { 565497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown state &= ~META_SHIFT_MASK; 566497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown } 56752715a7c10eeb798692ffdb4bc8c4305cb0aa705Jeff Brown if ((which & META_ALT_ON) != 0 && (state & META_ALT_LOCKED) != 0) { 568497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown state &= ~META_ALT_MASK; 569497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown } 57052715a7c10eeb798692ffdb4bc8c4305cb0aa705Jeff Brown if ((which & META_SYM_ON) != 0 && (state & META_SYM_LOCKED) != 0) { 571497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown state &= ~META_SYM_MASK; 572497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown } 5739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return state; 5749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 575497a92cc5ba2176b8a8484b0a7da040eac0e887bJeff Brown 5769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The meta key has been pressed but has not yet been used. 5789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int PRESSED = 5809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Spannable.SPAN_MARK_MARK | (1 << Spannable.SPAN_USER_SHIFT); 5819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The meta key has been pressed and released but has still 5849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * not yet been used. 5859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int RELEASED = 5879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Spannable.SPAN_MARK_MARK | (2 << Spannable.SPAN_USER_SHIFT); 5889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The meta key has been pressed and used but has not yet been released. 5919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int USED = 5939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Spannable.SPAN_MARK_MARK | (3 << Spannable.SPAN_USER_SHIFT); 5949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The meta key has been pressed and released without use, and then 5979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * pressed again; it may also have been released again. 5989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int LOCKED = 6009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Spannable.SPAN_MARK_MARK | (4 << Spannable.SPAN_USER_SHIFT); 6019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 6029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 603