WordComposer.java revision 7196566d4f2048a4160acc6271ccb26c73d6fcd6
1923bf41f853a544fd0d71fbf7dc90359ec35981The Android Open Source Project/* 2443c360d0afdbab091994244f045f4756feaf2b4Jean-Baptiste Queru * Copyright (C) 2008 The Android Open Source Project 30fd625bcfdfac1c10e7bd7f9088bf425fec08989Jean Chalard * 48aa9963a895f9dd5bb1bc92ab2e4f461e058f87aTadashi G. Takaoka * Licensed under the Apache License, Version 2.0 (the "License"); 58aa9963a895f9dd5bb1bc92ab2e4f461e058f87aTadashi G. Takaoka * you may not use this file except in compliance with the License. 68aa9963a895f9dd5bb1bc92ab2e4f461e058f87aTadashi G. Takaoka * You may obtain a copy of the License at 70fd625bcfdfac1c10e7bd7f9088bf425fec08989Jean Chalard * 88aa9963a895f9dd5bb1bc92ab2e4f461e058f87aTadashi G. Takaoka * http://www.apache.org/licenses/LICENSE-2.0 90fd625bcfdfac1c10e7bd7f9088bf425fec08989Jean Chalard * 10923bf41f853a544fd0d71fbf7dc90359ec35981The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 118aa9963a895f9dd5bb1bc92ab2e4f461e058f87aTadashi G. Takaoka * distributed under the License is distributed on an "AS IS" BASIS, 128aa9963a895f9dd5bb1bc92ab2e4f461e058f87aTadashi G. Takaoka * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 138aa9963a895f9dd5bb1bc92ab2e4f461e058f87aTadashi G. Takaoka * See the License for the specific language governing permissions and 148aa9963a895f9dd5bb1bc92ab2e4f461e058f87aTadashi G. Takaoka * limitations under the License. 15923bf41f853a544fd0d71fbf7dc90359ec35981The Android Open Source Project */ 16923bf41f853a544fd0d71fbf7dc90359ec35981The Android Open Source Project 17923bf41f853a544fd0d71fbf7dc90359ec35981The Android Open Source Projectpackage com.android.inputmethod.latin; 18923bf41f853a544fd0d71fbf7dc90359ec35981The Android Open Source Project 197ede642df417c0f732573f639970b138f0bee18cJean Chalardimport com.android.inputmethod.event.CombinerChain; 20f8accd8839d291f10b218e64aa6b8eb154c92c4cJean Chalardimport com.android.inputmethod.event.Event; 212dae79b1966a7970c25c8b79beec1c95c13f6c87Tadashi G. Takaokaimport com.android.inputmethod.latin.define.DebugFlags; 22d1f463eacfaac31a999f7eb1ecaa1668ed3038d4Jean Chalardimport com.android.inputmethod.latin.utils.CoordinateUtils; 235fa2202e36a84bd5808fa10ca25c9179acb1b173Jean Chalardimport com.android.inputmethod.latin.utils.StringUtils; 24887f11ee43ad621aa6ad93d535ab7f48dec73fc7Tadashi G. Takaoka 25f8accd8839d291f10b218e64aa6b8eb154c92c4cJean Chalardimport java.util.ArrayList; 26f8accd8839d291f10b218e64aa6b8eb154c92c4cJean Chalardimport java.util.Collections; 27923bf41f853a544fd0d71fbf7dc90359ec35981The Android Open Source Project 28923bf41f853a544fd0d71fbf7dc90359ec35981The Android Open Source Project/** 29923bf41f853a544fd0d71fbf7dc90359ec35981The Android Open Source Project * A place to store the currently composing word with information such as adjacent key codes as well 30923bf41f853a544fd0d71fbf7dc90359ec35981The Android Open Source Project */ 31a28a05e971cc242b338331a3b78276fa95188d19Tadashi G. Takaokapublic final class WordComposer { 32ffcbbaf12788a9fc9398607a548e552d7d2bf05eSatoshi Kataoka private static final int MAX_WORD_LENGTH = Constants.DICTIONARY_MAX_WORD_LENGTH; 332dae79b1966a7970c25c8b79beec1c95c13f6c87Tadashi G. Takaoka private static final boolean DBG = DebugFlags.DEBUG_ENABLED; 348fbd55229243cb66c03d5ea1f79dfb39f596590dsatok 35adbd9ae105e06287b59379d7f7127d95fd0663f4Jean Chalard public static final int CAPS_MODE_OFF = 0; 36adbd9ae105e06287b59379d7f7127d95fd0663f4Jean Chalard // 1 is shift bit, 2 is caps bit, 4 is auto bit but this is just a convention as these bits 37adbd9ae105e06287b59379d7f7127d95fd0663f4Jean Chalard // aren't used anywhere in the code 38adbd9ae105e06287b59379d7f7127d95fd0663f4Jean Chalard public static final int CAPS_MODE_MANUAL_SHIFTED = 0x1; 39adbd9ae105e06287b59379d7f7127d95fd0663f4Jean Chalard public static final int CAPS_MODE_MANUAL_SHIFT_LOCKED = 0x3; 40adbd9ae105e06287b59379d7f7127d95fd0663f4Jean Chalard public static final int CAPS_MODE_AUTO_SHIFTED = 0x5; 41adbd9ae105e06287b59379d7f7127d95fd0663f4Jean Chalard public static final int CAPS_MODE_AUTO_SHIFT_LOCKED = 0x7; 42adbd9ae105e06287b59379d7f7127d95fd0663f4Jean Chalard 437ede642df417c0f732573f639970b138f0bee18cJean Chalard private CombinerChain mCombinerChain; 44be99616afa2243fe48dc406d0a3f442cb05453b4Jean Chalard private String mCombiningSpec; // Memory so that we don't uselessly recreate the combiner chain 457ede642df417c0f732573f639970b138f0bee18cJean Chalard 46f8accd8839d291f10b218e64aa6b8eb154c92c4cJean Chalard // The list of events that served to compose this string. 47f8accd8839d291f10b218e64aa6b8eb154c92c4cJean Chalard private final ArrayList<Event> mEvents; 4896b22200beb98fd1a6288f4cf53e38611a09cdd0Ken Wakasa private final InputPointers mInputPointers = new InputPointers(MAX_WORD_LENGTH); 49bc464e2952e102219f0b977fc1e9140ad5bd03e4Tadashi G. Takaoka private String mAutoCorrection; 504b5b46bb66bf74ef5edd65c55e186b02f3c56e5dJean Chalard private boolean mIsResumed; 51d82dcdc9246b340c4b355e34efc6079f3278efa6Tadashi G. Takaoka private boolean mIsBatchMode; 52d40f3f6bc1bcf07800fbee0468fe90d307ca28bbJean Chalard // A memory of the last rejected batch mode suggestion, if any. This goes like this: the user 53d40f3f6bc1bcf07800fbee0468fe90d307ca28bbJean Chalard // gestures a word, is displeased with the results and hits backspace, then gestures again. 54d40f3f6bc1bcf07800fbee0468fe90d307ca28bbJean Chalard // At the very least we should avoid re-suggesting the same thing, and to do that we memorize 55d40f3f6bc1bcf07800fbee0468fe90d307ca28bbJean Chalard // the rejected suggestion in this variable. 56d40f3f6bc1bcf07800fbee0468fe90d307ca28bbJean Chalard // TODO: this should be done in a comprehensive way by the User History feature instead of 57d40f3f6bc1bcf07800fbee0468fe90d307ca28bbJean Chalard // as an ad-hockery here. 58d40f3f6bc1bcf07800fbee0468fe90d307ca28bbJean Chalard private String mRejectedBatchModeSuggestion; 594a7ff90d513f8b6cbf39688c08be0828a57e311bAmith Yamasani 60be79227dc99421ff7be62224c51c553b3fa73777Jean Chalard // Cache these values for performance 613285b68c97d966d86c08aeb837e5bf5633981357Jean Chalard private CharSequence mTypedWordCache; 624a7ff90d513f8b6cbf39688c08be0828a57e311bAmith Yamasani private int mCapsCount; 63e7c471a52f38c48cd38e412d88901bddb6f903a9Jean Chalard private int mDigitsCount; 64adbd9ae105e06287b59379d7f7127d95fd0663f4Jean Chalard private int mCapitalizedMode; 655fa2202e36a84bd5808fa10ca25c9179acb1b173Jean Chalard // This is the number of code points entered so far. This is not limited to MAX_WORD_LENGTH. 665fa2202e36a84bd5808fa10ca25c9179acb1b173Jean Chalard // In general, this contains the size of mPrimaryKeyCodes, except when this is greater than 675fa2202e36a84bd5808fa10ca25c9179acb1b173Jean Chalard // MAX_WORD_LENGTH in which case mPrimaryKeyCodes only contain the first MAX_WORD_LENGTH 685fa2202e36a84bd5808fa10ca25c9179acb1b173Jean Chalard // code points. 6901ab7c8b59a7f12862fbd95fb252e56719f1757fsatok private int mCodePointSize; 706a114fa700d3ca73c608e1291b74bbbdd5a1a7b7Jean Chalard private int mCursorPositionWithinWord; 71c83359f9746ca6f0269a1a7017b585c1a5cab9b8Jean Chalard 72923bf41f853a544fd0d71fbf7dc90359ec35981The Android Open Source Project /** 73367c199de16f7ce8e608bdf38bf35df8995e18a0Jean Chalard * Whether the composing word has the only first char capitalized. 74923bf41f853a544fd0d71fbf7dc90359ec35981The Android Open Source Project */ 75367c199de16f7ce8e608bdf38bf35df8995e18a0Jean Chalard private boolean mIsOnlyFirstCharCapitalized; 76923bf41f853a544fd0d71fbf7dc90359ec35981The Android Open Source Project 77979f8690967ff5409fe18f5085858ccdb8e0ccf1satok public WordComposer() { 785ce39dfa782031fd53af167c0fd9a9bc63d21149Jean Chalard mCombinerChain = new CombinerChain(""); 79a91561aa58db1c43092c1caecc051a11fa5391c7Tadashi G. Takaoka mEvents = new ArrayList<>(); 80be79227dc99421ff7be62224c51c553b3fa73777Jean Chalard mAutoCorrection = null; 814b5b46bb66bf74ef5edd65c55e186b02f3c56e5dJean Chalard mIsResumed = false; 82d82dcdc9246b340c4b355e34efc6079f3278efa6Tadashi G. Takaoka mIsBatchMode = false; 836a114fa700d3ca73c608e1291b74bbbdd5a1a7b7Jean Chalard mCursorPositionWithinWord = 0; 84d40f3f6bc1bcf07800fbee0468fe90d307ca28bbJean Chalard mRejectedBatchModeSuggestion = null; 853285b68c97d966d86c08aeb837e5bf5633981357Jean Chalard refreshTypedWordCache(); 86923bf41f853a544fd0d71fbf7dc90359ec35981The Android Open Source Project } 87923bf41f853a544fd0d71fbf7dc90359ec35981The Android Open Source Project 88923bf41f853a544fd0d71fbf7dc90359ec35981The Android Open Source Project /** 895ce39dfa782031fd53af167c0fd9a9bc63d21149Jean Chalard * Restart the combiners, possibly with a new spec. 90be99616afa2243fe48dc406d0a3f442cb05453b4Jean Chalard * @param combiningSpec The spec string for combining. This is found in the extra value. 91be99616afa2243fe48dc406d0a3f442cb05453b4Jean Chalard */ 925ce39dfa782031fd53af167c0fd9a9bc63d21149Jean Chalard public void restartCombining(final String combiningSpec) { 93be99616afa2243fe48dc406d0a3f442cb05453b4Jean Chalard final String nonNullCombiningSpec = null == combiningSpec ? "" : combiningSpec; 945ce39dfa782031fd53af167c0fd9a9bc63d21149Jean Chalard if (!nonNullCombiningSpec.equals(mCombiningSpec)) { 955ce39dfa782031fd53af167c0fd9a9bc63d21149Jean Chalard mCombinerChain = new CombinerChain( 965ce39dfa782031fd53af167c0fd9a9bc63d21149Jean Chalard mCombinerChain.getComposingWordWithCombiningFeedback().toString(), 975ce39dfa782031fd53af167c0fd9a9bc63d21149Jean Chalard CombinerChain.createCombiners(nonNullCombiningSpec)); 98be99616afa2243fe48dc406d0a3f442cb05453b4Jean Chalard mCombiningSpec = nonNullCombiningSpec; 99be99616afa2243fe48dc406d0a3f442cb05453b4Jean Chalard } 100be99616afa2243fe48dc406d0a3f442cb05453b4Jean Chalard } 101be99616afa2243fe48dc406d0a3f442cb05453b4Jean Chalard 102be99616afa2243fe48dc406d0a3f442cb05453b4Jean Chalard /** 103923bf41f853a544fd0d71fbf7dc90359ec35981The Android Open Source Project * Clear out the keys registered so far. 104923bf41f853a544fd0d71fbf7dc90359ec35981The Android Open Source Project */ 105923bf41f853a544fd0d71fbf7dc90359ec35981The Android Open Source Project public void reset() { 106cbed462d192d0c5af9614f5f997b2768f3d0eb56Jean Chalard mCombinerChain.reset(); 107f8accd8839d291f10b218e64aa6b8eb154c92c4cJean Chalard mEvents.clear(); 108be79227dc99421ff7be62224c51c553b3fa73777Jean Chalard mAutoCorrection = null; 1094a7ff90d513f8b6cbf39688c08be0828a57e311bAmith Yamasani mCapsCount = 0; 110e7c471a52f38c48cd38e412d88901bddb6f903a9Jean Chalard mDigitsCount = 0; 111367c199de16f7ce8e608bdf38bf35df8995e18a0Jean Chalard mIsOnlyFirstCharCapitalized = false; 1124b5b46bb66bf74ef5edd65c55e186b02f3c56e5dJean Chalard mIsResumed = false; 113d82dcdc9246b340c4b355e34efc6079f3278efa6Tadashi G. Takaoka mIsBatchMode = false; 1146a114fa700d3ca73c608e1291b74bbbdd5a1a7b7Jean Chalard mCursorPositionWithinWord = 0; 115d40f3f6bc1bcf07800fbee0468fe90d307ca28bbJean Chalard mRejectedBatchModeSuggestion = null; 1163285b68c97d966d86c08aeb837e5bf5633981357Jean Chalard refreshTypedWordCache(); 11701ab7c8b59a7f12862fbd95fb252e56719f1757fsatok } 11801ab7c8b59a7f12862fbd95fb252e56719f1757fsatok 1193285b68c97d966d86c08aeb837e5bf5633981357Jean Chalard private final void refreshTypedWordCache() { 1203285b68c97d966d86c08aeb837e5bf5633981357Jean Chalard mTypedWordCache = mCombinerChain.getComposingWordWithCombiningFeedback(); 1213285b68c97d966d86c08aeb837e5bf5633981357Jean Chalard mCodePointSize = Character.codePointCount(mTypedWordCache, 0, mTypedWordCache.length()); 122923bf41f853a544fd0d71fbf7dc90359ec35981The Android Open Source Project } 123923bf41f853a544fd0d71fbf7dc90359ec35981The Android Open Source Project 124923bf41f853a544fd0d71fbf7dc90359ec35981The Android Open Source Project /** 125923bf41f853a544fd0d71fbf7dc90359ec35981The Android Open Source Project * Number of keystrokes in the composing word. 126923bf41f853a544fd0d71fbf7dc90359ec35981The Android Open Source Project * @return the number of keystrokes 127923bf41f853a544fd0d71fbf7dc90359ec35981The Android Open Source Project */ 12870d9152c7f9e06d7d02dbbcb53af5c8f19d16b8dJean Chalard // This may be made public if need be, but right now it's not used anywhere 12970d9152c7f9e06d7d02dbbcb53af5c8f19d16b8dJean Chalard /* package for tests */ int size() { 13001ab7c8b59a7f12862fbd95fb252e56719f1757fsatok return mCodePointSize; 131923bf41f853a544fd0d71fbf7dc90359ec35981The Android Open Source Project } 132923bf41f853a544fd0d71fbf7dc90359ec35981The Android Open Source Project 1335f430e0189f6c0a1a34edb0e00809bc53a525a7bJean Chalard /** 1345f430e0189f6c0a1a34edb0e00809bc53a525a7bJean Chalard * Copy the code points in the typed word to a destination array of ints. 1355f430e0189f6c0a1a34edb0e00809bc53a525a7bJean Chalard * 1365f430e0189f6c0a1a34edb0e00809bc53a525a7bJean Chalard * If the array is too small to hold the code points in the typed word, nothing is copied and 1375f430e0189f6c0a1a34edb0e00809bc53a525a7bJean Chalard * -1 is returned. 1385f430e0189f6c0a1a34edb0e00809bc53a525a7bJean Chalard * 1395f430e0189f6c0a1a34edb0e00809bc53a525a7bJean Chalard * @param destination the array of ints. 1405f430e0189f6c0a1a34edb0e00809bc53a525a7bJean Chalard * @return the number of copied code points. 1415f430e0189f6c0a1a34edb0e00809bc53a525a7bJean Chalard */ 1425f430e0189f6c0a1a34edb0e00809bc53a525a7bJean Chalard public int copyCodePointsExceptTrailingSingleQuotesAndReturnCodePointCount( 14311b707616800e08891f6b610be90033acda8ffd0Xiaojun Bi final int[] destination) { 144d660f3bec990851090e3adb98de236e02323011eJean Chalard // This method can be called on a separate thread and mTypedWordCache can change while we 145d660f3bec990851090e3adb98de236e02323011eJean Chalard // are executing this method. 146d660f3bec990851090e3adb98de236e02323011eJean Chalard final String typedWord = mTypedWordCache.toString(); 14711b707616800e08891f6b610be90033acda8ffd0Xiaojun Bi // lastIndex is exclusive 148d660f3bec990851090e3adb98de236e02323011eJean Chalard final int lastIndex = typedWord.length() 149d660f3bec990851090e3adb98de236e02323011eJean Chalard - StringUtils.getTrailingSingleQuotesCount(typedWord); 15011b707616800e08891f6b610be90033acda8ffd0Xiaojun Bi if (lastIndex <= 0) { 1515f430e0189f6c0a1a34edb0e00809bc53a525a7bJean Chalard // The string is empty or contains only single quotes. 1525f430e0189f6c0a1a34edb0e00809bc53a525a7bJean Chalard return 0; 1535f430e0189f6c0a1a34edb0e00809bc53a525a7bJean Chalard } 15411b707616800e08891f6b610be90033acda8ffd0Xiaojun Bi 15511b707616800e08891f6b610be90033acda8ffd0Xiaojun Bi // The following function counts the number of code points in the text range which begins 15611b707616800e08891f6b610be90033acda8ffd0Xiaojun Bi // at index 0 and extends to the character at lastIndex. 157d660f3bec990851090e3adb98de236e02323011eJean Chalard final int codePointSize = Character.codePointCount(typedWord, 0, lastIndex); 15811b707616800e08891f6b610be90033acda8ffd0Xiaojun Bi if (codePointSize > destination.length) { 1595f430e0189f6c0a1a34edb0e00809bc53a525a7bJean Chalard return -1; 1605f430e0189f6c0a1a34edb0e00809bc53a525a7bJean Chalard } 161d660f3bec990851090e3adb98de236e02323011eJean Chalard return StringUtils.copyCodePointsAndReturnCodePointCount(destination, typedWord, 0, 16211b707616800e08891f6b610be90033acda8ffd0Xiaojun Bi lastIndex, true /* downCase */); 16370d9152c7f9e06d7d02dbbcb53af5c8f19d16b8dJean Chalard } 16470d9152c7f9e06d7d02dbbcb53af5c8f19d16b8dJean Chalard 1655f430e0189f6c0a1a34edb0e00809bc53a525a7bJean Chalard public boolean isSingleLetter() { 1665f430e0189f6c0a1a34edb0e00809bc53a525a7bJean Chalard return size() == 1; 1678e829c37dff9fb5eec62390bf0e2c6f12fd6781bJean Chalard } 1688e829c37dff9fb5eec62390bf0e2c6f12fd6781bJean Chalard 169196d82cdd740580ed79d801483dbc282be85d076Jean Chalard public final boolean isComposingWord() { 17001ab7c8b59a7f12862fbd95fb252e56719f1757fsatok return size() > 0; 171196d82cdd740580ed79d801483dbc282be85d076Jean Chalard } 172196d82cdd740580ed79d801483dbc282be85d076Jean Chalard 17371538b08e4e08d556f700ad344562ca2c7b74d82Satoshi Kataoka public InputPointers getInputPointers() { 17471538b08e4e08d556f700ad344562ca2c7b74d82Satoshi Kataoka return mInputPointers; 1758fbd55229243cb66c03d5ea1f79dfb39f596590dsatok } 1768fbd55229243cb66c03d5ea1f79dfb39f596590dsatok 177923bf41f853a544fd0d71fbf7dc90359ec35981The Android Open Source Project /** 1787196566d4f2048a4160acc6271ccb26c73d6fcd6Jean Chalard * Process an event and return an event, and return a processed event to apply. 1797196566d4f2048a4160acc6271ccb26c73d6fcd6Jean Chalard * @param event the unprocessed event. 1807196566d4f2048a4160acc6271ccb26c73d6fcd6Jean Chalard * @return the processed event. 1817196566d4f2048a4160acc6271ccb26c73d6fcd6Jean Chalard */ 1827196566d4f2048a4160acc6271ccb26c73d6fcd6Jean Chalard public Event processEvent(final Event event) { 1837196566d4f2048a4160acc6271ccb26c73d6fcd6Jean Chalard final Event processedEvent = mCombinerChain.processEvent(mEvents, event); 1847196566d4f2048a4160acc6271ccb26c73d6fcd6Jean Chalard mEvents.add(event); 1857196566d4f2048a4160acc6271ccb26c73d6fcd6Jean Chalard return processedEvent; 1867196566d4f2048a4160acc6271ccb26c73d6fcd6Jean Chalard } 1877196566d4f2048a4160acc6271ccb26c73d6fcd6Jean Chalard 1887196566d4f2048a4160acc6271ccb26c73d6fcd6Jean Chalard /** 1897196566d4f2048a4160acc6271ccb26c73d6fcd6Jean Chalard * Apply a processed input event. 190d52bec00695a6e43b8e8836112919c02952d4dccJean Chalard * 191d52bec00695a6e43b8e8836112919c02952d4dccJean Chalard * All input events should be supported, including software/hardware events, characters as well 192d52bec00695a6e43b8e8836112919c02952d4dccJean Chalard * as deletions, multiple inputs and gestures. 193d52bec00695a6e43b8e8836112919c02952d4dccJean Chalard * 1947196566d4f2048a4160acc6271ccb26c73d6fcd6Jean Chalard * @param event the event to apply. 195923bf41f853a544fd0d71fbf7dc90359ec35981The Android Open Source Project */ 1967196566d4f2048a4160acc6271ccb26c73d6fcd6Jean Chalard public void applyProcessedEvent(final Event event) { 197dfaeb125eb27172e4d38e1e5a87a13a3320c1e82Jean Chalard final int primaryCode = event.mCodePoint; 198dfaeb125eb27172e4d38e1e5a87a13a3320c1e82Jean Chalard final int keyX = event.mX; 199dfaeb125eb27172e4d38e1e5a87a13a3320c1e82Jean Chalard final int keyY = event.mY; 200dfaeb125eb27172e4d38e1e5a87a13a3320c1e82Jean Chalard final int newIndex = size(); 2017196566d4f2048a4160acc6271ccb26c73d6fcd6Jean Chalard mCombinerChain.applyProcessedEvent(event); 2020f913ff5ba71c40a4492994a23010336cd25be8eJean Chalard refreshTypedWordCache(); 203dfaeb125eb27172e4d38e1e5a87a13a3320c1e82Jean Chalard mCursorPositionWithinWord = mCodePointSize; 204dfaeb125eb27172e4d38e1e5a87a13a3320c1e82Jean Chalard // We may have deleted the last one. 205dfaeb125eb27172e4d38e1e5a87a13a3320c1e82Jean Chalard if (0 == mCodePointSize) { 206367c199de16f7ce8e608bdf38bf35df8995e18a0Jean Chalard mIsOnlyFirstCharCapitalized = false; 207dfaeb125eb27172e4d38e1e5a87a13a3320c1e82Jean Chalard } 2081ef9d5938e671ce7a9d5c29d95c1364d6d6249eaJean Chalard if (Constants.CODE_DELETE != event.mKeyCode) { 209633e4f45330cf32d76c29d999b723ddeafd3a90cJean Chalard if (newIndex < MAX_WORD_LENGTH) { 210633e4f45330cf32d76c29d999b723ddeafd3a90cJean Chalard // In the batch input mode, the {@code mInputPointers} holds batch input points and 211633e4f45330cf32d76c29d999b723ddeafd3a90cJean Chalard // shouldn't be overridden by the "typed key" coordinates 212633e4f45330cf32d76c29d999b723ddeafd3a90cJean Chalard // (See {@link #setBatchInputWord}). 213633e4f45330cf32d76c29d999b723ddeafd3a90cJean Chalard if (!mIsBatchMode) { 214633e4f45330cf32d76c29d999b723ddeafd3a90cJean Chalard // TODO: Set correct pointer id and time 215633e4f45330cf32d76c29d999b723ddeafd3a90cJean Chalard mInputPointers.addPointerAt(newIndex, keyX, keyY, 0, 0); 216633e4f45330cf32d76c29d999b723ddeafd3a90cJean Chalard } 217633e4f45330cf32d76c29d999b723ddeafd3a90cJean Chalard } 218367c199de16f7ce8e608bdf38bf35df8995e18a0Jean Chalard if (0 == newIndex) { 219367c199de16f7ce8e608bdf38bf35df8995e18a0Jean Chalard mIsOnlyFirstCharCapitalized = Character.isUpperCase(primaryCode); 220367c199de16f7ce8e608bdf38bf35df8995e18a0Jean Chalard } else { 221367c199de16f7ce8e608bdf38bf35df8995e18a0Jean Chalard mIsOnlyFirstCharCapitalized = mIsOnlyFirstCharCapitalized 222367c199de16f7ce8e608bdf38bf35df8995e18a0Jean Chalard && !Character.isUpperCase(primaryCode); 223367c199de16f7ce8e608bdf38bf35df8995e18a0Jean Chalard } 224633e4f45330cf32d76c29d999b723ddeafd3a90cJean Chalard if (Character.isUpperCase(primaryCode)) mCapsCount++; 225633e4f45330cf32d76c29d999b723ddeafd3a90cJean Chalard if (Character.isDigit(primaryCode)) mDigitsCount++; 2263e160bbe6b91c2d50a410ebd28e10f3e58b2c73aJean Chalard } 227dfaeb125eb27172e4d38e1e5a87a13a3320c1e82Jean Chalard mAutoCorrection = null; 2280f913ff5ba71c40a4492994a23010336cd25be8eJean Chalard } 2290f913ff5ba71c40a4492994a23010336cd25be8eJean Chalard 2306a114fa700d3ca73c608e1291b74bbbdd5a1a7b7Jean Chalard public void setCursorPositionWithinWord(final int posWithinWord) { 2316a114fa700d3ca73c608e1291b74bbbdd5a1a7b7Jean Chalard mCursorPositionWithinWord = posWithinWord; 232f8accd8839d291f10b218e64aa6b8eb154c92c4cJean Chalard // TODO: compute where that puts us inside the events 2336a114fa700d3ca73c608e1291b74bbbdd5a1a7b7Jean Chalard } 2346a114fa700d3ca73c608e1291b74bbbdd5a1a7b7Jean Chalard 2350e9ee4d3bf75459560670ca5c28ff4c4f7c346fbJean Chalard public boolean isCursorFrontOrMiddleOfComposingWord() { 2360e9ee4d3bf75459560670ca5c28ff4c4f7c346fbJean Chalard if (DBG && mCursorPositionWithinWord > mCodePointSize) { 2370e9ee4d3bf75459560670ca5c28ff4c4f7c346fbJean Chalard throw new RuntimeException("Wrong cursor position : " + mCursorPositionWithinWord 2380e9ee4d3bf75459560670ca5c28ff4c4f7c346fbJean Chalard + "in a word of size " + mCodePointSize); 2390e9ee4d3bf75459560670ca5c28ff4c4f7c346fbJean Chalard } 2400e9ee4d3bf75459560670ca5c28ff4c4f7c346fbJean Chalard return mCursorPositionWithinWord != mCodePointSize; 2416a114fa700d3ca73c608e1291b74bbbdd5a1a7b7Jean Chalard } 2426a114fa700d3ca73c608e1291b74bbbdd5a1a7b7Jean Chalard 243f0af452ce261590b5978a1bb679ce27b71f9dc70Jean Chalard /** 244f0af452ce261590b5978a1bb679ce27b71f9dc70Jean Chalard * When the cursor is moved by the user, we need to update its position. 245f0af452ce261590b5978a1bb679ce27b71f9dc70Jean Chalard * If it falls inside the currently composing word, we don't reset the composition, and 246f0af452ce261590b5978a1bb679ce27b71f9dc70Jean Chalard * only update the cursor position. 247f0af452ce261590b5978a1bb679ce27b71f9dc70Jean Chalard * 248f0af452ce261590b5978a1bb679ce27b71f9dc70Jean Chalard * @param expectedMoveAmount How many java chars to move the cursor. Negative values move 249f0af452ce261590b5978a1bb679ce27b71f9dc70Jean Chalard * the cursor backward, positive values move the cursor forward. 250f0af452ce261590b5978a1bb679ce27b71f9dc70Jean Chalard * @return true if the cursor is still inside the composing word, false otherwise. 251f0af452ce261590b5978a1bb679ce27b71f9dc70Jean Chalard */ 252f0af452ce261590b5978a1bb679ce27b71f9dc70Jean Chalard public boolean moveCursorByAndReturnIfInsideComposingWord(final int expectedMoveAmount) { 253cbed462d192d0c5af9614f5f997b2768f3d0eb56Jean Chalard // TODO: should uncommit the composing feedback 254cbed462d192d0c5af9614f5f997b2768f3d0eb56Jean Chalard mCombinerChain.reset(); 255f0af452ce261590b5978a1bb679ce27b71f9dc70Jean Chalard int actualMoveAmountWithinWord = 0; 256f0af452ce261590b5978a1bb679ce27b71f9dc70Jean Chalard int cursorPos = mCursorPositionWithinWord; 2571ef9d5938e671ce7a9d5c29d95c1364d6d6249eaJean Chalard // TODO: Don't make that copy. We can do this directly from mTypedWordCache. 2581ef9d5938e671ce7a9d5c29d95c1364d6d6249eaJean Chalard final int[] codePoints = StringUtils.toCodePointArray(mTypedWordCache); 259f0af452ce261590b5978a1bb679ce27b71f9dc70Jean Chalard if (expectedMoveAmount >= 0) { 260f0af452ce261590b5978a1bb679ce27b71f9dc70Jean Chalard // Moving the cursor forward for the expected amount or until the end of the word has 261f0af452ce261590b5978a1bb679ce27b71f9dc70Jean Chalard // been reached, whichever comes first. 262f0af452ce261590b5978a1bb679ce27b71f9dc70Jean Chalard while (actualMoveAmountWithinWord < expectedMoveAmount && cursorPos < mCodePointSize) { 2635fa2202e36a84bd5808fa10ca25c9179acb1b173Jean Chalard actualMoveAmountWithinWord += Character.charCount(codePoints[cursorPos]); 264f0af452ce261590b5978a1bb679ce27b71f9dc70Jean Chalard ++cursorPos; 265f0af452ce261590b5978a1bb679ce27b71f9dc70Jean Chalard } 266f0af452ce261590b5978a1bb679ce27b71f9dc70Jean Chalard } else { 267f0af452ce261590b5978a1bb679ce27b71f9dc70Jean Chalard // Moving the cursor backward for the expected amount or until the start of the word 268f0af452ce261590b5978a1bb679ce27b71f9dc70Jean Chalard // has been reached, whichever comes first. 269f0af452ce261590b5978a1bb679ce27b71f9dc70Jean Chalard while (actualMoveAmountWithinWord > expectedMoveAmount && cursorPos > 0) { 270f0af452ce261590b5978a1bb679ce27b71f9dc70Jean Chalard --cursorPos; 2715fa2202e36a84bd5808fa10ca25c9179acb1b173Jean Chalard actualMoveAmountWithinWord -= Character.charCount(codePoints[cursorPos]); 272f0af452ce261590b5978a1bb679ce27b71f9dc70Jean Chalard } 273f0af452ce261590b5978a1bb679ce27b71f9dc70Jean Chalard } 274f0af452ce261590b5978a1bb679ce27b71f9dc70Jean Chalard // If the actual and expected amounts differ, we crossed the start or the end of the word 275f0af452ce261590b5978a1bb679ce27b71f9dc70Jean Chalard // so the result would not be inside the composing word. 276f0af452ce261590b5978a1bb679ce27b71f9dc70Jean Chalard if (actualMoveAmountWithinWord != expectedMoveAmount) return false; 277f0af452ce261590b5978a1bb679ce27b71f9dc70Jean Chalard mCursorPositionWithinWord = cursorPos; 278f0af452ce261590b5978a1bb679ce27b71f9dc70Jean Chalard return true; 279f0af452ce261590b5978a1bb679ce27b71f9dc70Jean Chalard } 280f0af452ce261590b5978a1bb679ce27b71f9dc70Jean Chalard 281bc464e2952e102219f0b977fc1e9140ad5bd03e4Tadashi G. Takaoka public void setBatchInputPointers(final InputPointers batchPointers) { 282eea34598bf63f670f47d7b3f37b6436921e5fe02Tom Ouyang mInputPointers.set(batchPointers); 283d82dcdc9246b340c4b355e34efc6079f3278efa6Tadashi G. Takaoka mIsBatchMode = true; 284d82dcdc9246b340c4b355e34efc6079f3278efa6Tadashi G. Takaoka } 285d82dcdc9246b340c4b355e34efc6079f3278efa6Tadashi G. Takaoka 286bc464e2952e102219f0b977fc1e9140ad5bd03e4Tadashi G. Takaoka public void setBatchInputWord(final String word) { 287eea34598bf63f670f47d7b3f37b6436921e5fe02Tom Ouyang reset(); 288eea34598bf63f670f47d7b3f37b6436921e5fe02Tom Ouyang mIsBatchMode = true; 289eea34598bf63f670f47d7b3f37b6436921e5fe02Tom Ouyang final int length = word.length(); 290eea34598bf63f670f47d7b3f37b6436921e5fe02Tom Ouyang for (int i = 0; i < length; i = Character.offsetByCodePoints(word, i, 1)) { 291eea34598bf63f670f47d7b3f37b6436921e5fe02Tom Ouyang final int codePoint = Character.codePointAt(word, i); 292eea34598bf63f670f47d7b3f37b6436921e5fe02Tom Ouyang // We don't want to override the batch input points that are held in mInputPointers 293eea34598bf63f670f47d7b3f37b6436921e5fe02Tom Ouyang // (See {@link #add(int,int,int)}). 2947196566d4f2048a4160acc6271ccb26c73d6fcd6Jean Chalard final Event processedEvent = 2957196566d4f2048a4160acc6271ccb26c73d6fcd6Jean Chalard processEvent(Event.createEventForCodePointFromUnknownSource(codePoint)); 2967196566d4f2048a4160acc6271ccb26c73d6fcd6Jean Chalard applyProcessedEvent(processedEvent); 297eea34598bf63f670f47d7b3f37b6436921e5fe02Tom Ouyang } 298eea34598bf63f670f47d7b3f37b6436921e5fe02Tom Ouyang } 299eea34598bf63f670f47d7b3f37b6436921e5fe02Tom Ouyang 300923bf41f853a544fd0d71fbf7dc90359ec35981The Android Open Source Project /** 3016b1f500da451de56932a8b2a99c63857994ece85Jean Chalard * Set the currently composing word to the one passed as an argument. 3026b1f500da451de56932a8b2a99c63857994ece85Jean Chalard * This will register NOT_A_COORDINATE for X and Ys, and use the passed keyboard for proximity. 303d1f463eacfaac31a999f7eb1ecaa1668ed3038d4Jean Chalard * @param codePoints the code points to set as the composing word. 304d1f463eacfaac31a999f7eb1ecaa1668ed3038d4Jean Chalard * @param coordinates the x, y coordinates of the key in the CoordinateUtils format 3056b1f500da451de56932a8b2a99c63857994ece85Jean Chalard */ 306367c199de16f7ce8e608bdf38bf35df8995e18a0Jean Chalard public void setComposingWord(final int[] codePoints, final int[] coordinates) { 3076b1f500da451de56932a8b2a99c63857994ece85Jean Chalard reset(); 308d1f463eacfaac31a999f7eb1ecaa1668ed3038d4Jean Chalard final int length = codePoints.length; 309d1f463eacfaac31a999f7eb1ecaa1668ed3038d4Jean Chalard for (int i = 0; i < length; ++i) { 3107196566d4f2048a4160acc6271ccb26c73d6fcd6Jean Chalard final Event processedEvent = 3117196566d4f2048a4160acc6271ccb26c73d6fcd6Jean Chalard processEvent(Event.createEventForCodePointFromAlreadyTypedText(codePoints[i], 312f8accd8839d291f10b218e64aa6b8eb154c92c4cJean Chalard CoordinateUtils.xFromArray(coordinates, i), 313f8accd8839d291f10b218e64aa6b8eb154c92c4cJean Chalard CoordinateUtils.yFromArray(coordinates, i))); 3147196566d4f2048a4160acc6271ccb26c73d6fcd6Jean Chalard applyProcessedEvent(processedEvent); 3156b1f500da451de56932a8b2a99c63857994ece85Jean Chalard } 3164b5b46bb66bf74ef5edd65c55e186b02f3c56e5dJean Chalard mIsResumed = true; 3176b1f500da451de56932a8b2a99c63857994ece85Jean Chalard } 3186b1f500da451de56932a8b2a99c63857994ece85Jean Chalard 3196b1f500da451de56932a8b2a99c63857994ece85Jean Chalard /** 320923bf41f853a544fd0d71fbf7dc90359ec35981The Android Open Source Project * Returns the word as it was typed, without any correction applied. 321117fc93f373cb86d4120c1261f9d0562c6529fecJean Chalard * @return the word that was typed so far. Never returns null. 322923bf41f853a544fd0d71fbf7dc90359ec35981The Android Open Source Project */ 3235c08151c227d98031abe27c3f0a8f43a7126ae9dJean Chalard public String getTypedWord() { 3243285b68c97d966d86c08aeb837e5bf5633981357Jean Chalard return mTypedWordCache.toString(); 325923bf41f853a544fd0d71fbf7dc90359ec35981The Android Open Source Project } 326923bf41f853a544fd0d71fbf7dc90359ec35981The Android Open Source Project 327923bf41f853a544fd0d71fbf7dc90359ec35981The Android Open Source Project /** 328deccc23564304b11d58590041f25adffdf6e1b6aJean Chalard * Whether this composer is composing or about to compose a word in which only the first letter 329deccc23564304b11d58590041f25adffdf6e1b6aJean Chalard * is a capital. 330deccc23564304b11d58590041f25adffdf6e1b6aJean Chalard * 331deccc23564304b11d58590041f25adffdf6e1b6aJean Chalard * If we do have a composing word, we just return whether the word has indeed only its first 332deccc23564304b11d58590041f25adffdf6e1b6aJean Chalard * character capitalized. If we don't, then we return a value based on the capitalized mode, 333deccc23564304b11d58590041f25adffdf6e1b6aJean Chalard * which tell us what is likely to happen for the next composing word. 334deccc23564304b11d58590041f25adffdf6e1b6aJean Chalard * 335923bf41f853a544fd0d71fbf7dc90359ec35981The Android Open Source Project * @return capitalization preference 336923bf41f853a544fd0d71fbf7dc90359ec35981The Android Open Source Project */ 337deccc23564304b11d58590041f25adffdf6e1b6aJean Chalard public boolean isOrWillBeOnlyFirstCharCapitalized() { 338deccc23564304b11d58590041f25adffdf6e1b6aJean Chalard return isComposingWord() ? mIsOnlyFirstCharCapitalized 339deccc23564304b11d58590041f25adffdf6e1b6aJean Chalard : (CAPS_MODE_OFF != mCapitalizedMode); 340923bf41f853a544fd0d71fbf7dc90359ec35981The Android Open Source Project } 3410b4ae1f578e768eec4ada90aeb81d11acb10eb2eKen Wakasa 3420b4ae1f578e768eec4ada90aeb81d11acb10eb2eKen Wakasa /** 3430b4ae1f578e768eec4ada90aeb81d11acb10eb2eKen Wakasa * Whether or not all of the user typed chars are upper case 3440b4ae1f578e768eec4ada90aeb81d11acb10eb2eKen Wakasa * @return true if all user typed chars are upper case, false otherwise 3450b4ae1f578e768eec4ada90aeb81d11acb10eb2eKen Wakasa */ 3460b4ae1f578e768eec4ada90aeb81d11acb10eb2eKen Wakasa public boolean isAllUpperCase() { 347ad0642cf258ca9b123f74ca0ae8bf970792908f1Jean Chalard if (size() <= 1) { 348ad0642cf258ca9b123f74ca0ae8bf970792908f1Jean Chalard return mCapitalizedMode == CAPS_MODE_AUTO_SHIFT_LOCKED 349ad0642cf258ca9b123f74ca0ae8bf970792908f1Jean Chalard || mCapitalizedMode == CAPS_MODE_MANUAL_SHIFT_LOCKED; 350ad0642cf258ca9b123f74ca0ae8bf970792908f1Jean Chalard } else { 351ad0642cf258ca9b123f74ca0ae8bf970792908f1Jean Chalard return mCapsCount == size(); 352ad0642cf258ca9b123f74ca0ae8bf970792908f1Jean Chalard } 3531eba97d92fb5caa4f23425837b6680ccc2a23ae8Jean Chalard } 3541eba97d92fb5caa4f23425837b6680ccc2a23ae8Jean Chalard 3551eba97d92fb5caa4f23425837b6680ccc2a23ae8Jean Chalard public boolean wasShiftedNoLock() { 3561eba97d92fb5caa4f23425837b6680ccc2a23ae8Jean Chalard return mCapitalizedMode == CAPS_MODE_AUTO_SHIFTED 3571eba97d92fb5caa4f23425837b6680ccc2a23ae8Jean Chalard || mCapitalizedMode == CAPS_MODE_MANUAL_SHIFTED; 3580b4ae1f578e768eec4ada90aeb81d11acb10eb2eKen Wakasa } 3590b4ae1f578e768eec4ada90aeb81d11acb10eb2eKen Wakasa 360923bf41f853a544fd0d71fbf7dc90359ec35981The Android Open Source Project /** 3614a7ff90d513f8b6cbf39688c08be0828a57e311bAmith Yamasani * Returns true if more than one character is upper case, otherwise returns false. 3624a7ff90d513f8b6cbf39688c08be0828a57e311bAmith Yamasani */ 3634a7ff90d513f8b6cbf39688c08be0828a57e311bAmith Yamasani public boolean isMostlyCaps() { 3644a7ff90d513f8b6cbf39688c08be0828a57e311bAmith Yamasani return mCapsCount > 1; 3654a7ff90d513f8b6cbf39688c08be0828a57e311bAmith Yamasani } 3661c551251106e506c70fad7ba0cb8b1e2a7dff3a9Amith Yamasani 3670fd625bcfdfac1c10e7bd7f9088bf425fec08989Jean Chalard /** 368e7c471a52f38c48cd38e412d88901bddb6f903a9Jean Chalard * Returns true if we have digits in the composing word. 369e7c471a52f38c48cd38e412d88901bddb6f903a9Jean Chalard */ 370e7c471a52f38c48cd38e412d88901bddb6f903a9Jean Chalard public boolean hasDigits() { 371e7c471a52f38c48cd38e412d88901bddb6f903a9Jean Chalard return mDigitsCount > 0; 372e7c471a52f38c48cd38e412d88901bddb6f903a9Jean Chalard } 373e7c471a52f38c48cd38e412d88901bddb6f903a9Jean Chalard 374e7c471a52f38c48cd38e412d88901bddb6f903a9Jean Chalard /** 375367c199de16f7ce8e608bdf38bf35df8995e18a0Jean Chalard * Saves the caps mode at the start of composing. 376adbd9ae105e06287b59379d7f7127d95fd0663f4Jean Chalard * 3772fa3693c264a4c150ac307d9bb7f6f8f18cc4ffcKen Wakasa * WordComposer needs to know about the caps mode for several reasons. The first is, we need 3782fa3693c264a4c150ac307d9bb7f6f8f18cc4ffcKen Wakasa * to know after the fact what the reason was, to register the correct form into the user 3792fa3693c264a4c150ac307d9bb7f6f8f18cc4ffcKen Wakasa * history dictionary: if the word was automatically capitalized, we should insert it in 3802fa3693c264a4c150ac307d9bb7f6f8f18cc4ffcKen Wakasa * all-lower case but if it's a manual pressing of shift, then it should be inserted as is. 381adbd9ae105e06287b59379d7f7127d95fd0663f4Jean Chalard * Also, batch input needs to know about the current caps mode to display correctly 382adbd9ae105e06287b59379d7f7127d95fd0663f4Jean Chalard * capitalized suggestions. 383adbd9ae105e06287b59379d7f7127d95fd0663f4Jean Chalard * @param mode the mode at the time of start 3841c551251106e506c70fad7ba0cb8b1e2a7dff3a9Amith Yamasani */ 385367c199de16f7ce8e608bdf38bf35df8995e18a0Jean Chalard public void setCapitalizedModeAtStartComposingTime(final int mode) { 386adbd9ae105e06287b59379d7f7127d95fd0663f4Jean Chalard mCapitalizedMode = mode; 3871c551251106e506c70fad7ba0cb8b1e2a7dff3a9Amith Yamasani } 3881c551251106e506c70fad7ba0cb8b1e2a7dff3a9Amith Yamasani 3891c551251106e506c70fad7ba0cb8b1e2a7dff3a9Amith Yamasani /** 390deccc23564304b11d58590041f25adffdf6e1b6aJean Chalard * Before fetching suggestions, we don't necessarily know about the capitalized mode yet. 391deccc23564304b11d58590041f25adffdf6e1b6aJean Chalard * 392deccc23564304b11d58590041f25adffdf6e1b6aJean Chalard * If we don't have a composing word yet, we take a note of this mode so that we can then 393deccc23564304b11d58590041f25adffdf6e1b6aJean Chalard * supply this information to the suggestion process. If we have a composing word, then 394deccc23564304b11d58590041f25adffdf6e1b6aJean Chalard * the previous mode has priority over this. 395deccc23564304b11d58590041f25adffdf6e1b6aJean Chalard * @param mode the mode just before fetching suggestions 396deccc23564304b11d58590041f25adffdf6e1b6aJean Chalard */ 397deccc23564304b11d58590041f25adffdf6e1b6aJean Chalard public void adviseCapitalizedModeBeforeFetchingSuggestions(final int mode) { 398deccc23564304b11d58590041f25adffdf6e1b6aJean Chalard if (!isComposingWord()) { 399deccc23564304b11d58590041f25adffdf6e1b6aJean Chalard mCapitalizedMode = mode; 400deccc23564304b11d58590041f25adffdf6e1b6aJean Chalard } 401deccc23564304b11d58590041f25adffdf6e1b6aJean Chalard } 402deccc23564304b11d58590041f25adffdf6e1b6aJean Chalard 403deccc23564304b11d58590041f25adffdf6e1b6aJean Chalard /** 4041c551251106e506c70fad7ba0cb8b1e2a7dff3a9Amith Yamasani * Returns whether the word was automatically capitalized. 4051c551251106e506c70fad7ba0cb8b1e2a7dff3a9Amith Yamasani * @return whether the word was automatically capitalized 4061c551251106e506c70fad7ba0cb8b1e2a7dff3a9Amith Yamasani */ 407adbd9ae105e06287b59379d7f7127d95fd0663f4Jean Chalard public boolean wasAutoCapitalized() { 408adbd9ae105e06287b59379d7f7127d95fd0663f4Jean Chalard return mCapitalizedMode == CAPS_MODE_AUTO_SHIFT_LOCKED 409adbd9ae105e06287b59379d7f7127d95fd0663f4Jean Chalard || mCapitalizedMode == CAPS_MODE_AUTO_SHIFTED; 4101c551251106e506c70fad7ba0cb8b1e2a7dff3a9Amith Yamasani } 411117fc93f373cb86d4120c1261f9d0562c6529fecJean Chalard 412117fc93f373cb86d4120c1261f9d0562c6529fecJean Chalard /** 413117fc93f373cb86d4120c1261f9d0562c6529fecJean Chalard * Sets the auto-correction for this word. 414117fc93f373cb86d4120c1261f9d0562c6529fecJean Chalard */ 415bc464e2952e102219f0b977fc1e9140ad5bd03e4Tadashi G. Takaoka public void setAutoCorrection(final String correction) { 416be79227dc99421ff7be62224c51c553b3fa73777Jean Chalard mAutoCorrection = correction; 417117fc93f373cb86d4120c1261f9d0562c6529fecJean Chalard } 418117fc93f373cb86d4120c1261f9d0562c6529fecJean Chalard 419117fc93f373cb86d4120c1261f9d0562c6529fecJean Chalard /** 420f7d6517d6b1a1dd88e2142e1a15703bb839be01bJean Chalard * @return the auto-correction for this word, or null if none. 421117fc93f373cb86d4120c1261f9d0562c6529fecJean Chalard */ 422bc464e2952e102219f0b977fc1e9140ad5bd03e4Tadashi G. Takaoka public String getAutoCorrectionOrNull() { 423be79227dc99421ff7be62224c51c553b3fa73777Jean Chalard return mAutoCorrection; 424117fc93f373cb86d4120c1261f9d0562c6529fecJean Chalard } 425c73c26790fa9dcd836a918774d6efa39a05c0152Jean Chalard 4264b5b46bb66bf74ef5edd65c55e186b02f3c56e5dJean Chalard /** 4274b5b46bb66bf74ef5edd65c55e186b02f3c56e5dJean Chalard * @return whether we started composing this word by resuming suggestion on an existing string 4284b5b46bb66bf74ef5edd65c55e186b02f3c56e5dJean Chalard */ 4294b5b46bb66bf74ef5edd65c55e186b02f3c56e5dJean Chalard public boolean isResumed() { 4304b5b46bb66bf74ef5edd65c55e186b02f3c56e5dJean Chalard return mIsResumed; 4314b5b46bb66bf74ef5edd65c55e186b02f3c56e5dJean Chalard } 4324b5b46bb66bf74ef5edd65c55e186b02f3c56e5dJean Chalard 433267563d1bb4d8091293fbd8774f0f95ef59f03c4Jean Chalard // `type' should be one of the LastComposedWord.COMMIT_TYPE_* constants above. 4344752b68f5a62ede099677bdea0514ba1d5082606Jean Chalard // committedWord should contain suggestion spans if applicable. 4354752b68f5a62ede099677bdea0514ba1d5082606Jean Chalard public LastComposedWord commitWord(final int type, final CharSequence committedWord, 436e507d92aa3ee4ae43124c5452f20aa8ed0ecef4cKeisuke Kuroyanagi final String separatorString, final PrevWordsInfo prevWordsInfo) { 4379271b770e81350e232c351f76f9f7a2ec23dff5fJean Chalard // Note: currently, we come here whenever we commit a word. If it's a MANUAL_PICK 4389271b770e81350e232c351f76f9f7a2ec23dff5fJean Chalard // or a DECIDED_WORD we may cancel the commit later; otherwise, we should deactivate 4399271b770e81350e232c351f76f9f7a2ec23dff5fJean Chalard // the last composed word to ensure this does not happen. 4401ef9d5938e671ce7a9d5c29d95c1364d6d6249eaJean Chalard final LastComposedWord lastComposedWord = new LastComposedWord(mEvents, 4413285b68c97d966d86c08aeb837e5bf5633981357Jean Chalard mInputPointers, mTypedWordCache.toString(), committedWord, separatorString, 442e507d92aa3ee4ae43124c5452f20aa8ed0ecef4cKeisuke Kuroyanagi prevWordsInfo, mCapitalizedMode); 44371538b08e4e08d556f700ad344562ca2c7b74d82Satoshi Kataoka mInputPointers.reset(); 4449271b770e81350e232c351f76f9f7a2ec23dff5fJean Chalard if (type != LastComposedWord.COMMIT_TYPE_DECIDED_WORD 4459271b770e81350e232c351f76f9f7a2ec23dff5fJean Chalard && type != LastComposedWord.COMMIT_TYPE_MANUAL_PICK) { 446449415c72f437f523a49a9ccfcde8a3c0f583a18Jean Chalard lastComposedWord.deactivate(); 447449415c72f437f523a49a9ccfcde8a3c0f583a18Jean Chalard } 448e9808694fecbf7be776cd5cf8ec0333e158286b1Jean Chalard mCapsCount = 0; 449e7c471a52f38c48cd38e412d88901bddb6f903a9Jean Chalard mDigitsCount = 0; 450e9808694fecbf7be776cd5cf8ec0333e158286b1Jean Chalard mIsBatchMode = false; 451cbed462d192d0c5af9614f5f997b2768f3d0eb56Jean Chalard mCombinerChain.reset(); 452f8accd8839d291f10b218e64aa6b8eb154c92c4cJean Chalard mEvents.clear(); 4538914555776a4d3dfd6afc4926a69169ca1c82a0eJean Chalard mCodePointSize = 0; 454367c199de16f7ce8e608bdf38bf35df8995e18a0Jean Chalard mIsOnlyFirstCharCapitalized = false; 4558914555776a4d3dfd6afc4926a69169ca1c82a0eJean Chalard mCapitalizedMode = CAPS_MODE_OFF; 4563285b68c97d966d86c08aeb837e5bf5633981357Jean Chalard refreshTypedWordCache(); 457be79227dc99421ff7be62224c51c553b3fa73777Jean Chalard mAutoCorrection = null; 4586a114fa700d3ca73c608e1291b74bbbdd5a1a7b7Jean Chalard mCursorPositionWithinWord = 0; 4594b5b46bb66bf74ef5edd65c55e186b02f3c56e5dJean Chalard mIsResumed = false; 460d40f3f6bc1bcf07800fbee0468fe90d307ca28bbJean Chalard mRejectedBatchModeSuggestion = null; 4611f8fc62ccb5018716457dc309ab11ad3e1506ad1Jean Chalard return lastComposedWord; 462c73c26790fa9dcd836a918774d6efa39a05c0152Jean Chalard } 463fae1ba767ca177510adc08b363987f67bbf40d90Jean Chalard 464367c199de16f7ce8e608bdf38bf35df8995e18a0Jean Chalard public void resumeSuggestionOnLastComposedWord(final LastComposedWord lastComposedWord) { 465f8accd8839d291f10b218e64aa6b8eb154c92c4cJean Chalard mEvents.clear(); 466f8accd8839d291f10b218e64aa6b8eb154c92c4cJean Chalard Collections.copy(mEvents, lastComposedWord.mEvents); 46771538b08e4e08d556f700ad344562ca2c7b74d82Satoshi Kataoka mInputPointers.set(lastComposedWord.mInputPointers); 468cbed462d192d0c5af9614f5f997b2768f3d0eb56Jean Chalard mCombinerChain.reset(); 4693285b68c97d966d86c08aeb837e5bf5633981357Jean Chalard refreshTypedWordCache(); 470b6b7f5e39e9ea1bf9a05203c536327a6be7e7214Jean Chalard mCapitalizedMode = lastComposedWord.mCapitalizedMode; 471cf9d92629cae88273805eaf7984fcfdd8afd11f5Jean Chalard mAutoCorrection = null; // This will be filled by the next call to updateSuggestion. 4726a114fa700d3ca73c608e1291b74bbbdd5a1a7b7Jean Chalard mCursorPositionWithinWord = mCodePointSize; 473d40f3f6bc1bcf07800fbee0468fe90d307ca28bbJean Chalard mRejectedBatchModeSuggestion = null; 4744b5b46bb66bf74ef5edd65c55e186b02f3c56e5dJean Chalard mIsResumed = true; 4759e8761c4402ddc11c942ed2e583bd7d58f70c5eaJean Chalard } 476d82dcdc9246b340c4b355e34efc6079f3278efa6Tadashi G. Takaoka 477d82dcdc9246b340c4b355e34efc6079f3278efa6Tadashi G. Takaoka public boolean isBatchMode() { 478d82dcdc9246b340c4b355e34efc6079f3278efa6Tadashi G. Takaoka return mIsBatchMode; 479d82dcdc9246b340c4b355e34efc6079f3278efa6Tadashi G. Takaoka } 480d40f3f6bc1bcf07800fbee0468fe90d307ca28bbJean Chalard 481d40f3f6bc1bcf07800fbee0468fe90d307ca28bbJean Chalard public void setRejectedBatchModeSuggestion(final String rejectedSuggestion) { 482d40f3f6bc1bcf07800fbee0468fe90d307ca28bbJean Chalard mRejectedBatchModeSuggestion = rejectedSuggestion; 483d40f3f6bc1bcf07800fbee0468fe90d307ca28bbJean Chalard } 484d40f3f6bc1bcf07800fbee0468fe90d307ca28bbJean Chalard 485d40f3f6bc1bcf07800fbee0468fe90d307ca28bbJean Chalard public String getRejectedBatchModeSuggestion() { 486d40f3f6bc1bcf07800fbee0468fe90d307ca28bbJean Chalard return mRejectedBatchModeSuggestion; 487d40f3f6bc1bcf07800fbee0468fe90d307ca28bbJean Chalard } 488923bf41f853a544fd0d71fbf7dc90359ec35981The Android Open Source Project} 489