115a4d2ffd04dc6c70f2cd17dae12ac6bc14c69abKenny Root/* 215a4d2ffd04dc6c70f2cd17dae12ac6bc14c69abKenny Root * Copyright (C) 2008 The Android Open Source Project 315a4d2ffd04dc6c70f2cd17dae12ac6bc14c69abKenny Root * 415a4d2ffd04dc6c70f2cd17dae12ac6bc14c69abKenny Root * Licensed under the Apache License, Version 2.0 (the "License"); 515a4d2ffd04dc6c70f2cd17dae12ac6bc14c69abKenny Root * you may not use this file except in compliance with the License. 615a4d2ffd04dc6c70f2cd17dae12ac6bc14c69abKenny Root * You may obtain a copy of the License at 715a4d2ffd04dc6c70f2cd17dae12ac6bc14c69abKenny Root * 815a4d2ffd04dc6c70f2cd17dae12ac6bc14c69abKenny Root * http://www.apache.org/licenses/LICENSE-2.0 915a4d2ffd04dc6c70f2cd17dae12ac6bc14c69abKenny Root * 1015a4d2ffd04dc6c70f2cd17dae12ac6bc14c69abKenny Root * Unless required by applicable law or agreed to in writing, software 1115a4d2ffd04dc6c70f2cd17dae12ac6bc14c69abKenny Root * distributed under the License is distributed on an "AS IS" BASIS, 1215a4d2ffd04dc6c70f2cd17dae12ac6bc14c69abKenny Root * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 1315a4d2ffd04dc6c70f2cd17dae12ac6bc14c69abKenny Root * See the License for the specific language governing permissions and 1415a4d2ffd04dc6c70f2cd17dae12ac6bc14c69abKenny Root * limitations under the License. 1515a4d2ffd04dc6c70f2cd17dae12ac6bc14c69abKenny Root */ 1615a4d2ffd04dc6c70f2cd17dae12ac6bc14c69abKenny Root 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpackage android.view.inputmethod; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19d469f2122edf7662dbe8c9c39269064c0265b520Yohei Yukawaimport android.annotation.Nullable; 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Bundle; 2123cbe85610f780134cc77dd4a54732a22ed6e86eYohei Yukawaimport android.os.LocaleList; 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Parcel; 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Parcelable; 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.text.InputType; 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.text.TextUtils; 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.util.Printer; 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 28152944f4909c47917473293b258d266435c6ab35Yohei Yukawaimport java.util.Arrays; 29152944f4909c47917473293b258d266435c6ab35Yohei Yukawa 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * An EditorInfo describes several attributes of a text editing object 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * that an input method is communicating with (typically an EditText), most 336fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard * importantly the type of text content it contains and the current cursor position. 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class EditorInfo implements InputType, Parcelable { 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 37d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * Masks for {@link inputType} 38d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * 39d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * <pre> 40d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * |-------|-------|-------|-------| 41d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * 1111 TYPE_MASK_CLASS 42d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * 11111111 TYPE_MASK_VARIATION 43d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * 111111111111 TYPE_MASK_FLAGS 44d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * |-------|-------|-------|-------| 45d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * TYPE_NULL 46d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * |-------|-------|-------|-------| 47d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * 1 TYPE_CLASS_TEXT 48d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * 1 TYPE_TEXT_VARIATION_URI 49d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * 1 TYPE_TEXT_VARIATION_EMAIL_ADDRESS 50d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * 11 TYPE_TEXT_VARIATION_EMAIL_SUBJECT 51d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * 1 TYPE_TEXT_VARIATION_SHORT_MESSAGE 52d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * 1 1 TYPE_TEXT_VARIATION_LONG_MESSAGE 53d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * 11 TYPE_TEXT_VARIATION_PERSON_NAME 54d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * 111 TYPE_TEXT_VARIATION_POSTAL_ADDRESS 55d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * 1 TYPE_TEXT_VARIATION_PASSWORD 56d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * 1 1 TYPE_TEXT_VARIATION_VISIBLE_PASSWORD 57d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * 1 1 TYPE_TEXT_VARIATION_WEB_EDIT_TEXT 58d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * 1 11 TYPE_TEXT_VARIATION_FILTER 59d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * 11 TYPE_TEXT_VARIATION_PHONETIC 60d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * 11 1 TYPE_TEXT_VARIATION_WEB_EMAIL_ADDRESS 61d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * 111 TYPE_TEXT_VARIATION_WEB_PASSWORD 62d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * 1 TYPE_TEXT_FLAG_CAP_CHARACTERS 63d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * 1 TYPE_TEXT_FLAG_CAP_WORDS 64d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * 1 TYPE_TEXT_FLAG_CAP_SENTENCES 65d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * 1 TYPE_TEXT_FLAG_AUTO_CORRECT 66d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * 1 TYPE_TEXT_FLAG_AUTO_COMPLETE 67d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * 1 TYPE_TEXT_FLAG_MULTI_LINE 68d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * 1 TYPE_TEXT_FLAG_IME_MULTI_LINE 69d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * 1 TYPE_TEXT_FLAG_NO_SUGGESTIONS 70d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * |-------|-------|-------|-------| 71d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * 1 TYPE_CLASS_NUMBER 72d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * 1 TYPE_NUMBER_VARIATION_PASSWORD 73d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * 1 TYPE_NUMBER_FLAG_SIGNED 74d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * 1 TYPE_NUMBER_FLAG_DECIMAL 75d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * |-------|-------|-------|-------| 76d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * 11 TYPE_CLASS_PHONE 77d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * |-------|-------|-------|-------| 78d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * 1 TYPE_CLASS_DATETIME 79d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * 1 TYPE_DATETIME_VARIATION_DATE 80d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * 1 TYPE_DATETIME_VARIATION_TIME 81d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * |-------|-------|-------|-------|</pre> 82d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa */ 83d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa 84d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa /** 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The content type of the text box, whose bits are defined by 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link InputType}. 876fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard * 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see InputType 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #TYPE_MASK_CLASS 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #TYPE_MASK_VARIATION 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #TYPE_MASK_FLAGS 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int inputType = TYPE_NULL; 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Set of bits in {@link #imeOptions} that provide alternative actions 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * associated with the "enter" key. This both helps the IME provide 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * better feedback about what the enter key will do, and also allows it 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to provide alternative mechanisms for providing that command. 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int IME_MASK_ACTION = 0x000000ff; 1026fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 104b2a3dd88a53cc8c6d19f6dc8ec4f3d6c4abd9b54The Android Open Source Project * Bits of {@link #IME_MASK_ACTION}: no specific action has been 105b2a3dd88a53cc8c6d19f6dc8ec4f3d6c4abd9b54The Android Open Source Project * associated with this editor, let the editor come up with its own if 106b2a3dd88a53cc8c6d19f6dc8ec4f3d6c4abd9b54The Android Open Source Project * it can. 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 108b2a3dd88a53cc8c6d19f6dc8ec4f3d6c4abd9b54The Android Open Source Project public static final int IME_ACTION_UNSPECIFIED = 0x00000000; 1096fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard 110b2a3dd88a53cc8c6d19f6dc8ec4f3d6c4abd9b54The Android Open Source Project /** 111b2a3dd88a53cc8c6d19f6dc8ec4f3d6c4abd9b54The Android Open Source Project * Bits of {@link #IME_MASK_ACTION}: there is no available action. 112b2a3dd88a53cc8c6d19f6dc8ec4f3d6c4abd9b54The Android Open Source Project */ 113b2a3dd88a53cc8c6d19f6dc8ec4f3d6c4abd9b54The Android Open Source Project public static final int IME_ACTION_NONE = 0x00000001; 1146fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Bits of {@link #IME_MASK_ACTION}: the action key performs a "go" 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * operation to take the user to the target of the text they typed. 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Typically used, for example, when entering a URL. 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 120b2a3dd88a53cc8c6d19f6dc8ec4f3d6c4abd9b54The Android Open Source Project public static final int IME_ACTION_GO = 0x00000002; 1216fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Bits of {@link #IME_MASK_ACTION}: the action key performs a "search" 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * operation, taking the user to the results of searching for the text 125c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * they have typed (in whatever context is appropriate). 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 127b2a3dd88a53cc8c6d19f6dc8ec4f3d6c4abd9b54The Android Open Source Project public static final int IME_ACTION_SEARCH = 0x00000003; 1286fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Bits of {@link #IME_MASK_ACTION}: the action key performs a "send" 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * operation, delivering the text to its target. This is typically used 132c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * when composing a message in IM or SMS where sending is immediate. 1339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 134b2a3dd88a53cc8c6d19f6dc8ec4f3d6c4abd9b54The Android Open Source Project public static final int IME_ACTION_SEND = 0x00000004; 1356fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Bits of {@link #IME_MASK_ACTION}: the action key performs a "next" 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * operation, taking the user to the next field that will accept text. 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 140b2a3dd88a53cc8c6d19f6dc8ec4f3d6c4abd9b54The Android Open Source Project public static final int IME_ACTION_NEXT = 0x00000005; 1416fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1434df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project * Bits of {@link #IME_MASK_ACTION}: the action key performs a "done" 144c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * operation, typically meaning there is nothing more to input and the 145c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * IME will be closed. 1464df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project */ 147b2a3dd88a53cc8c6d19f6dc8ec4f3d6c4abd9b54The Android Open Source Project public static final int IME_ACTION_DONE = 0x00000006; 1486fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard 1494df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project /** 1506fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard * Bits of {@link #IME_MASK_ACTION}: like {@link #IME_ACTION_NEXT}, but 151dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn * for moving to the previous field. This will normally not be used to 152c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * specify an action (since it precludes {@link #IME_ACTION_NEXT}), but 153dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn * can be returned to the app if it sets {@link #IME_FLAG_NAVIGATE_PREVIOUS}. 154dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn */ 155dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn public static final int IME_ACTION_PREVIOUS = 0x00000007; 156dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn 157dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn /** 158d91860d9cee7387e1ca035df3c15f3bfba5929faYohei Yukawa * Flag of {@link #imeOptions}: used to request that the IME should not update any personalized 1595959af13d069e77ff2b2ac729225e7d248b83a79Yohei Yukawa * data such as typing history and personalized language model based on what the user typed on 1605959af13d069e77ff2b2ac729225e7d248b83a79Yohei Yukawa * this text editing object. Typical use cases are: 1615959af13d069e77ff2b2ac729225e7d248b83a79Yohei Yukawa * <ul> 1625959af13d069e77ff2b2ac729225e7d248b83a79Yohei Yukawa * <li>When the application is in a special mode, where user's activities are expected to be 1635959af13d069e77ff2b2ac729225e7d248b83a79Yohei Yukawa * not recorded in the application's history. Some web browsers and chat applications may 1645959af13d069e77ff2b2ac729225e7d248b83a79Yohei Yukawa * have this kind of modes.</li> 1655959af13d069e77ff2b2ac729225e7d248b83a79Yohei Yukawa * <li>When storing typing history does not make much sense. Specifying this flag in typing 1665959af13d069e77ff2b2ac729225e7d248b83a79Yohei Yukawa * games may help to avoid typing history from being filled up with words that the user is 1675959af13d069e77ff2b2ac729225e7d248b83a79Yohei Yukawa * less likely to type in their daily life. Another example is that when the application 1685959af13d069e77ff2b2ac729225e7d248b83a79Yohei Yukawa * already knows that the expected input is not a valid word (e.g. a promotion code that is 1695959af13d069e77ff2b2ac729225e7d248b83a79Yohei Yukawa * not a valid word in any natural language).</li> 1705959af13d069e77ff2b2ac729225e7d248b83a79Yohei Yukawa * </ul> 1715959af13d069e77ff2b2ac729225e7d248b83a79Yohei Yukawa * 1725959af13d069e77ff2b2ac729225e7d248b83a79Yohei Yukawa * <p>Applications need to be aware that the flag is not a guarantee, and some IMEs may not 1735959af13d069e77ff2b2ac729225e7d248b83a79Yohei Yukawa * respect it.</p> 1745959af13d069e77ff2b2ac729225e7d248b83a79Yohei Yukawa */ 1755959af13d069e77ff2b2ac729225e7d248b83a79Yohei Yukawa public static final int IME_FLAG_NO_PERSONALIZED_LEARNING = 0x1000000; 1765959af13d069e77ff2b2ac729225e7d248b83a79Yohei Yukawa 1775959af13d069e77ff2b2ac729225e7d248b83a79Yohei Yukawa /** 178dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn * Flag of {@link #imeOptions}: used to request that the IME never go 179c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * into fullscreen mode. 180c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * By default, IMEs may go into full screen mode when they think 181c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * it's appropriate, for example on small screens in landscape 182c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * orientation where displaying a software keyboard may occlude 183c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * such a large portion of the screen that the remaining part is 184c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * too small to meaningfully display the application UI. 185c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * If this flag is set, compliant IMEs will never go into full screen mode, 186c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * and always leave some space to display the application UI. 187c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * Applications need to be aware that the flag is not a guarantee, and 188c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * some IMEs may ignore it. 189dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn */ 190dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn public static final int IME_FLAG_NO_FULLSCREEN = 0x2000000; 191dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn 192dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn /** 193dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn * Flag of {@link #imeOptions}: like {@link #IME_FLAG_NAVIGATE_NEXT}, but 194dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn * specifies there is something interesting that a backward navigation 195dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn * can focus on. If the user selects the IME's facility to backward 196dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn * navigate, this will show up in the application as an {@link #IME_ACTION_PREVIOUS} 197dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn * at {@link InputConnection#performEditorAction(int) 198dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn * InputConnection.performEditorAction(int)}. 199dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn */ 200dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn public static final int IME_FLAG_NAVIGATE_PREVIOUS = 0x4000000; 201dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn 202dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn /** 203dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn * Flag of {@link #imeOptions}: used to specify that there is something 204dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn * interesting that a forward navigation can focus on. This is like using 205dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn * {@link #IME_ACTION_NEXT}, except allows the IME to be multiline (with 206dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn * an enter key) as well as provide forward navigation. Note that some 207dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn * IMEs may not be able to do this, especially when running on a small 208dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn * screen where there is little space. In that case it does not need to 209dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn * present a UI for this option. Like {@link #IME_ACTION_NEXT}, if the 210dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn * user selects the IME's facility to forward navigate, this will show up 211dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn * in the application at {@link InputConnection#performEditorAction(int) 212dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn * InputConnection.performEditorAction(int)}. 213dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn */ 214dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn public static final int IME_FLAG_NAVIGATE_NEXT = 0x8000000; 215dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn 216dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn /** 217105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * Flag of {@link #imeOptions}: used to specify that the IME does not need 218105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * to show its extracted text UI. For input methods that may be fullscreen, 219105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * often when in landscape mode, this allows them to be smaller and let part 220c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * of the application be shown behind, through transparent UI parts in the 221c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * fullscreen IME. The part of the UI visible to the user may not be responsive 222c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * to touch because the IME will receive touch events, which may confuse the 223218ecd43946001f07b60757db130ef5585d474d3Jean Chalard * user; use {@link #IME_FLAG_NO_FULLSCREEN} instead for a better experience. 224c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * Using this flag is discouraged and it may become deprecated in the future. 225c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * Its meaning is unclear in some situations and it may not work appropriately 226c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * on older versions of the platform. 227105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project */ 228105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project public static final int IME_FLAG_NO_EXTRACT_UI = 0x10000000; 2296fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard 230105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project /** 231c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * Flag of {@link #imeOptions}: used in conjunction with one of the actions 232c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * masked by {@link #IME_MASK_ACTION}, this indicates that the action 233c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * should not be available as an accessory button on the right of the extracted 234c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * text when the input method is full-screen. Note that by setting this flag, 235c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * there can be cases where the action is simply never available to the 236c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * user. Setting this generally means that you think that in fullscreen mode, 237c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * where there is little space to show the text, it's not worth taking some 238c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * screen real estate to display the action and it should be used instead 239c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * to show more text. 240105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project */ 241105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project public static final int IME_FLAG_NO_ACCESSORY_ACTION = 0x20000000; 2426fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard 243105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project /** 244c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * Flag of {@link #imeOptions}: used in conjunction with one of the actions 245c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * masked by {@link #IME_MASK_ACTION}. If this flag is not set, IMEs will 246c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * normally replace the "enter" key with the action supplied. This flag 247c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * indicates that the action should not be available in-line as a replacement 248c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * for the "enter" key. Typically this is because the action has such a 249c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * significant impact or is not recoverable enough that accidentally hitting 250c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * it should be avoided, such as sending a message. Note that 251c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * {@link android.widget.TextView} will automatically set this flag for you 252c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * on multi-line text views. 2539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int IME_FLAG_NO_ENTER_ACTION = 0x40000000; 2552edd68260f26cbd6eddd0df16404bb6bcb22b3b6Leon Scroggins 2562edd68260f26cbd6eddd0df16404bb6bcb22b3b6Leon Scroggins /** 257c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * Flag of {@link #imeOptions}: used to request an IME that is capable of 258c8f4183669c7cf166ced70bf60ad056482f3390bKen Wakasa * inputting ASCII characters. The intention of this flag is to ensure that 259c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * the user can type Roman alphabet characters in a {@link android.widget.TextView}. 260c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * It is typically used for an account ID or password input. A lot of the time, 261c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * IMEs are already able to input ASCII even without being told so (such IMEs 262c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * already respect this flag in a sense), but there are cases when this is not 263c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * the default. For instance, users of languages using a different script like 264c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * Arabic, Greek, Hebrew or Russian typically have a keyboard that can't 265c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * input ASCII characters by default. Applications need to be 266c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * aware that the flag is not a guarantee, and some IMEs may not respect it. 267c8f4183669c7cf166ced70bf60ad056482f3390bKen Wakasa * However, it is strongly recommended for IME authors to respect this flag 268c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * especially when their IME could end up with a state where only languages 269c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * using non-ASCII are enabled. 270c8f4183669c7cf166ced70bf60ad056482f3390bKen Wakasa */ 271c8f4183669c7cf166ced70bf60ad056482f3390bKen Wakasa public static final int IME_FLAG_FORCE_ASCII = 0x80000000; 272c8f4183669c7cf166ced70bf60ad056482f3390bKen Wakasa 273c8f4183669c7cf166ced70bf60ad056482f3390bKen Wakasa /** 274b2a3dd88a53cc8c6d19f6dc8ec4f3d6c4abd9b54The Android Open Source Project * Generic unspecified type for {@link #imeOptions}. 2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 276b2a3dd88a53cc8c6d19f6dc8ec4f3d6c4abd9b54The Android Open Source Project public static final int IME_NULL = 0x00000000; 2776fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard 2789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 279d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * Masks for {@link imeOptions} 280d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * 281d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * <pre> 282d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * |-------|-------|-------|-------| 283d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * 1111 IME_MASK_ACTION 284d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * |-------|-------|-------|-------| 285d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * IME_ACTION_UNSPECIFIED 286d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * 1 IME_ACTION_NONE 287d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * 1 IME_ACTION_GO 288d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * 11 IME_ACTION_SEARCH 289d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * 1 IME_ACTION_SEND 290d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * 1 1 IME_ACTION_NEXT 291d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * 11 IME_ACTION_DONE 292d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * 111 IME_ACTION_PREVIOUS 2935959af13d069e77ff2b2ac729225e7d248b83a79Yohei Yukawa * 1 IME_FLAG_NO_PERSONALIZED_LEARNING 294d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * 1 IME_FLAG_NO_FULLSCREEN 295d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * 1 IME_FLAG_NAVIGATE_PREVIOUS 296d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * 1 IME_FLAG_NAVIGATE_NEXT 297d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * 1 IME_FLAG_NO_EXTRACT_UI 298d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * 1 IME_FLAG_NO_ACCESSORY_ACTION 299d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * 1 IME_FLAG_NO_ENTER_ACTION 300d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * 1 IME_FLAG_FORCE_ASCII 301d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa * |-------|-------|-------|-------|</pre> 302d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa */ 303d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa 304d0bbe2176fa2405142711167a68d357371581305Yohei Yukawa /** 3059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Extended type information for the editor, to help the IME better 3069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * integrate with it. 3079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 308b2a3dd88a53cc8c6d19f6dc8ec4f3d6c4abd9b54The Android Open Source Project public int imeOptions = IME_NULL; 3096fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard 3109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * A string supplying additional information options that are 3129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * private to a particular IME implementation. The string must be 3139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * scoped to a package owned by the implementation, to ensure there are 3149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * no conflicts between implementations, but other than that you can put 3159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * whatever you want in it to communicate with the IME. For example, 3169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you could have a string that supplies an argument like 3179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <code>"com.example.myapp.SpecialMode=3"</code>. This field is can be 3189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * filled in from the {@link android.R.attr#privateImeOptions} 3199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * attribute of a TextView. 3209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String privateImeOptions = null; 3226fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard 3239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * In some cases an IME may be able to display an arbitrary label for 325c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * a command the user can perform, which you can specify here. This is 326c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * typically used as the label for the action to use in-line as a replacement 327c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * for the "enter" key (see {@link #actionId}). Remember the key where 328c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * this will be displayed is typically very small, and there are significant 329c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * localization challenges to make this fit in all supported languages. Also 330c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * you can not count absolutely on this being used, as some IMEs may 331c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * ignore this. 3329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public CharSequence actionLabel = null; 3346fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard 3359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If {@link #actionLabel} has been given, this is the id for that command 3379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * when the user presses its button that is delivered back with 3389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link InputConnection#performEditorAction(int) 3399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * InputConnection.performEditorAction()}. 3409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int actionId = 0; 3426fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard 3439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The text offset of the start of the selection at the time editing 3456fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard * begins; -1 if not known. Keep in mind that, without knowing the cursor 3466fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard * position, many IMEs will not be able to offer their full feature set and 3476fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard * may even behave in unpredictable ways: pass the actual cursor position 3486fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard * here if possible at all. 3496fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard * 3506fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard * <p>Also, this needs to be the cursor position <strong>right now</strong>, 3516fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard * not at some point in the past, even if input is starting in the same text field 3526fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard * as before. When the app is filling this object, input is about to start by 3536fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard * definition, and this value will override any value the app may have passed to 3546fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard * {@link InputMethodManager#updateSelection(android.view.View, int, int, int, int)} 3556fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard * before.</p> 3569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int initialSelStart = -1; 3586fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard 3599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3606fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard * <p>The text offset of the end of the selection at the time editing 3616fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard * begins; -1 if not known. Keep in mind that, without knowing the cursor 3626fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard * position, many IMEs will not be able to offer their full feature set and 3636fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard * may behave in unpredictable ways: pass the actual cursor position 3646fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard * here if possible at all.</p> 3656fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard * 3666fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard * <p>Also, this needs to be the cursor position <strong>right now</strong>, 3676fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard * not at some point in the past, even if input is starting in the same text field 3686fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard * as before. When the app is filling this object, input is about to start by 3696fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard * definition, and this value will override any value the app may have passed to 3706fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard * {@link InputMethodManager#updateSelection(android.view.View, int, int, int, int)} 3716fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard * before.</p> 3729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int initialSelEnd = -1; 3746fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard 3759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The capitalization mode of the first character being edited in the 3779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * text. Values may be any combination of 3789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link TextUtils#CAP_MODE_CHARACTERS TextUtils.CAP_MODE_CHARACTERS}, 3799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link TextUtils#CAP_MODE_WORDS TextUtils.CAP_MODE_WORDS}, and 3809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link TextUtils#CAP_MODE_SENTENCES TextUtils.CAP_MODE_SENTENCES}, though 3816fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard * you should generally just take a non-zero value to mean "start out in 3826fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard * caps mode". 3839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int initialCapsMode = 0; 3856fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard 3869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The "hint" text of the text view, typically shown in-line when the 3889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * text is empty to tell the user what to enter. 3899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public CharSequence hintText; 3916fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard 3929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * A label to show to the user describing the text they are writing. 3949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public CharSequence label; 3966fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard 3979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Name of the package that owns this editor. 399915e2c77317e594d12700c7c392ae91c16c0480dYohei Yukawa * 400915e2c77317e594d12700c7c392ae91c16c0480dYohei Yukawa * <p><strong>IME authors:</strong> In API level 22 401915e2c77317e594d12700c7c392ae91c16c0480dYohei Yukawa * {@link android.os.Build.VERSION_CODES#LOLLIPOP_MR1} and prior, do not trust this package 402915e2c77317e594d12700c7c392ae91c16c0480dYohei Yukawa * name. The system had not verified the consistency between the package name here and 403915e2c77317e594d12700c7c392ae91c16c0480dYohei Yukawa * application's uid. Consider to use {@link InputBinding#getUid()}, which is trustworthy. 4040e3de6cacaffcfeda4d6353be61e2f1f9ed80705Dianne Hackborn * Starting from {@link android.os.Build.VERSION_CODES#M}, the system verifies the consistency 4050e3de6cacaffcfeda4d6353be61e2f1f9ed80705Dianne Hackborn * between this package name and application uid before {@link EditorInfo} is passed to the 4060e3de6cacaffcfeda4d6353be61e2f1f9ed80705Dianne Hackborn * input method.</p> 407915e2c77317e594d12700c7c392ae91c16c0480dYohei Yukawa * 4080e3de6cacaffcfeda4d6353be61e2f1f9ed80705Dianne Hackborn * <p><strong>Editor authors:</strong> Starting from {@link android.os.Build.VERSION_CODES#M}, 4090e3de6cacaffcfeda4d6353be61e2f1f9ed80705Dianne Hackborn * the application is no longer 410915e2c77317e594d12700c7c392ae91c16c0480dYohei Yukawa * able to establish input connections if the package name provided here is inconsistent with 411d57ba675b1f767885e6d3ccd4d0f7037e634648bYohei Yukawa * application's uid.</p> 4129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String packageName; 4146fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard 4159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Identifier for the editor's field. This is optional, and may be 4179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 0. By default it is filled in with the result of 4189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.view.View#getId() View.getId()} on the View that 4199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is being edited. 4209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int fieldId; 4226fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard 4239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Additional name for the editor's field. This can supply additional 4259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * name information for the field. By default it is null. The actual 4269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * contents have no meaning. 4279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String fieldName; 4296fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard 4309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Any extra data to supply to the input method. This is for extended 4329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * communication with specific input methods; the name fields in the 4339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * bundle should be scoped (such as "com.mydomain.im.SOME_FIELD") so 434c1a11f17a2de18911317d235ff75fa17e098a962Jean Chalard * that they don't conflict with others. This field can be 4359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * filled in from the {@link android.R.attr#editorExtras} 4369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * attribute of a TextView. 4379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Bundle extras; 4396fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard 4409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 441d469f2122edf7662dbe8c9c39269064c0265b520Yohei Yukawa * List of the languages that the user is supposed to switch to no matter what input method 442d469f2122edf7662dbe8c9c39269064c0265b520Yohei Yukawa * subtype is currently used. This special "hint" can be used mainly for, but not limited to, 443d469f2122edf7662dbe8c9c39269064c0265b520Yohei Yukawa * multilingual users who want IMEs to switch language context automatically. 4448d6eeb01df72891acd3aa75e64aa1595a41cc96eYohei Yukawa * 445d469f2122edf7662dbe8c9c39269064c0265b520Yohei Yukawa * <p>{@code null} means that no special language "hint" is needed.</p> 4468d6eeb01df72891acd3aa75e64aa1595a41cc96eYohei Yukawa * 447d469f2122edf7662dbe8c9c39269064c0265b520Yohei Yukawa * <p><strong>Editor authors:</strong> Specify this only when you are confident that the user 448d469f2122edf7662dbe8c9c39269064c0265b520Yohei Yukawa * will switch to certain languages in this context no matter what input method subtype is 449d469f2122edf7662dbe8c9c39269064c0265b520Yohei Yukawa * currently selected. Otherwise, keep this {@code null}. Explicit user actions and/or 450d469f2122edf7662dbe8c9c39269064c0265b520Yohei Yukawa * preferences would be good signals to specify this special "hint", For example, a chat 451d469f2122edf7662dbe8c9c39269064c0265b520Yohei Yukawa * application may be able to put the last used language at the top of {@link #hintLocales} 452d469f2122edf7662dbe8c9c39269064c0265b520Yohei Yukawa * based on whom the user is going to talk, by remembering what language is used in the last 453d469f2122edf7662dbe8c9c39269064c0265b520Yohei Yukawa * conversation. Do not specify {@link android.widget.TextView#getTextLocales()} only because 454d469f2122edf7662dbe8c9c39269064c0265b520Yohei Yukawa * it is used for text rendering.</p> 455d469f2122edf7662dbe8c9c39269064c0265b520Yohei Yukawa * 456d469f2122edf7662dbe8c9c39269064c0265b520Yohei Yukawa * @see android.widget.TextView#setImeHintLocales(LocaleList) 457d469f2122edf7662dbe8c9c39269064c0265b520Yohei Yukawa * @see android.widget.TextView#getImeHintLocales() 4588d6eeb01df72891acd3aa75e64aa1595a41cc96eYohei Yukawa */ 459d469f2122edf7662dbe8c9c39269064c0265b520Yohei Yukawa @Nullable 460d469f2122edf7662dbe8c9c39269064c0265b520Yohei Yukawa public LocaleList hintLocales = null; 4618d6eeb01df72891acd3aa75e64aa1595a41cc96eYohei Yukawa 462152944f4909c47917473293b258d266435c6ab35Yohei Yukawa 463152944f4909c47917473293b258d266435c6ab35Yohei Yukawa /** 464152944f4909c47917473293b258d266435c6ab35Yohei Yukawa * List of acceptable MIME types for 46545700fa135e83ed44e4b69ca60cf12960a5898d7Yohei Yukawa * {@link InputConnection#commitContent(InputContentInfo, int, Bundle)}. 466152944f4909c47917473293b258d266435c6ab35Yohei Yukawa * 467152944f4909c47917473293b258d266435c6ab35Yohei Yukawa * <p>{@code null} or an empty array means that 46845700fa135e83ed44e4b69ca60cf12960a5898d7Yohei Yukawa * {@link InputConnection#commitContent(InputContentInfo, int, Bundle)} is not supported in this 469152944f4909c47917473293b258d266435c6ab35Yohei Yukawa * editor.</p> 470152944f4909c47917473293b258d266435c6ab35Yohei Yukawa */ 471152944f4909c47917473293b258d266435c6ab35Yohei Yukawa @Nullable 472152944f4909c47917473293b258d266435c6ab35Yohei Yukawa public String[] contentMimeTypes = null; 473152944f4909c47917473293b258d266435c6ab35Yohei Yukawa 4748d6eeb01df72891acd3aa75e64aa1595a41cc96eYohei Yukawa /** 475dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn * Ensure that the data in this EditorInfo is compatible with an application 476dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn * that was developed against the given target API version. This can 477dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn * impact the following input types: 478dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn * {@link InputType#TYPE_TEXT_VARIATION_WEB_EMAIL_ADDRESS}, 47982d731ac5d28fb54c49948116786813a62b07b8bKen Wakasa * {@link InputType#TYPE_TEXT_VARIATION_WEB_PASSWORD}, 48082d731ac5d28fb54c49948116786813a62b07b8bKen Wakasa * {@link InputType#TYPE_NUMBER_VARIATION_NORMAL}, 48182d731ac5d28fb54c49948116786813a62b07b8bKen Wakasa * {@link InputType#TYPE_NUMBER_VARIATION_PASSWORD}. 482dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn * 483dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn * <p>This is called by the framework for input method implementations; 484dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn * you should not generally need to call it yourself. 485dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn * 486dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn * @param targetSdkVersion The API version number that the compatible 487dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn * application was developed against. 488dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn */ 489dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn public final void makeCompatible(int targetSdkVersion) { 490dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn if (targetSdkVersion < android.os.Build.VERSION_CODES.HONEYCOMB) { 491dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn switch (inputType&(TYPE_MASK_CLASS|TYPE_MASK_VARIATION)) { 492dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn case TYPE_CLASS_TEXT|TYPE_TEXT_VARIATION_WEB_EMAIL_ADDRESS: 493dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn inputType = TYPE_CLASS_TEXT|TYPE_TEXT_VARIATION_EMAIL_ADDRESS 49482d731ac5d28fb54c49948116786813a62b07b8bKen Wakasa | (inputType&TYPE_MASK_FLAGS); 495dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn break; 496dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn case TYPE_CLASS_TEXT|TYPE_TEXT_VARIATION_WEB_PASSWORD: 497dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn inputType = TYPE_CLASS_TEXT|TYPE_TEXT_VARIATION_PASSWORD 49882d731ac5d28fb54c49948116786813a62b07b8bKen Wakasa | (inputType&TYPE_MASK_FLAGS); 49982d731ac5d28fb54c49948116786813a62b07b8bKen Wakasa break; 50082d731ac5d28fb54c49948116786813a62b07b8bKen Wakasa case TYPE_CLASS_NUMBER|TYPE_NUMBER_VARIATION_NORMAL: 50182d731ac5d28fb54c49948116786813a62b07b8bKen Wakasa case TYPE_CLASS_NUMBER|TYPE_NUMBER_VARIATION_PASSWORD: 50282d731ac5d28fb54c49948116786813a62b07b8bKen Wakasa inputType = TYPE_CLASS_NUMBER 50382d731ac5d28fb54c49948116786813a62b07b8bKen Wakasa | (inputType&TYPE_MASK_FLAGS); 504dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn break; 505dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn } 506dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn } 507dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn } 508dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn 509dea3ef7967228f0ddcc03f2455a4f1254758e584Dianne Hackborn /** 5109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Write debug output of this object. 5119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void dump(Printer pw, String prefix) { 5139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project pw.println(prefix + "inputType=0x" + Integer.toHexString(inputType) 5149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project + " imeOptions=0x" + Integer.toHexString(imeOptions) 5159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project + " privateImeOptions=" + privateImeOptions); 5169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project pw.println(prefix + "actionLabel=" + actionLabel 5179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project + " actionId=" + actionId); 5189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project pw.println(prefix + "initialSelStart=" + initialSelStart 5199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project + " initialSelEnd=" + initialSelEnd 5209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project + " initialCapsMode=0x" 5219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project + Integer.toHexString(initialCapsMode)); 5229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project pw.println(prefix + "hintText=" + hintText 5239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project + " label=" + label); 5249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project pw.println(prefix + "packageName=" + packageName 5259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project + " fieldId=" + fieldId 5269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project + " fieldName=" + fieldName); 5279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project pw.println(prefix + "extras=" + extras); 528d469f2122edf7662dbe8c9c39269064c0265b520Yohei Yukawa pw.println(prefix + "hintLocales=" + hintLocales); 529152944f4909c47917473293b258d266435c6ab35Yohei Yukawa pw.println(prefix + "contentMimeTypes=" + Arrays.toString(contentMimeTypes)); 5309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5316fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard 5329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Used to package this object into a {@link Parcel}. 5346fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard * 5359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param dest The {@link Parcel} to be written. 5369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param flags The flags used for parceling. 5379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void writeToParcel(Parcel dest, int flags) { 5399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project dest.writeInt(inputType); 5409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project dest.writeInt(imeOptions); 5419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project dest.writeString(privateImeOptions); 5429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project TextUtils.writeToParcel(actionLabel, dest, flags); 5439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project dest.writeInt(actionId); 5449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project dest.writeInt(initialSelStart); 5459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project dest.writeInt(initialSelEnd); 5469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project dest.writeInt(initialCapsMode); 5479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project TextUtils.writeToParcel(hintText, dest, flags); 5489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project TextUtils.writeToParcel(label, dest, flags); 5499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project dest.writeString(packageName); 5509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project dest.writeInt(fieldId); 5519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project dest.writeString(fieldName); 5529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project dest.writeBundle(extras); 553d469f2122edf7662dbe8c9c39269064c0265b520Yohei Yukawa if (hintLocales != null) { 554d469f2122edf7662dbe8c9c39269064c0265b520Yohei Yukawa hintLocales.writeToParcel(dest, flags); 555d469f2122edf7662dbe8c9c39269064c0265b520Yohei Yukawa } else { 556d469f2122edf7662dbe8c9c39269064c0265b520Yohei Yukawa LocaleList.getEmptyLocaleList().writeToParcel(dest, flags); 557d469f2122edf7662dbe8c9c39269064c0265b520Yohei Yukawa } 558152944f4909c47917473293b258d266435c6ab35Yohei Yukawa dest.writeStringArray(contentMimeTypes); 5599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Used to make this class parcelable. 5639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5646fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard public static final Parcelable.Creator<EditorInfo> CREATOR = 5656fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard new Parcelable.Creator<EditorInfo>() { 5666fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard public EditorInfo createFromParcel(Parcel source) { 5676fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard EditorInfo res = new EditorInfo(); 5686fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard res.inputType = source.readInt(); 5696fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard res.imeOptions = source.readInt(); 5706fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard res.privateImeOptions = source.readString(); 5716fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard res.actionLabel = TextUtils.CHAR_SEQUENCE_CREATOR.createFromParcel(source); 5726fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard res.actionId = source.readInt(); 5736fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard res.initialSelStart = source.readInt(); 5746fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard res.initialSelEnd = source.readInt(); 5756fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard res.initialCapsMode = source.readInt(); 5766fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard res.hintText = TextUtils.CHAR_SEQUENCE_CREATOR.createFromParcel(source); 5776fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard res.label = TextUtils.CHAR_SEQUENCE_CREATOR.createFromParcel(source); 5786fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard res.packageName = source.readString(); 5796fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard res.fieldId = source.readInt(); 5806fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard res.fieldName = source.readString(); 5816fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard res.extras = source.readBundle(); 582d469f2122edf7662dbe8c9c39269064c0265b520Yohei Yukawa LocaleList hintLocales = LocaleList.CREATOR.createFromParcel(source); 583d469f2122edf7662dbe8c9c39269064c0265b520Yohei Yukawa res.hintLocales = hintLocales.isEmpty() ? null : hintLocales; 584152944f4909c47917473293b258d266435c6ab35Yohei Yukawa res.contentMimeTypes = source.readStringArray(); 5856fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard return res; 5866fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard } 5879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5886fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard public EditorInfo[] newArray(int size) { 5896fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard return new EditorInfo[size]; 5906fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard } 5916fd68e0930a0260437a50b3a0e3edbac073dfcecJean Chalard }; 5929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int describeContents() { 5949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return 0; 5959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 598