Editor.java revision 1d263b8a38cd2468ff271aef83b15f9d74490625
1/*
2 * Copyright (C) 2012 The Android Open Source Project
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 *      http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16
17package android.widget;
18
19import android.R;
20import android.annotation.IntDef;
21import android.annotation.NonNull;
22import android.annotation.Nullable;
23import android.app.PendingIntent;
24import android.app.PendingIntent.CanceledException;
25import android.content.ClipData;
26import android.content.ClipData.Item;
27import android.content.Context;
28import android.content.Intent;
29import android.content.UndoManager;
30import android.content.UndoOperation;
31import android.content.UndoOwner;
32import android.content.pm.PackageManager;
33import android.content.pm.ResolveInfo;
34import android.content.res.TypedArray;
35import android.graphics.Canvas;
36import android.graphics.Color;
37import android.graphics.Matrix;
38import android.graphics.Paint;
39import android.graphics.Path;
40import android.graphics.Rect;
41import android.graphics.RectF;
42import android.graphics.drawable.ColorDrawable;
43import android.graphics.drawable.Drawable;
44import android.metrics.LogMaker;
45import android.os.Bundle;
46import android.os.LocaleList;
47import android.os.Parcel;
48import android.os.Parcelable;
49import android.os.ParcelableParcel;
50import android.os.SystemClock;
51import android.provider.Settings;
52import android.text.DynamicLayout;
53import android.text.Editable;
54import android.text.InputFilter;
55import android.text.InputType;
56import android.text.Layout;
57import android.text.ParcelableSpan;
58import android.text.Selection;
59import android.text.SpanWatcher;
60import android.text.Spannable;
61import android.text.SpannableStringBuilder;
62import android.text.Spanned;
63import android.text.StaticLayout;
64import android.text.TextUtils;
65import android.text.method.KeyListener;
66import android.text.method.MetaKeyKeyListener;
67import android.text.method.MovementMethod;
68import android.text.method.WordIterator;
69import android.text.style.EasyEditSpan;
70import android.text.style.SuggestionRangeSpan;
71import android.text.style.SuggestionSpan;
72import android.text.style.TextAppearanceSpan;
73import android.text.style.URLSpan;
74import android.util.ArraySet;
75import android.util.DisplayMetrics;
76import android.util.Log;
77import android.util.SparseArray;
78import android.view.ActionMode;
79import android.view.ActionMode.Callback;
80import android.view.ContextMenu;
81import android.view.ContextThemeWrapper;
82import android.view.DisplayListCanvas;
83import android.view.DragAndDropPermissions;
84import android.view.DragEvent;
85import android.view.Gravity;
86import android.view.HapticFeedbackConstants;
87import android.view.InputDevice;
88import android.view.LayoutInflater;
89import android.view.Menu;
90import android.view.MenuItem;
91import android.view.MotionEvent;
92import android.view.RenderNode;
93import android.view.SubMenu;
94import android.view.View;
95import android.view.View.DragShadowBuilder;
96import android.view.View.OnClickListener;
97import android.view.ViewConfiguration;
98import android.view.ViewGroup;
99import android.view.ViewGroup.LayoutParams;
100import android.view.ViewTreeObserver;
101import android.view.WindowManager;
102import android.view.accessibility.AccessibilityNodeInfo;
103import android.view.inputmethod.CorrectionInfo;
104import android.view.inputmethod.CursorAnchorInfo;
105import android.view.inputmethod.EditorInfo;
106import android.view.inputmethod.ExtractedText;
107import android.view.inputmethod.ExtractedTextRequest;
108import android.view.inputmethod.InputConnection;
109import android.view.inputmethod.InputMethodManager;
110import android.view.textclassifier.TextClassification;
111import android.widget.AdapterView.OnItemClickListener;
112import android.widget.TextView.Drawables;
113import android.widget.TextView.OnEditorActionListener;
114
115import com.android.internal.annotations.VisibleForTesting;
116import com.android.internal.logging.MetricsLogger;
117import com.android.internal.logging.nano.MetricsProto.MetricsEvent;
118import com.android.internal.util.ArrayUtils;
119import com.android.internal.util.GrowingArrayUtils;
120import com.android.internal.util.Preconditions;
121import com.android.internal.widget.EditableInputConnection;
122
123import java.lang.annotation.Retention;
124import java.lang.annotation.RetentionPolicy;
125import java.text.BreakIterator;
126import java.util.ArrayList;
127import java.util.Arrays;
128import java.util.Comparator;
129import java.util.HashMap;
130import java.util.List;
131
132
133/**
134 * Helper class used by TextView to handle editable text views.
135 *
136 * @hide
137 */
138public class Editor {
139    private static final String TAG = "Editor";
140    private static final boolean DEBUG_UNDO = false;
141
142    static final int BLINK = 500;
143    private static final int DRAG_SHADOW_MAX_TEXT_LENGTH = 20;
144    private static final float LINE_SLOP_MULTIPLIER_FOR_HANDLEVIEWS = 0.5f;
145    private static final int UNSET_X_VALUE = -1;
146    private static final int UNSET_LINE = -1;
147    // Tag used when the Editor maintains its own separate UndoManager.
148    private static final String UNDO_OWNER_TAG = "Editor";
149
150    // Ordering constants used to place the Action Mode or context menu items in their menu.
151    private static final int MENU_ITEM_ORDER_ASSIST = 0;
152    private static final int MENU_ITEM_ORDER_UNDO = 2;
153    private static final int MENU_ITEM_ORDER_REDO = 3;
154    private static final int MENU_ITEM_ORDER_CUT = 4;
155    private static final int MENU_ITEM_ORDER_COPY = 5;
156    private static final int MENU_ITEM_ORDER_PASTE = 6;
157    private static final int MENU_ITEM_ORDER_SHARE = 7;
158    private static final int MENU_ITEM_ORDER_SELECT_ALL = 8;
159    private static final int MENU_ITEM_ORDER_REPLACE = 9;
160    private static final int MENU_ITEM_ORDER_AUTOFILL = 10;
161    private static final int MENU_ITEM_ORDER_PASTE_AS_PLAIN_TEXT = 11;
162    private static final int MENU_ITEM_ORDER_PROCESS_TEXT_INTENT_ACTIONS_START = 100;
163
164    // Each Editor manages its own undo stack.
165    private final UndoManager mUndoManager = new UndoManager();
166    private UndoOwner mUndoOwner = mUndoManager.getOwner(UNDO_OWNER_TAG, this);
167    final UndoInputFilter mUndoInputFilter = new UndoInputFilter(this);
168    boolean mAllowUndo = true;
169
170    private final MetricsLogger mMetricsLogger = new MetricsLogger();
171
172    // Cursor Controllers.
173    private InsertionPointCursorController mInsertionPointCursorController;
174    SelectionModifierCursorController mSelectionModifierCursorController;
175    // Action mode used when text is selected or when actions on an insertion cursor are triggered.
176    private ActionMode mTextActionMode;
177    private boolean mInsertionControllerEnabled;
178    private boolean mSelectionControllerEnabled;
179
180    private final boolean mHapticTextHandleEnabled;
181
182    // Used to highlight a word when it is corrected by the IME
183    private CorrectionHighlighter mCorrectionHighlighter;
184
185    InputContentType mInputContentType;
186    InputMethodState mInputMethodState;
187
188    private static class TextRenderNode {
189        // Render node has 3 recording states:
190        // 1. Recorded operations are valid.
191        // #needsRecord() returns false, but needsToBeShifted is false.
192        // 2. Recorded operations are not valid, but just the position needed to be updated.
193        // #needsRecord() returns false, but needsToBeShifted is true.
194        // 3. Recorded operations are not valid. Need to record operations. #needsRecord() returns
195        // true.
196        RenderNode renderNode;
197        boolean isDirty;
198        // Becomes true when recorded operations can be reused, but the position has to be updated.
199        boolean needsToBeShifted;
200        public TextRenderNode(String name) {
201            renderNode = RenderNode.create(name, null);
202            isDirty = true;
203            needsToBeShifted = true;
204        }
205        boolean needsRecord() {
206            return isDirty || !renderNode.isValid();
207        }
208    }
209    private TextRenderNode[] mTextRenderNodes;
210
211    boolean mFrozenWithFocus;
212    boolean mSelectionMoved;
213    boolean mTouchFocusSelected;
214
215    KeyListener mKeyListener;
216    int mInputType = EditorInfo.TYPE_NULL;
217
218    boolean mDiscardNextActionUp;
219    boolean mIgnoreActionUpEvent;
220
221    long mShowCursor;
222    private Blink mBlink;
223
224    boolean mCursorVisible = true;
225    boolean mSelectAllOnFocus;
226    boolean mTextIsSelectable;
227
228    CharSequence mError;
229    boolean mErrorWasChanged;
230    private ErrorPopup mErrorPopup;
231
232    /**
233     * This flag is set if the TextView tries to display an error before it
234     * is attached to the window (so its position is still unknown).
235     * It causes the error to be shown later, when onAttachedToWindow()
236     * is called.
237     */
238    private boolean mShowErrorAfterAttach;
239
240    boolean mInBatchEditControllers;
241    boolean mShowSoftInputOnFocus = true;
242    private boolean mPreserveSelection;
243    private boolean mRestartActionModeOnNextRefresh;
244
245    private SelectionActionModeHelper mSelectionActionModeHelper;
246
247    boolean mIsBeingLongClicked;
248
249    private SuggestionsPopupWindow mSuggestionsPopupWindow;
250    SuggestionRangeSpan mSuggestionRangeSpan;
251    private Runnable mShowSuggestionRunnable;
252
253    final Drawable[] mCursorDrawable = new Drawable[2];
254    int mCursorCount; // Current number of used mCursorDrawable: 0 (resource=0), 1 or 2 (split)
255
256    private Drawable mSelectHandleLeft;
257    private Drawable mSelectHandleRight;
258    private Drawable mSelectHandleCenter;
259
260    // Global listener that detects changes in the global position of the TextView
261    private PositionListener mPositionListener;
262
263    private float mLastDownPositionX, mLastDownPositionY;
264    private float mContextMenuAnchorX, mContextMenuAnchorY;
265    Callback mCustomSelectionActionModeCallback;
266    Callback mCustomInsertionActionModeCallback;
267
268    // Set when this TextView gained focus with some text selected. Will start selection mode.
269    boolean mCreatedWithASelection;
270
271    // Indicates the current tap state (first tap, double tap, or triple click).
272    private int mTapState = TAP_STATE_INITIAL;
273    private long mLastTouchUpTime = 0;
274    private static final int TAP_STATE_INITIAL = 0;
275    private static final int TAP_STATE_FIRST_TAP = 1;
276    private static final int TAP_STATE_DOUBLE_TAP = 2;
277    // Only for mouse input.
278    private static final int TAP_STATE_TRIPLE_CLICK = 3;
279
280    // The button state as of the last time #onTouchEvent is called.
281    private int mLastButtonState;
282
283    private Runnable mInsertionActionModeRunnable;
284
285    // The span controller helps monitoring the changes to which the Editor needs to react:
286    // - EasyEditSpans, for which we have some UI to display on attach and on hide
287    // - SelectionSpans, for which we need to call updateSelection if an IME is attached
288    private SpanController mSpanController;
289
290    private WordIterator mWordIterator;
291    SpellChecker mSpellChecker;
292
293    // This word iterator is set with text and used to determine word boundaries
294    // when a user is selecting text.
295    private WordIterator mWordIteratorWithText;
296    // Indicate that the text in the word iterator needs to be updated.
297    private boolean mUpdateWordIteratorText;
298
299    private Rect mTempRect;
300
301    private final TextView mTextView;
302
303    final ProcessTextIntentActionsHandler mProcessTextIntentActionsHandler;
304
305    private final CursorAnchorInfoNotifier mCursorAnchorInfoNotifier =
306            new CursorAnchorInfoNotifier();
307
308    private final Runnable mShowFloatingToolbar = new Runnable() {
309        @Override
310        public void run() {
311            if (mTextActionMode != null) {
312                mTextActionMode.hide(0);  // hide off.
313            }
314        }
315    };
316
317    boolean mIsInsertionActionModeStartPending = false;
318
319    private final SuggestionHelper mSuggestionHelper = new SuggestionHelper();
320
321    Editor(TextView textView) {
322        mTextView = textView;
323        // Synchronize the filter list, which places the undo input filter at the end.
324        mTextView.setFilters(mTextView.getFilters());
325        mProcessTextIntentActionsHandler = new ProcessTextIntentActionsHandler(this);
326        mHapticTextHandleEnabled = mTextView.getContext().getResources().getBoolean(
327                com.android.internal.R.bool.config_enableHapticTextHandle);
328    }
329
330    ParcelableParcel saveInstanceState() {
331        ParcelableParcel state = new ParcelableParcel(getClass().getClassLoader());
332        Parcel parcel = state.getParcel();
333        mUndoManager.saveInstanceState(parcel);
334        mUndoInputFilter.saveInstanceState(parcel);
335        return state;
336    }
337
338    void restoreInstanceState(ParcelableParcel state) {
339        Parcel parcel = state.getParcel();
340        mUndoManager.restoreInstanceState(parcel, state.getClassLoader());
341        mUndoInputFilter.restoreInstanceState(parcel);
342        // Re-associate this object as the owner of undo state.
343        mUndoOwner = mUndoManager.getOwner(UNDO_OWNER_TAG, this);
344    }
345
346    /**
347     * Forgets all undo and redo operations for this Editor.
348     */
349    void forgetUndoRedo() {
350        UndoOwner[] owners = { mUndoOwner };
351        mUndoManager.forgetUndos(owners, -1 /* all */);
352        mUndoManager.forgetRedos(owners, -1 /* all */);
353    }
354
355    boolean canUndo() {
356        UndoOwner[] owners = { mUndoOwner };
357        return mAllowUndo && mUndoManager.countUndos(owners) > 0;
358    }
359
360    boolean canRedo() {
361        UndoOwner[] owners = { mUndoOwner };
362        return mAllowUndo && mUndoManager.countRedos(owners) > 0;
363    }
364
365    void undo() {
366        if (!mAllowUndo) {
367            return;
368        }
369        UndoOwner[] owners = { mUndoOwner };
370        mUndoManager.undo(owners, 1);  // Undo 1 action.
371    }
372
373    void redo() {
374        if (!mAllowUndo) {
375            return;
376        }
377        UndoOwner[] owners = { mUndoOwner };
378        mUndoManager.redo(owners, 1);  // Redo 1 action.
379    }
380
381    void replace() {
382        if (mSuggestionsPopupWindow == null) {
383            mSuggestionsPopupWindow = new SuggestionsPopupWindow();
384        }
385        hideCursorAndSpanControllers();
386        mSuggestionsPopupWindow.show();
387
388        int middle = (mTextView.getSelectionStart() + mTextView.getSelectionEnd()) / 2;
389        Selection.setSelection((Spannable) mTextView.getText(), middle);
390    }
391
392    void onAttachedToWindow() {
393        if (mShowErrorAfterAttach) {
394            showError();
395            mShowErrorAfterAttach = false;
396        }
397
398        final ViewTreeObserver observer = mTextView.getViewTreeObserver();
399        // No need to create the controller.
400        // The get method will add the listener on controller creation.
401        if (mInsertionPointCursorController != null) {
402            observer.addOnTouchModeChangeListener(mInsertionPointCursorController);
403        }
404        if (mSelectionModifierCursorController != null) {
405            mSelectionModifierCursorController.resetTouchOffsets();
406            observer.addOnTouchModeChangeListener(mSelectionModifierCursorController);
407        }
408        updateSpellCheckSpans(0, mTextView.getText().length(),
409                true /* create the spell checker if needed */);
410
411        if (mTextView.hasSelection()) {
412            refreshTextActionMode();
413        }
414
415        getPositionListener().addSubscriber(mCursorAnchorInfoNotifier, true);
416        resumeBlink();
417    }
418
419    void onDetachedFromWindow() {
420        getPositionListener().removeSubscriber(mCursorAnchorInfoNotifier);
421
422        if (mError != null) {
423            hideError();
424        }
425
426        suspendBlink();
427
428        if (mInsertionPointCursorController != null) {
429            mInsertionPointCursorController.onDetached();
430        }
431
432        if (mSelectionModifierCursorController != null) {
433            mSelectionModifierCursorController.onDetached();
434        }
435
436        if (mShowSuggestionRunnable != null) {
437            mTextView.removeCallbacks(mShowSuggestionRunnable);
438        }
439
440        // Cancel the single tap delayed runnable.
441        if (mInsertionActionModeRunnable != null) {
442            mTextView.removeCallbacks(mInsertionActionModeRunnable);
443        }
444
445        mTextView.removeCallbacks(mShowFloatingToolbar);
446
447        discardTextDisplayLists();
448
449        if (mSpellChecker != null) {
450            mSpellChecker.closeSession();
451            // Forces the creation of a new SpellChecker next time this window is created.
452            // Will handle the cases where the settings has been changed in the meantime.
453            mSpellChecker = null;
454        }
455
456        hideCursorAndSpanControllers();
457        stopTextActionModeWithPreservingSelection();
458    }
459
460    private void discardTextDisplayLists() {
461        if (mTextRenderNodes != null) {
462            for (int i = 0; i < mTextRenderNodes.length; i++) {
463                RenderNode displayList = mTextRenderNodes[i] != null
464                        ? mTextRenderNodes[i].renderNode : null;
465                if (displayList != null && displayList.isValid()) {
466                    displayList.discardDisplayList();
467                }
468            }
469        }
470    }
471
472    private void showError() {
473        if (mTextView.getWindowToken() == null) {
474            mShowErrorAfterAttach = true;
475            return;
476        }
477
478        if (mErrorPopup == null) {
479            LayoutInflater inflater = LayoutInflater.from(mTextView.getContext());
480            final TextView err = (TextView) inflater.inflate(
481                    com.android.internal.R.layout.textview_hint, null);
482
483            final float scale = mTextView.getResources().getDisplayMetrics().density;
484            mErrorPopup =
485                    new ErrorPopup(err, (int) (200 * scale + 0.5f), (int) (50 * scale + 0.5f));
486            mErrorPopup.setFocusable(false);
487            // The user is entering text, so the input method is needed.  We
488            // don't want the popup to be displayed on top of it.
489            mErrorPopup.setInputMethodMode(PopupWindow.INPUT_METHOD_NEEDED);
490        }
491
492        TextView tv = (TextView) mErrorPopup.getContentView();
493        chooseSize(mErrorPopup, mError, tv);
494        tv.setText(mError);
495
496        mErrorPopup.showAsDropDown(mTextView, getErrorX(), getErrorY());
497        mErrorPopup.fixDirection(mErrorPopup.isAboveAnchor());
498    }
499
500    public void setError(CharSequence error, Drawable icon) {
501        mError = TextUtils.stringOrSpannedString(error);
502        mErrorWasChanged = true;
503
504        if (mError == null) {
505            setErrorIcon(null);
506            if (mErrorPopup != null) {
507                if (mErrorPopup.isShowing()) {
508                    mErrorPopup.dismiss();
509                }
510
511                mErrorPopup = null;
512            }
513            mShowErrorAfterAttach = false;
514        } else {
515            setErrorIcon(icon);
516            if (mTextView.isFocused()) {
517                showError();
518            }
519        }
520    }
521
522    private void setErrorIcon(Drawable icon) {
523        Drawables dr = mTextView.mDrawables;
524        if (dr == null) {
525            mTextView.mDrawables = dr = new Drawables(mTextView.getContext());
526        }
527        dr.setErrorDrawable(icon, mTextView);
528
529        mTextView.resetResolvedDrawables();
530        mTextView.invalidate();
531        mTextView.requestLayout();
532    }
533
534    private void hideError() {
535        if (mErrorPopup != null) {
536            if (mErrorPopup.isShowing()) {
537                mErrorPopup.dismiss();
538            }
539        }
540
541        mShowErrorAfterAttach = false;
542    }
543
544    /**
545     * Returns the X offset to make the pointy top of the error point
546     * at the middle of the error icon.
547     */
548    private int getErrorX() {
549        /*
550         * The "25" is the distance between the point and the right edge
551         * of the background
552         */
553        final float scale = mTextView.getResources().getDisplayMetrics().density;
554
555        final Drawables dr = mTextView.mDrawables;
556
557        final int layoutDirection = mTextView.getLayoutDirection();
558        int errorX;
559        int offset;
560        switch (layoutDirection) {
561            default:
562            case View.LAYOUT_DIRECTION_LTR:
563                offset = -(dr != null ? dr.mDrawableSizeRight : 0) / 2 + (int) (25 * scale + 0.5f);
564                errorX = mTextView.getWidth() - mErrorPopup.getWidth()
565                        - mTextView.getPaddingRight() + offset;
566                break;
567            case View.LAYOUT_DIRECTION_RTL:
568                offset = (dr != null ? dr.mDrawableSizeLeft : 0) / 2 - (int) (25 * scale + 0.5f);
569                errorX = mTextView.getPaddingLeft() + offset;
570                break;
571        }
572        return errorX;
573    }
574
575    /**
576     * Returns the Y offset to make the pointy top of the error point
577     * at the bottom of the error icon.
578     */
579    private int getErrorY() {
580        /*
581         * Compound, not extended, because the icon is not clipped
582         * if the text height is smaller.
583         */
584        final int compoundPaddingTop = mTextView.getCompoundPaddingTop();
585        int vspace = mTextView.getBottom() - mTextView.getTop()
586                - mTextView.getCompoundPaddingBottom() - compoundPaddingTop;
587
588        final Drawables dr = mTextView.mDrawables;
589
590        final int layoutDirection = mTextView.getLayoutDirection();
591        int height;
592        switch (layoutDirection) {
593            default:
594            case View.LAYOUT_DIRECTION_LTR:
595                height = (dr != null ? dr.mDrawableHeightRight : 0);
596                break;
597            case View.LAYOUT_DIRECTION_RTL:
598                height = (dr != null ? dr.mDrawableHeightLeft : 0);
599                break;
600        }
601
602        int icontop = compoundPaddingTop + (vspace - height) / 2;
603
604        /*
605         * The "2" is the distance between the point and the top edge
606         * of the background.
607         */
608        final float scale = mTextView.getResources().getDisplayMetrics().density;
609        return icontop + height - mTextView.getHeight() - (int) (2 * scale + 0.5f);
610    }
611
612    void createInputContentTypeIfNeeded() {
613        if (mInputContentType == null) {
614            mInputContentType = new InputContentType();
615        }
616    }
617
618    void createInputMethodStateIfNeeded() {
619        if (mInputMethodState == null) {
620            mInputMethodState = new InputMethodState();
621        }
622    }
623
624    boolean isCursorVisible() {
625        // The default value is true, even when there is no associated Editor
626        return mCursorVisible && mTextView.isTextEditable();
627    }
628
629    void prepareCursorControllers() {
630        boolean windowSupportsHandles = false;
631
632        ViewGroup.LayoutParams params = mTextView.getRootView().getLayoutParams();
633        if (params instanceof WindowManager.LayoutParams) {
634            WindowManager.LayoutParams windowParams = (WindowManager.LayoutParams) params;
635            windowSupportsHandles = windowParams.type < WindowManager.LayoutParams.FIRST_SUB_WINDOW
636                    || windowParams.type > WindowManager.LayoutParams.LAST_SUB_WINDOW;
637        }
638
639        boolean enabled = windowSupportsHandles && mTextView.getLayout() != null;
640        mInsertionControllerEnabled = enabled && isCursorVisible();
641        mSelectionControllerEnabled = enabled && mTextView.textCanBeSelected();
642
643        if (!mInsertionControllerEnabled) {
644            hideInsertionPointCursorController();
645            if (mInsertionPointCursorController != null) {
646                mInsertionPointCursorController.onDetached();
647                mInsertionPointCursorController = null;
648            }
649        }
650
651        if (!mSelectionControllerEnabled) {
652            stopTextActionMode();
653            if (mSelectionModifierCursorController != null) {
654                mSelectionModifierCursorController.onDetached();
655                mSelectionModifierCursorController = null;
656            }
657        }
658    }
659
660    void hideInsertionPointCursorController() {
661        if (mInsertionPointCursorController != null) {
662            mInsertionPointCursorController.hide();
663        }
664    }
665
666    /**
667     * Hides the insertion and span controllers.
668     */
669    void hideCursorAndSpanControllers() {
670        hideCursorControllers();
671        hideSpanControllers();
672    }
673
674    private void hideSpanControllers() {
675        if (mSpanController != null) {
676            mSpanController.hide();
677        }
678    }
679
680    private void hideCursorControllers() {
681        // When mTextView is not ExtractEditText, we need to distinguish two kinds of focus-lost.
682        // One is the true focus lost where suggestions pop-up (if any) should be dismissed, and the
683        // other is an side effect of showing the suggestions pop-up itself. We use isShowingUp()
684        // to distinguish one from the other.
685        if (mSuggestionsPopupWindow != null && ((mTextView.isInExtractedMode())
686                || !mSuggestionsPopupWindow.isShowingUp())) {
687            // Should be done before hide insertion point controller since it triggers a show of it
688            mSuggestionsPopupWindow.hide();
689        }
690        hideInsertionPointCursorController();
691    }
692
693    /**
694     * Create new SpellCheckSpans on the modified region.
695     */
696    private void updateSpellCheckSpans(int start, int end, boolean createSpellChecker) {
697        // Remove spans whose adjacent characters are text not punctuation
698        mTextView.removeAdjacentSuggestionSpans(start);
699        mTextView.removeAdjacentSuggestionSpans(end);
700
701        if (mTextView.isTextEditable() && mTextView.isSuggestionsEnabled()
702                && !(mTextView.isInExtractedMode())) {
703            if (mSpellChecker == null && createSpellChecker) {
704                mSpellChecker = new SpellChecker(mTextView);
705            }
706            if (mSpellChecker != null) {
707                mSpellChecker.spellCheck(start, end);
708            }
709        }
710    }
711
712    void onScreenStateChanged(int screenState) {
713        switch (screenState) {
714            case View.SCREEN_STATE_ON:
715                resumeBlink();
716                break;
717            case View.SCREEN_STATE_OFF:
718                suspendBlink();
719                break;
720        }
721    }
722
723    private void suspendBlink() {
724        if (mBlink != null) {
725            mBlink.cancel();
726        }
727    }
728
729    private void resumeBlink() {
730        if (mBlink != null) {
731            mBlink.uncancel();
732            makeBlink();
733        }
734    }
735
736    void adjustInputType(boolean password, boolean passwordInputType,
737            boolean webPasswordInputType, boolean numberPasswordInputType) {
738        // mInputType has been set from inputType, possibly modified by mInputMethod.
739        // Specialize mInputType to [web]password if we have a text class and the original input
740        // type was a password.
741        if ((mInputType & EditorInfo.TYPE_MASK_CLASS) == EditorInfo.TYPE_CLASS_TEXT) {
742            if (password || passwordInputType) {
743                mInputType = (mInputType & ~(EditorInfo.TYPE_MASK_VARIATION))
744                        | EditorInfo.TYPE_TEXT_VARIATION_PASSWORD;
745            }
746            if (webPasswordInputType) {
747                mInputType = (mInputType & ~(EditorInfo.TYPE_MASK_VARIATION))
748                        | EditorInfo.TYPE_TEXT_VARIATION_WEB_PASSWORD;
749            }
750        } else if ((mInputType & EditorInfo.TYPE_MASK_CLASS) == EditorInfo.TYPE_CLASS_NUMBER) {
751            if (numberPasswordInputType) {
752                mInputType = (mInputType & ~(EditorInfo.TYPE_MASK_VARIATION))
753                        | EditorInfo.TYPE_NUMBER_VARIATION_PASSWORD;
754            }
755        }
756    }
757
758    private void chooseSize(PopupWindow pop, CharSequence text, TextView tv) {
759        int wid = tv.getPaddingLeft() + tv.getPaddingRight();
760        int ht = tv.getPaddingTop() + tv.getPaddingBottom();
761
762        int defaultWidthInPixels = mTextView.getResources().getDimensionPixelSize(
763                com.android.internal.R.dimen.textview_error_popup_default_width);
764        Layout l = new StaticLayout(text, tv.getPaint(), defaultWidthInPixels,
765                                    Layout.Alignment.ALIGN_NORMAL, 1, 0, true);
766        float max = 0;
767        for (int i = 0; i < l.getLineCount(); i++) {
768            max = Math.max(max, l.getLineWidth(i));
769        }
770
771        /*
772         * Now set the popup size to be big enough for the text plus the border capped
773         * to DEFAULT_MAX_POPUP_WIDTH
774         */
775        pop.setWidth(wid + (int) Math.ceil(max));
776        pop.setHeight(ht + l.getHeight());
777    }
778
779    void setFrame() {
780        if (mErrorPopup != null) {
781            TextView tv = (TextView) mErrorPopup.getContentView();
782            chooseSize(mErrorPopup, mError, tv);
783            mErrorPopup.update(mTextView, getErrorX(), getErrorY(),
784                    mErrorPopup.getWidth(), mErrorPopup.getHeight());
785        }
786    }
787
788    private int getWordStart(int offset) {
789        // FIXME - For this and similar methods we're not doing anything to check if there's
790        // a LocaleSpan in the text, this may be something we should try handling or checking for.
791        int retOffset = getWordIteratorWithText().prevBoundary(offset);
792        if (getWordIteratorWithText().isOnPunctuation(retOffset)) {
793            // On punctuation boundary or within group of punctuation, find punctuation start.
794            retOffset = getWordIteratorWithText().getPunctuationBeginning(offset);
795        } else {
796            // Not on a punctuation boundary, find the word start.
797            retOffset = getWordIteratorWithText().getPrevWordBeginningOnTwoWordsBoundary(offset);
798        }
799        if (retOffset == BreakIterator.DONE) {
800            return offset;
801        }
802        return retOffset;
803    }
804
805    private int getWordEnd(int offset) {
806        int retOffset = getWordIteratorWithText().nextBoundary(offset);
807        if (getWordIteratorWithText().isAfterPunctuation(retOffset)) {
808            // On punctuation boundary or within group of punctuation, find punctuation end.
809            retOffset = getWordIteratorWithText().getPunctuationEnd(offset);
810        } else {
811            // Not on a punctuation boundary, find the word end.
812            retOffset = getWordIteratorWithText().getNextWordEndOnTwoWordBoundary(offset);
813        }
814        if (retOffset == BreakIterator.DONE) {
815            return offset;
816        }
817        return retOffset;
818    }
819
820    private boolean needsToSelectAllToSelectWordOrParagraph() {
821        if (mTextView.hasPasswordTransformationMethod()) {
822            // Always select all on a password field.
823            // Cut/copy menu entries are not available for passwords, but being able to select all
824            // is however useful to delete or paste to replace the entire content.
825            return true;
826        }
827
828        int inputType = mTextView.getInputType();
829        int klass = inputType & InputType.TYPE_MASK_CLASS;
830        int variation = inputType & InputType.TYPE_MASK_VARIATION;
831
832        // Specific text field types: select the entire text for these
833        if (klass == InputType.TYPE_CLASS_NUMBER
834                || klass == InputType.TYPE_CLASS_PHONE
835                || klass == InputType.TYPE_CLASS_DATETIME
836                || variation == InputType.TYPE_TEXT_VARIATION_URI
837                || variation == InputType.TYPE_TEXT_VARIATION_EMAIL_ADDRESS
838                || variation == InputType.TYPE_TEXT_VARIATION_WEB_EMAIL_ADDRESS
839                || variation == InputType.TYPE_TEXT_VARIATION_FILTER) {
840            return true;
841        }
842        return false;
843    }
844
845    /**
846     * Adjusts selection to the word under last touch offset. Return true if the operation was
847     * successfully performed.
848     */
849    boolean selectCurrentWord() {
850        if (!mTextView.canSelectText()) {
851            return false;
852        }
853
854        if (needsToSelectAllToSelectWordOrParagraph()) {
855            return mTextView.selectAllText();
856        }
857
858        long lastTouchOffsets = getLastTouchOffsets();
859        final int minOffset = TextUtils.unpackRangeStartFromLong(lastTouchOffsets);
860        final int maxOffset = TextUtils.unpackRangeEndFromLong(lastTouchOffsets);
861
862        // Safety check in case standard touch event handling has been bypassed
863        if (minOffset < 0 || minOffset > mTextView.getText().length()) return false;
864        if (maxOffset < 0 || maxOffset > mTextView.getText().length()) return false;
865
866        int selectionStart, selectionEnd;
867
868        // If a URLSpan (web address, email, phone...) is found at that position, select it.
869        URLSpan[] urlSpans =
870                ((Spanned) mTextView.getText()).getSpans(minOffset, maxOffset, URLSpan.class);
871        if (urlSpans.length >= 1) {
872            URLSpan urlSpan = urlSpans[0];
873            selectionStart = ((Spanned) mTextView.getText()).getSpanStart(urlSpan);
874            selectionEnd = ((Spanned) mTextView.getText()).getSpanEnd(urlSpan);
875        } else {
876            // FIXME - We should check if there's a LocaleSpan in the text, this may be
877            // something we should try handling or checking for.
878            final WordIterator wordIterator = getWordIterator();
879            wordIterator.setCharSequence(mTextView.getText(), minOffset, maxOffset);
880
881            selectionStart = wordIterator.getBeginning(minOffset);
882            selectionEnd = wordIterator.getEnd(maxOffset);
883
884            if (selectionStart == BreakIterator.DONE || selectionEnd == BreakIterator.DONE
885                    || selectionStart == selectionEnd) {
886                // Possible when the word iterator does not properly handle the text's language
887                long range = getCharClusterRange(minOffset);
888                selectionStart = TextUtils.unpackRangeStartFromLong(range);
889                selectionEnd = TextUtils.unpackRangeEndFromLong(range);
890            }
891        }
892
893        Selection.setSelection((Spannable) mTextView.getText(), selectionStart, selectionEnd);
894        return selectionEnd > selectionStart;
895    }
896
897    /**
898     * Adjusts selection to the paragraph under last touch offset. Return true if the operation was
899     * successfully performed.
900     */
901    private boolean selectCurrentParagraph() {
902        if (!mTextView.canSelectText()) {
903            return false;
904        }
905
906        if (needsToSelectAllToSelectWordOrParagraph()) {
907            return mTextView.selectAllText();
908        }
909
910        long lastTouchOffsets = getLastTouchOffsets();
911        final int minLastTouchOffset = TextUtils.unpackRangeStartFromLong(lastTouchOffsets);
912        final int maxLastTouchOffset = TextUtils.unpackRangeEndFromLong(lastTouchOffsets);
913
914        final long paragraphsRange = getParagraphsRange(minLastTouchOffset, maxLastTouchOffset);
915        final int start = TextUtils.unpackRangeStartFromLong(paragraphsRange);
916        final int end = TextUtils.unpackRangeEndFromLong(paragraphsRange);
917        if (start < end) {
918            Selection.setSelection((Spannable) mTextView.getText(), start, end);
919            return true;
920        }
921        return false;
922    }
923
924    /**
925     * Get the minimum range of paragraphs that contains startOffset and endOffset.
926     */
927    private long getParagraphsRange(int startOffset, int endOffset) {
928        final Layout layout = mTextView.getLayout();
929        if (layout == null) {
930            return TextUtils.packRangeInLong(-1, -1);
931        }
932        final CharSequence text = mTextView.getText();
933        int minLine = layout.getLineForOffset(startOffset);
934        // Search paragraph start.
935        while (minLine > 0) {
936            final int prevLineEndOffset = layout.getLineEnd(minLine - 1);
937            if (text.charAt(prevLineEndOffset - 1) == '\n') {
938                break;
939            }
940            minLine--;
941        }
942        int maxLine = layout.getLineForOffset(endOffset);
943        // Search paragraph end.
944        while (maxLine < layout.getLineCount() - 1) {
945            final int lineEndOffset = layout.getLineEnd(maxLine);
946            if (text.charAt(lineEndOffset - 1) == '\n') {
947                break;
948            }
949            maxLine++;
950        }
951        return TextUtils.packRangeInLong(layout.getLineStart(minLine), layout.getLineEnd(maxLine));
952    }
953
954    void onLocaleChanged() {
955        // Will be re-created on demand in getWordIterator and getWordIteratorWithText with the
956        // proper new locale
957        mWordIterator = null;
958        mWordIteratorWithText = null;
959    }
960
961    public WordIterator getWordIterator() {
962        if (mWordIterator == null) {
963            mWordIterator = new WordIterator(mTextView.getTextServicesLocale());
964        }
965        return mWordIterator;
966    }
967
968    private WordIterator getWordIteratorWithText() {
969        if (mWordIteratorWithText == null) {
970            mWordIteratorWithText = new WordIterator(mTextView.getTextServicesLocale());
971            mUpdateWordIteratorText = true;
972        }
973        if (mUpdateWordIteratorText) {
974            // FIXME - Shouldn't copy all of the text as only the area of the text relevant
975            // to the user's selection is needed. A possible solution would be to
976            // copy some number N of characters near the selection and then when the
977            // user approaches N then we'd do another copy of the next N characters.
978            CharSequence text = mTextView.getText();
979            mWordIteratorWithText.setCharSequence(text, 0, text.length());
980            mUpdateWordIteratorText = false;
981        }
982        return mWordIteratorWithText;
983    }
984
985    private int getNextCursorOffset(int offset, boolean findAfterGivenOffset) {
986        final Layout layout = mTextView.getLayout();
987        if (layout == null) return offset;
988        return findAfterGivenOffset == layout.isRtlCharAt(offset)
989                ? layout.getOffsetToLeftOf(offset) : layout.getOffsetToRightOf(offset);
990    }
991
992    private long getCharClusterRange(int offset) {
993        final int textLength = mTextView.getText().length();
994        if (offset < textLength) {
995            final int clusterEndOffset = getNextCursorOffset(offset, true);
996            return TextUtils.packRangeInLong(
997                    getNextCursorOffset(clusterEndOffset, false), clusterEndOffset);
998        }
999        if (offset - 1 >= 0) {
1000            final int clusterStartOffset = getNextCursorOffset(offset, false);
1001            return TextUtils.packRangeInLong(clusterStartOffset,
1002                    getNextCursorOffset(clusterStartOffset, true));
1003        }
1004        return TextUtils.packRangeInLong(offset, offset);
1005    }
1006
1007    private boolean touchPositionIsInSelection() {
1008        int selectionStart = mTextView.getSelectionStart();
1009        int selectionEnd = mTextView.getSelectionEnd();
1010
1011        if (selectionStart == selectionEnd) {
1012            return false;
1013        }
1014
1015        if (selectionStart > selectionEnd) {
1016            int tmp = selectionStart;
1017            selectionStart = selectionEnd;
1018            selectionEnd = tmp;
1019            Selection.setSelection((Spannable) mTextView.getText(), selectionStart, selectionEnd);
1020        }
1021
1022        SelectionModifierCursorController selectionController = getSelectionController();
1023        int minOffset = selectionController.getMinTouchOffset();
1024        int maxOffset = selectionController.getMaxTouchOffset();
1025
1026        return ((minOffset >= selectionStart) && (maxOffset < selectionEnd));
1027    }
1028
1029    private PositionListener getPositionListener() {
1030        if (mPositionListener == null) {
1031            mPositionListener = new PositionListener();
1032        }
1033        return mPositionListener;
1034    }
1035
1036    private interface TextViewPositionListener {
1037        public void updatePosition(int parentPositionX, int parentPositionY,
1038                boolean parentPositionChanged, boolean parentScrolled);
1039    }
1040
1041    private boolean isOffsetVisible(int offset) {
1042        Layout layout = mTextView.getLayout();
1043        if (layout == null) return false;
1044
1045        final int line = layout.getLineForOffset(offset);
1046        final int lineBottom = layout.getLineBottom(line);
1047        final int primaryHorizontal = (int) layout.getPrimaryHorizontal(offset);
1048        return mTextView.isPositionVisible(
1049                primaryHorizontal + mTextView.viewportToContentHorizontalOffset(),
1050                lineBottom + mTextView.viewportToContentVerticalOffset());
1051    }
1052
1053    /** Returns true if the screen coordinates position (x,y) corresponds to a character displayed
1054     * in the view. Returns false when the position is in the empty space of left/right of text.
1055     */
1056    private boolean isPositionOnText(float x, float y) {
1057        Layout layout = mTextView.getLayout();
1058        if (layout == null) return false;
1059
1060        final int line = mTextView.getLineAtCoordinate(y);
1061        x = mTextView.convertToLocalHorizontalCoordinate(x);
1062
1063        if (x < layout.getLineLeft(line)) return false;
1064        if (x > layout.getLineRight(line)) return false;
1065        return true;
1066    }
1067
1068    private void startDragAndDrop() {
1069        // TODO: Fix drag and drop in full screen extracted mode.
1070        if (mTextView.isInExtractedMode()) {
1071            return;
1072        }
1073        final int start = mTextView.getSelectionStart();
1074        final int end = mTextView.getSelectionEnd();
1075        CharSequence selectedText = mTextView.getTransformedText(start, end);
1076        ClipData data = ClipData.newPlainText(null, selectedText);
1077        DragLocalState localState = new DragLocalState(mTextView, start, end);
1078        mTextView.startDragAndDrop(data, getTextThumbnailBuilder(start, end), localState,
1079                View.DRAG_FLAG_GLOBAL);
1080        stopTextActionMode();
1081        if (hasSelectionController()) {
1082            getSelectionController().resetTouchOffsets();
1083        }
1084    }
1085
1086    public boolean performLongClick(boolean handled) {
1087        // Long press in empty space moves cursor and starts the insertion action mode.
1088        if (!handled && !isPositionOnText(mLastDownPositionX, mLastDownPositionY)
1089                && mInsertionControllerEnabled) {
1090            final int offset = mTextView.getOffsetForPosition(mLastDownPositionX,
1091                    mLastDownPositionY);
1092            Selection.setSelection((Spannable) mTextView.getText(), offset);
1093            getInsertionController().show();
1094            mIsInsertionActionModeStartPending = true;
1095            handled = true;
1096            MetricsLogger.action(
1097                    mTextView.getContext(),
1098                    MetricsEvent.TEXT_LONGPRESS,
1099                    TextViewMetrics.SUBTYPE_LONG_PRESS_OTHER);
1100        }
1101
1102        if (!handled && mTextActionMode != null) {
1103            if (touchPositionIsInSelection()) {
1104                startDragAndDrop();
1105                MetricsLogger.action(
1106                        mTextView.getContext(),
1107                        MetricsEvent.TEXT_LONGPRESS,
1108                        TextViewMetrics.SUBTYPE_LONG_PRESS_DRAG_AND_DROP);
1109            } else {
1110                stopTextActionMode();
1111                selectCurrentWordAndStartDrag();
1112                MetricsLogger.action(
1113                        mTextView.getContext(),
1114                        MetricsEvent.TEXT_LONGPRESS,
1115                        TextViewMetrics.SUBTYPE_LONG_PRESS_SELECTION);
1116            }
1117            handled = true;
1118        }
1119
1120        // Start a new selection
1121        if (!handled) {
1122            handled = selectCurrentWordAndStartDrag();
1123            if (handled) {
1124                MetricsLogger.action(
1125                        mTextView.getContext(),
1126                        MetricsEvent.TEXT_LONGPRESS,
1127                        TextViewMetrics.SUBTYPE_LONG_PRESS_SELECTION);
1128            }
1129        }
1130
1131        return handled;
1132    }
1133
1134    private long getLastTouchOffsets() {
1135        SelectionModifierCursorController selectionController = getSelectionController();
1136        final int minOffset = selectionController.getMinTouchOffset();
1137        final int maxOffset = selectionController.getMaxTouchOffset();
1138        return TextUtils.packRangeInLong(minOffset, maxOffset);
1139    }
1140
1141    void onFocusChanged(boolean focused, int direction) {
1142        mShowCursor = SystemClock.uptimeMillis();
1143        ensureEndedBatchEdit();
1144
1145        if (focused) {
1146            int selStart = mTextView.getSelectionStart();
1147            int selEnd = mTextView.getSelectionEnd();
1148
1149            // SelectAllOnFocus fields are highlighted and not selected. Do not start text selection
1150            // mode for these, unless there was a specific selection already started.
1151            final boolean isFocusHighlighted = mSelectAllOnFocus && selStart == 0
1152                    && selEnd == mTextView.getText().length();
1153
1154            mCreatedWithASelection = mFrozenWithFocus && mTextView.hasSelection()
1155                    && !isFocusHighlighted;
1156
1157            if (!mFrozenWithFocus || (selStart < 0 || selEnd < 0)) {
1158                // If a tap was used to give focus to that view, move cursor at tap position.
1159                // Has to be done before onTakeFocus, which can be overloaded.
1160                final int lastTapPosition = getLastTapPosition();
1161                if (lastTapPosition >= 0) {
1162                    Selection.setSelection((Spannable) mTextView.getText(), lastTapPosition);
1163                }
1164
1165                // Note this may have to be moved out of the Editor class
1166                MovementMethod mMovement = mTextView.getMovementMethod();
1167                if (mMovement != null) {
1168                    mMovement.onTakeFocus(mTextView, (Spannable) mTextView.getText(), direction);
1169                }
1170
1171                // The DecorView does not have focus when the 'Done' ExtractEditText button is
1172                // pressed. Since it is the ViewAncestor's mView, it requests focus before
1173                // ExtractEditText clears focus, which gives focus to the ExtractEditText.
1174                // This special case ensure that we keep current selection in that case.
1175                // It would be better to know why the DecorView does not have focus at that time.
1176                if (((mTextView.isInExtractedMode()) || mSelectionMoved)
1177                        && selStart >= 0 && selEnd >= 0) {
1178                    /*
1179                     * Someone intentionally set the selection, so let them
1180                     * do whatever it is that they wanted to do instead of
1181                     * the default on-focus behavior.  We reset the selection
1182                     * here instead of just skipping the onTakeFocus() call
1183                     * because some movement methods do something other than
1184                     * just setting the selection in theirs and we still
1185                     * need to go through that path.
1186                     */
1187                    Selection.setSelection((Spannable) mTextView.getText(), selStart, selEnd);
1188                }
1189
1190                if (mSelectAllOnFocus) {
1191                    mTextView.selectAllText();
1192                }
1193
1194                mTouchFocusSelected = true;
1195            }
1196
1197            mFrozenWithFocus = false;
1198            mSelectionMoved = false;
1199
1200            if (mError != null) {
1201                showError();
1202            }
1203
1204            makeBlink();
1205        } else {
1206            if (mError != null) {
1207                hideError();
1208            }
1209            // Don't leave us in the middle of a batch edit.
1210            mTextView.onEndBatchEdit();
1211
1212            if (mTextView.isInExtractedMode()) {
1213                hideCursorAndSpanControllers();
1214                stopTextActionModeWithPreservingSelection();
1215            } else {
1216                hideCursorAndSpanControllers();
1217                if (mTextView.isTemporarilyDetached()) {
1218                    stopTextActionModeWithPreservingSelection();
1219                } else {
1220                    stopTextActionMode();
1221                }
1222                downgradeEasyCorrectionSpans();
1223            }
1224            // No need to create the controller
1225            if (mSelectionModifierCursorController != null) {
1226                mSelectionModifierCursorController.resetTouchOffsets();
1227            }
1228        }
1229    }
1230
1231    /**
1232     * Downgrades to simple suggestions all the easy correction spans that are not a spell check
1233     * span.
1234     */
1235    private void downgradeEasyCorrectionSpans() {
1236        CharSequence text = mTextView.getText();
1237        if (text instanceof Spannable) {
1238            Spannable spannable = (Spannable) text;
1239            SuggestionSpan[] suggestionSpans = spannable.getSpans(0,
1240                    spannable.length(), SuggestionSpan.class);
1241            for (int i = 0; i < suggestionSpans.length; i++) {
1242                int flags = suggestionSpans[i].getFlags();
1243                if ((flags & SuggestionSpan.FLAG_EASY_CORRECT) != 0
1244                        && (flags & SuggestionSpan.FLAG_MISSPELLED) == 0) {
1245                    flags &= ~SuggestionSpan.FLAG_EASY_CORRECT;
1246                    suggestionSpans[i].setFlags(flags);
1247                }
1248            }
1249        }
1250    }
1251
1252    void sendOnTextChanged(int start, int after) {
1253        updateSpellCheckSpans(start, start + after, false);
1254
1255        // Flip flag to indicate the word iterator needs to have the text reset.
1256        mUpdateWordIteratorText = true;
1257
1258        // Hide the controllers as soon as text is modified (typing, procedural...)
1259        // We do not hide the span controllers, since they can be added when a new text is
1260        // inserted into the text view (voice IME).
1261        hideCursorControllers();
1262        // Reset drag accelerator.
1263        if (mSelectionModifierCursorController != null) {
1264            mSelectionModifierCursorController.resetTouchOffsets();
1265        }
1266        stopTextActionMode();
1267    }
1268
1269    private int getLastTapPosition() {
1270        // No need to create the controller at that point, no last tap position saved
1271        if (mSelectionModifierCursorController != null) {
1272            int lastTapPosition = mSelectionModifierCursorController.getMinTouchOffset();
1273            if (lastTapPosition >= 0) {
1274                // Safety check, should not be possible.
1275                if (lastTapPosition > mTextView.getText().length()) {
1276                    lastTapPosition = mTextView.getText().length();
1277                }
1278                return lastTapPosition;
1279            }
1280        }
1281
1282        return -1;
1283    }
1284
1285    void onWindowFocusChanged(boolean hasWindowFocus) {
1286        if (hasWindowFocus) {
1287            if (mBlink != null) {
1288                mBlink.uncancel();
1289                makeBlink();
1290            }
1291            if (mTextView.hasSelection() && !extractedTextModeWillBeStarted()) {
1292                refreshTextActionMode();
1293            }
1294        } else {
1295            if (mBlink != null) {
1296                mBlink.cancel();
1297            }
1298            if (mInputContentType != null) {
1299                mInputContentType.enterDown = false;
1300            }
1301            // Order matters! Must be done before onParentLostFocus to rely on isShowingUp
1302            hideCursorAndSpanControllers();
1303            stopTextActionModeWithPreservingSelection();
1304            if (mSuggestionsPopupWindow != null) {
1305                mSuggestionsPopupWindow.onParentLostFocus();
1306            }
1307
1308            // Don't leave us in the middle of a batch edit. Same as in onFocusChanged
1309            ensureEndedBatchEdit();
1310        }
1311    }
1312
1313    private void updateTapState(MotionEvent event) {
1314        final int action = event.getActionMasked();
1315        if (action == MotionEvent.ACTION_DOWN) {
1316            final boolean isMouse = event.isFromSource(InputDevice.SOURCE_MOUSE);
1317            // Detect double tap and triple click.
1318            if (((mTapState == TAP_STATE_FIRST_TAP)
1319                    || ((mTapState == TAP_STATE_DOUBLE_TAP) && isMouse))
1320                            && (SystemClock.uptimeMillis() - mLastTouchUpTime)
1321                                    <= ViewConfiguration.getDoubleTapTimeout()) {
1322                if (mTapState == TAP_STATE_FIRST_TAP) {
1323                    mTapState = TAP_STATE_DOUBLE_TAP;
1324                } else {
1325                    mTapState = TAP_STATE_TRIPLE_CLICK;
1326                }
1327            } else {
1328                mTapState = TAP_STATE_FIRST_TAP;
1329            }
1330        }
1331        if (action == MotionEvent.ACTION_UP) {
1332            mLastTouchUpTime = SystemClock.uptimeMillis();
1333        }
1334    }
1335
1336    private boolean shouldFilterOutTouchEvent(MotionEvent event) {
1337        if (!event.isFromSource(InputDevice.SOURCE_MOUSE)) {
1338            return false;
1339        }
1340        final boolean primaryButtonStateChanged =
1341                ((mLastButtonState ^ event.getButtonState()) & MotionEvent.BUTTON_PRIMARY) != 0;
1342        final int action = event.getActionMasked();
1343        if ((action == MotionEvent.ACTION_DOWN || action == MotionEvent.ACTION_UP)
1344                && !primaryButtonStateChanged) {
1345            return true;
1346        }
1347        if (action == MotionEvent.ACTION_MOVE
1348                && !event.isButtonPressed(MotionEvent.BUTTON_PRIMARY)) {
1349            return true;
1350        }
1351        return false;
1352    }
1353
1354    void onTouchEvent(MotionEvent event) {
1355        final boolean filterOutEvent = shouldFilterOutTouchEvent(event);
1356        mLastButtonState = event.getButtonState();
1357        if (filterOutEvent) {
1358            if (event.getActionMasked() == MotionEvent.ACTION_UP) {
1359                mDiscardNextActionUp = true;
1360            }
1361            return;
1362        }
1363        updateTapState(event);
1364        updateFloatingToolbarVisibility(event);
1365
1366        if (hasSelectionController()) {
1367            getSelectionController().onTouchEvent(event);
1368        }
1369
1370        if (mShowSuggestionRunnable != null) {
1371            mTextView.removeCallbacks(mShowSuggestionRunnable);
1372            mShowSuggestionRunnable = null;
1373        }
1374
1375        if (event.getActionMasked() == MotionEvent.ACTION_DOWN) {
1376            mLastDownPositionX = event.getX();
1377            mLastDownPositionY = event.getY();
1378
1379            // Reset this state; it will be re-set if super.onTouchEvent
1380            // causes focus to move to the view.
1381            mTouchFocusSelected = false;
1382            mIgnoreActionUpEvent = false;
1383        }
1384    }
1385
1386    private void updateFloatingToolbarVisibility(MotionEvent event) {
1387        if (mTextActionMode != null) {
1388            switch (event.getActionMasked()) {
1389                case MotionEvent.ACTION_MOVE:
1390                    hideFloatingToolbar();
1391                    break;
1392                case MotionEvent.ACTION_UP:  // fall through
1393                case MotionEvent.ACTION_CANCEL:
1394                    showFloatingToolbar();
1395            }
1396        }
1397    }
1398
1399    private void hideFloatingToolbar() {
1400        if (mTextActionMode != null) {
1401            mTextView.removeCallbacks(mShowFloatingToolbar);
1402            mTextActionMode.hide(ActionMode.DEFAULT_HIDE_DURATION);
1403        }
1404    }
1405
1406    private void showFloatingToolbar() {
1407        if (mTextActionMode != null) {
1408            // Delay "show" so it doesn't interfere with click confirmations
1409            // or double-clicks that could "dismiss" the floating toolbar.
1410            int delay = ViewConfiguration.getDoubleTapTimeout();
1411            mTextView.postDelayed(mShowFloatingToolbar, delay);
1412
1413            // This classifies the text and most likely returns before the toolbar is actually
1414            // shown. If not, it will update the toolbar with the result when classification
1415            // returns. We would rather not wait for a long running classification process.
1416            invalidateActionModeAsync();
1417        }
1418    }
1419
1420    public void beginBatchEdit() {
1421        mInBatchEditControllers = true;
1422        final InputMethodState ims = mInputMethodState;
1423        if (ims != null) {
1424            int nesting = ++ims.mBatchEditNesting;
1425            if (nesting == 1) {
1426                ims.mCursorChanged = false;
1427                ims.mChangedDelta = 0;
1428                if (ims.mContentChanged) {
1429                    // We already have a pending change from somewhere else,
1430                    // so turn this into a full update.
1431                    ims.mChangedStart = 0;
1432                    ims.mChangedEnd = mTextView.getText().length();
1433                } else {
1434                    ims.mChangedStart = EXTRACT_UNKNOWN;
1435                    ims.mChangedEnd = EXTRACT_UNKNOWN;
1436                    ims.mContentChanged = false;
1437                }
1438                mUndoInputFilter.beginBatchEdit();
1439                mTextView.onBeginBatchEdit();
1440            }
1441        }
1442    }
1443
1444    public void endBatchEdit() {
1445        mInBatchEditControllers = false;
1446        final InputMethodState ims = mInputMethodState;
1447        if (ims != null) {
1448            int nesting = --ims.mBatchEditNesting;
1449            if (nesting == 0) {
1450                finishBatchEdit(ims);
1451            }
1452        }
1453    }
1454
1455    void ensureEndedBatchEdit() {
1456        final InputMethodState ims = mInputMethodState;
1457        if (ims != null && ims.mBatchEditNesting != 0) {
1458            ims.mBatchEditNesting = 0;
1459            finishBatchEdit(ims);
1460        }
1461    }
1462
1463    void finishBatchEdit(final InputMethodState ims) {
1464        mTextView.onEndBatchEdit();
1465        mUndoInputFilter.endBatchEdit();
1466
1467        if (ims.mContentChanged || ims.mSelectionModeChanged) {
1468            mTextView.updateAfterEdit();
1469            reportExtractedText();
1470        } else if (ims.mCursorChanged) {
1471            // Cheesy way to get us to report the current cursor location.
1472            mTextView.invalidateCursor();
1473        }
1474        // sendUpdateSelection knows to avoid sending if the selection did
1475        // not actually change.
1476        sendUpdateSelection();
1477
1478        // Show drag handles if they were blocked by batch edit mode.
1479        if (mTextActionMode != null) {
1480            final CursorController cursorController = mTextView.hasSelection()
1481                    ? getSelectionController() : getInsertionController();
1482            if (cursorController != null && !cursorController.isActive()
1483                    && !cursorController.isCursorBeingModified()) {
1484                cursorController.show();
1485            }
1486        }
1487    }
1488
1489    static final int EXTRACT_NOTHING = -2;
1490    static final int EXTRACT_UNKNOWN = -1;
1491
1492    boolean extractText(ExtractedTextRequest request, ExtractedText outText) {
1493        return extractTextInternal(request, EXTRACT_UNKNOWN, EXTRACT_UNKNOWN,
1494                EXTRACT_UNKNOWN, outText);
1495    }
1496
1497    private boolean extractTextInternal(@Nullable ExtractedTextRequest request,
1498            int partialStartOffset, int partialEndOffset, int delta,
1499            @Nullable ExtractedText outText) {
1500        if (request == null || outText == null) {
1501            return false;
1502        }
1503
1504        final CharSequence content = mTextView.getText();
1505        if (content == null) {
1506            return false;
1507        }
1508
1509        if (partialStartOffset != EXTRACT_NOTHING) {
1510            final int N = content.length();
1511            if (partialStartOffset < 0) {
1512                outText.partialStartOffset = outText.partialEndOffset = -1;
1513                partialStartOffset = 0;
1514                partialEndOffset = N;
1515            } else {
1516                // Now use the delta to determine the actual amount of text
1517                // we need.
1518                partialEndOffset += delta;
1519                // Adjust offsets to ensure we contain full spans.
1520                if (content instanceof Spanned) {
1521                    Spanned spanned = (Spanned) content;
1522                    Object[] spans = spanned.getSpans(partialStartOffset,
1523                            partialEndOffset, ParcelableSpan.class);
1524                    int i = spans.length;
1525                    while (i > 0) {
1526                        i--;
1527                        int j = spanned.getSpanStart(spans[i]);
1528                        if (j < partialStartOffset) partialStartOffset = j;
1529                        j = spanned.getSpanEnd(spans[i]);
1530                        if (j > partialEndOffset) partialEndOffset = j;
1531                    }
1532                }
1533                outText.partialStartOffset = partialStartOffset;
1534                outText.partialEndOffset = partialEndOffset - delta;
1535
1536                if (partialStartOffset > N) {
1537                    partialStartOffset = N;
1538                } else if (partialStartOffset < 0) {
1539                    partialStartOffset = 0;
1540                }
1541                if (partialEndOffset > N) {
1542                    partialEndOffset = N;
1543                } else if (partialEndOffset < 0) {
1544                    partialEndOffset = 0;
1545                }
1546            }
1547            if ((request.flags & InputConnection.GET_TEXT_WITH_STYLES) != 0) {
1548                outText.text = content.subSequence(partialStartOffset,
1549                        partialEndOffset);
1550            } else {
1551                outText.text = TextUtils.substring(content, partialStartOffset,
1552                        partialEndOffset);
1553            }
1554        } else {
1555            outText.partialStartOffset = 0;
1556            outText.partialEndOffset = 0;
1557            outText.text = "";
1558        }
1559        outText.flags = 0;
1560        if (MetaKeyKeyListener.getMetaState(content, MetaKeyKeyListener.META_SELECTING) != 0) {
1561            outText.flags |= ExtractedText.FLAG_SELECTING;
1562        }
1563        if (mTextView.isSingleLine()) {
1564            outText.flags |= ExtractedText.FLAG_SINGLE_LINE;
1565        }
1566        outText.startOffset = 0;
1567        outText.selectionStart = mTextView.getSelectionStart();
1568        outText.selectionEnd = mTextView.getSelectionEnd();
1569        return true;
1570    }
1571
1572    boolean reportExtractedText() {
1573        final Editor.InputMethodState ims = mInputMethodState;
1574        if (ims != null) {
1575            final boolean contentChanged = ims.mContentChanged;
1576            if (contentChanged || ims.mSelectionModeChanged) {
1577                ims.mContentChanged = false;
1578                ims.mSelectionModeChanged = false;
1579                final ExtractedTextRequest req = ims.mExtractedTextRequest;
1580                if (req != null) {
1581                    InputMethodManager imm = InputMethodManager.peekInstance();
1582                    if (imm != null) {
1583                        if (TextView.DEBUG_EXTRACT) {
1584                            Log.v(TextView.LOG_TAG, "Retrieving extracted start="
1585                                    + ims.mChangedStart
1586                                    + " end=" + ims.mChangedEnd
1587                                    + " delta=" + ims.mChangedDelta);
1588                        }
1589                        if (ims.mChangedStart < 0 && !contentChanged) {
1590                            ims.mChangedStart = EXTRACT_NOTHING;
1591                        }
1592                        if (extractTextInternal(req, ims.mChangedStart, ims.mChangedEnd,
1593                                ims.mChangedDelta, ims.mExtractedText)) {
1594                            if (TextView.DEBUG_EXTRACT) {
1595                                Log.v(TextView.LOG_TAG,
1596                                        "Reporting extracted start="
1597                                                + ims.mExtractedText.partialStartOffset
1598                                                + " end=" + ims.mExtractedText.partialEndOffset
1599                                                + ": " + ims.mExtractedText.text);
1600                            }
1601
1602                            imm.updateExtractedText(mTextView, req.token, ims.mExtractedText);
1603                            ims.mChangedStart = EXTRACT_UNKNOWN;
1604                            ims.mChangedEnd = EXTRACT_UNKNOWN;
1605                            ims.mChangedDelta = 0;
1606                            ims.mContentChanged = false;
1607                            return true;
1608                        }
1609                    }
1610                }
1611            }
1612        }
1613        return false;
1614    }
1615
1616    private void sendUpdateSelection() {
1617        if (null != mInputMethodState && mInputMethodState.mBatchEditNesting <= 0) {
1618            final InputMethodManager imm = InputMethodManager.peekInstance();
1619            if (null != imm) {
1620                final int selectionStart = mTextView.getSelectionStart();
1621                final int selectionEnd = mTextView.getSelectionEnd();
1622                int candStart = -1;
1623                int candEnd = -1;
1624                if (mTextView.getText() instanceof Spannable) {
1625                    final Spannable sp = (Spannable) mTextView.getText();
1626                    candStart = EditableInputConnection.getComposingSpanStart(sp);
1627                    candEnd = EditableInputConnection.getComposingSpanEnd(sp);
1628                }
1629                // InputMethodManager#updateSelection skips sending the message if
1630                // none of the parameters have changed since the last time we called it.
1631                imm.updateSelection(mTextView,
1632                        selectionStart, selectionEnd, candStart, candEnd);
1633            }
1634        }
1635    }
1636
1637    void onDraw(Canvas canvas, Layout layout, Path highlight, Paint highlightPaint,
1638            int cursorOffsetVertical) {
1639        final int selectionStart = mTextView.getSelectionStart();
1640        final int selectionEnd = mTextView.getSelectionEnd();
1641
1642        final InputMethodState ims = mInputMethodState;
1643        if (ims != null && ims.mBatchEditNesting == 0) {
1644            InputMethodManager imm = InputMethodManager.peekInstance();
1645            if (imm != null) {
1646                if (imm.isActive(mTextView)) {
1647                    if (ims.mContentChanged || ims.mSelectionModeChanged) {
1648                        // We are in extract mode and the content has changed
1649                        // in some way... just report complete new text to the
1650                        // input method.
1651                        reportExtractedText();
1652                    }
1653                }
1654            }
1655        }
1656
1657        if (mCorrectionHighlighter != null) {
1658            mCorrectionHighlighter.draw(canvas, cursorOffsetVertical);
1659        }
1660
1661        if (highlight != null && selectionStart == selectionEnd && mCursorCount > 0) {
1662            drawCursor(canvas, cursorOffsetVertical);
1663            // Rely on the drawable entirely, do not draw the cursor line.
1664            // Has to be done after the IMM related code above which relies on the highlight.
1665            highlight = null;
1666        }
1667
1668        if (mTextView.canHaveDisplayList() && canvas.isHardwareAccelerated()) {
1669            drawHardwareAccelerated(canvas, layout, highlight, highlightPaint,
1670                    cursorOffsetVertical);
1671        } else {
1672            layout.draw(canvas, highlight, highlightPaint, cursorOffsetVertical);
1673        }
1674    }
1675
1676    private void drawHardwareAccelerated(Canvas canvas, Layout layout, Path highlight,
1677            Paint highlightPaint, int cursorOffsetVertical) {
1678        final long lineRange = layout.getLineRangeForDraw(canvas);
1679        int firstLine = TextUtils.unpackRangeStartFromLong(lineRange);
1680        int lastLine = TextUtils.unpackRangeEndFromLong(lineRange);
1681        if (lastLine < 0) return;
1682
1683        layout.drawBackground(canvas, highlight, highlightPaint, cursorOffsetVertical,
1684                firstLine, lastLine);
1685
1686        if (layout instanceof DynamicLayout) {
1687            if (mTextRenderNodes == null) {
1688                mTextRenderNodes = ArrayUtils.emptyArray(TextRenderNode.class);
1689            }
1690
1691            DynamicLayout dynamicLayout = (DynamicLayout) layout;
1692            int[] blockEndLines = dynamicLayout.getBlockEndLines();
1693            int[] blockIndices = dynamicLayout.getBlockIndices();
1694            final int numberOfBlocks = dynamicLayout.getNumberOfBlocks();
1695            final int indexFirstChangedBlock = dynamicLayout.getIndexFirstChangedBlock();
1696
1697            final ArraySet<Integer> blockSet = dynamicLayout.getBlocksAlwaysNeedToBeRedrawn();
1698            if (blockSet != null) {
1699                for (int i = 0; i < blockSet.size(); i++) {
1700                    final int blockIndex = dynamicLayout.getBlockIndex(blockSet.valueAt(i));
1701                    if (blockIndex != DynamicLayout.INVALID_BLOCK_INDEX
1702                            && mTextRenderNodes[blockIndex] != null) {
1703                        mTextRenderNodes[blockIndex].needsToBeShifted = true;
1704                    }
1705                }
1706            }
1707
1708            int startBlock = Arrays.binarySearch(blockEndLines, 0, numberOfBlocks, firstLine);
1709            if (startBlock < 0) {
1710                startBlock = -(startBlock + 1);
1711            }
1712            startBlock = Math.min(indexFirstChangedBlock, startBlock);
1713
1714            int startIndexToFindAvailableRenderNode = 0;
1715            int lastIndex = numberOfBlocks;
1716
1717            for (int i = startBlock; i < numberOfBlocks; i++) {
1718                final int blockIndex = blockIndices[i];
1719                if (i >= indexFirstChangedBlock
1720                        && blockIndex != DynamicLayout.INVALID_BLOCK_INDEX
1721                        && mTextRenderNodes[blockIndex] != null) {
1722                    mTextRenderNodes[blockIndex].needsToBeShifted = true;
1723                }
1724                if (blockEndLines[i] < firstLine) {
1725                    // Blocks in [indexFirstChangedBlock, firstLine) are not redrawn here. They will
1726                    // be redrawn after they get scrolled into drawing range.
1727                    continue;
1728                }
1729                startIndexToFindAvailableRenderNode = drawHardwareAcceleratedInner(canvas, layout,
1730                        highlight, highlightPaint, cursorOffsetVertical, blockEndLines,
1731                        blockIndices, i, numberOfBlocks, startIndexToFindAvailableRenderNode);
1732                if (blockEndLines[i] >= lastLine) {
1733                    lastIndex = Math.max(indexFirstChangedBlock, i + 1);
1734                    break;
1735                }
1736            }
1737            if (blockSet != null) {
1738                for (int i = 0; i < blockSet.size(); i++) {
1739                    final int block = blockSet.valueAt(i);
1740                    final int blockIndex = dynamicLayout.getBlockIndex(block);
1741                    if (blockIndex == DynamicLayout.INVALID_BLOCK_INDEX
1742                            || mTextRenderNodes[blockIndex] == null
1743                            || mTextRenderNodes[blockIndex].needsToBeShifted) {
1744                        startIndexToFindAvailableRenderNode = drawHardwareAcceleratedInner(canvas,
1745                                layout, highlight, highlightPaint, cursorOffsetVertical,
1746                                blockEndLines, blockIndices, block, numberOfBlocks,
1747                                startIndexToFindAvailableRenderNode);
1748                    }
1749                }
1750            }
1751
1752            dynamicLayout.setIndexFirstChangedBlock(lastIndex);
1753        } else {
1754            // Boring layout is used for empty and hint text
1755            layout.drawText(canvas, firstLine, lastLine);
1756        }
1757    }
1758
1759    private int drawHardwareAcceleratedInner(Canvas canvas, Layout layout, Path highlight,
1760            Paint highlightPaint, int cursorOffsetVertical, int[] blockEndLines,
1761            int[] blockIndices, int blockInfoIndex, int numberOfBlocks,
1762            int startIndexToFindAvailableRenderNode) {
1763        final int blockEndLine = blockEndLines[blockInfoIndex];
1764        int blockIndex = blockIndices[blockInfoIndex];
1765
1766        final boolean blockIsInvalid = blockIndex == DynamicLayout.INVALID_BLOCK_INDEX;
1767        if (blockIsInvalid) {
1768            blockIndex = getAvailableDisplayListIndex(blockIndices, numberOfBlocks,
1769                    startIndexToFindAvailableRenderNode);
1770            // Note how dynamic layout's internal block indices get updated from Editor
1771            blockIndices[blockInfoIndex] = blockIndex;
1772            if (mTextRenderNodes[blockIndex] != null) {
1773                mTextRenderNodes[blockIndex].isDirty = true;
1774            }
1775            startIndexToFindAvailableRenderNode = blockIndex + 1;
1776        }
1777
1778        if (mTextRenderNodes[blockIndex] == null) {
1779            mTextRenderNodes[blockIndex] = new TextRenderNode("Text " + blockIndex);
1780        }
1781
1782        final boolean blockDisplayListIsInvalid = mTextRenderNodes[blockIndex].needsRecord();
1783        RenderNode blockDisplayList = mTextRenderNodes[blockIndex].renderNode;
1784        if (mTextRenderNodes[blockIndex].needsToBeShifted || blockDisplayListIsInvalid) {
1785            final int blockBeginLine = blockInfoIndex == 0 ?
1786                    0 : blockEndLines[blockInfoIndex - 1] + 1;
1787            final int top = layout.getLineTop(blockBeginLine);
1788            final int bottom = layout.getLineBottom(blockEndLine);
1789            int left = 0;
1790            int right = mTextView.getWidth();
1791            if (mTextView.getHorizontallyScrolling()) {
1792                float min = Float.MAX_VALUE;
1793                float max = Float.MIN_VALUE;
1794                for (int line = blockBeginLine; line <= blockEndLine; line++) {
1795                    min = Math.min(min, layout.getLineLeft(line));
1796                    max = Math.max(max, layout.getLineRight(line));
1797                }
1798                left = (int) min;
1799                right = (int) (max + 0.5f);
1800            }
1801
1802            // Rebuild display list if it is invalid
1803            if (blockDisplayListIsInvalid) {
1804                final DisplayListCanvas displayListCanvas = blockDisplayList.start(
1805                        right - left, bottom - top);
1806                try {
1807                    // drawText is always relative to TextView's origin, this translation
1808                    // brings this range of text back to the top left corner of the viewport
1809                    displayListCanvas.translate(-left, -top);
1810                    layout.drawText(displayListCanvas, blockBeginLine, blockEndLine);
1811                    mTextRenderNodes[blockIndex].isDirty = false;
1812                    // No need to untranslate, previous context is popped after
1813                    // drawDisplayList
1814                } finally {
1815                    blockDisplayList.end(displayListCanvas);
1816                    // Same as drawDisplayList below, handled by our TextView's parent
1817                    blockDisplayList.setClipToBounds(false);
1818                }
1819            }
1820
1821            // Valid display list only needs to update its drawing location.
1822            blockDisplayList.setLeftTopRightBottom(left, top, right, bottom);
1823            mTextRenderNodes[blockIndex].needsToBeShifted = false;
1824        }
1825        ((DisplayListCanvas) canvas).drawRenderNode(blockDisplayList);
1826        return startIndexToFindAvailableRenderNode;
1827    }
1828
1829    private int getAvailableDisplayListIndex(int[] blockIndices, int numberOfBlocks,
1830            int searchStartIndex) {
1831        int length = mTextRenderNodes.length;
1832        for (int i = searchStartIndex; i < length; i++) {
1833            boolean blockIndexFound = false;
1834            for (int j = 0; j < numberOfBlocks; j++) {
1835                if (blockIndices[j] == i) {
1836                    blockIndexFound = true;
1837                    break;
1838                }
1839            }
1840            if (blockIndexFound) continue;
1841            return i;
1842        }
1843
1844        // No available index found, the pool has to grow
1845        mTextRenderNodes = GrowingArrayUtils.append(mTextRenderNodes, length, null);
1846        return length;
1847    }
1848
1849    private void drawCursor(Canvas canvas, int cursorOffsetVertical) {
1850        final boolean translate = cursorOffsetVertical != 0;
1851        if (translate) canvas.translate(0, cursorOffsetVertical);
1852        for (int i = 0; i < mCursorCount; i++) {
1853            mCursorDrawable[i].draw(canvas);
1854        }
1855        if (translate) canvas.translate(0, -cursorOffsetVertical);
1856    }
1857
1858    void invalidateHandlesAndActionMode() {
1859        if (mSelectionModifierCursorController != null) {
1860            mSelectionModifierCursorController.invalidateHandles();
1861        }
1862        if (mInsertionPointCursorController != null) {
1863            mInsertionPointCursorController.invalidateHandle();
1864        }
1865        if (mTextActionMode != null) {
1866            invalidateActionMode();
1867        }
1868    }
1869
1870    /**
1871     * Invalidates all the sub-display lists that overlap the specified character range
1872     */
1873    void invalidateTextDisplayList(Layout layout, int start, int end) {
1874        if (mTextRenderNodes != null && layout instanceof DynamicLayout) {
1875            final int firstLine = layout.getLineForOffset(start);
1876            final int lastLine = layout.getLineForOffset(end);
1877
1878            DynamicLayout dynamicLayout = (DynamicLayout) layout;
1879            int[] blockEndLines = dynamicLayout.getBlockEndLines();
1880            int[] blockIndices = dynamicLayout.getBlockIndices();
1881            final int numberOfBlocks = dynamicLayout.getNumberOfBlocks();
1882
1883            int i = 0;
1884            // Skip the blocks before firstLine
1885            while (i < numberOfBlocks) {
1886                if (blockEndLines[i] >= firstLine) break;
1887                i++;
1888            }
1889
1890            // Invalidate all subsequent blocks until lastLine is passed
1891            while (i < numberOfBlocks) {
1892                final int blockIndex = blockIndices[i];
1893                if (blockIndex != DynamicLayout.INVALID_BLOCK_INDEX) {
1894                    mTextRenderNodes[blockIndex].isDirty = true;
1895                }
1896                if (blockEndLines[i] >= lastLine) break;
1897                i++;
1898            }
1899        }
1900    }
1901
1902    void invalidateTextDisplayList() {
1903        if (mTextRenderNodes != null) {
1904            for (int i = 0; i < mTextRenderNodes.length; i++) {
1905                if (mTextRenderNodes[i] != null) mTextRenderNodes[i].isDirty = true;
1906            }
1907        }
1908    }
1909
1910    void updateCursorsPositions() {
1911        if (mTextView.mCursorDrawableRes == 0) {
1912            mCursorCount = 0;
1913            return;
1914        }
1915
1916        Layout layout = mTextView.getLayout();
1917        final int offset = mTextView.getSelectionStart();
1918        final int line = layout.getLineForOffset(offset);
1919        final int top = layout.getLineTop(line);
1920        final int bottom = layout.getLineTop(line + 1);
1921
1922        mCursorCount = layout.isLevelBoundary(offset) ? 2 : 1;
1923
1924        int middle = bottom;
1925        if (mCursorCount == 2) {
1926            // Similar to what is done in {@link Layout.#getCursorPath(int, Path, CharSequence)}
1927            middle = (top + bottom) >> 1;
1928        }
1929
1930        boolean clamped = layout.shouldClampCursor(line);
1931        updateCursorPosition(0, top, middle, layout.getPrimaryHorizontal(offset, clamped));
1932
1933        if (mCursorCount == 2) {
1934            updateCursorPosition(1, middle, bottom, layout.getSecondaryHorizontal(offset, clamped));
1935        }
1936    }
1937
1938    void refreshTextActionMode() {
1939        if (extractedTextModeWillBeStarted()) {
1940            mRestartActionModeOnNextRefresh = false;
1941            return;
1942        }
1943        final boolean hasSelection = mTextView.hasSelection();
1944        final SelectionModifierCursorController selectionController = getSelectionController();
1945        final InsertionPointCursorController insertionController = getInsertionController();
1946        if ((selectionController != null && selectionController.isCursorBeingModified())
1947                || (insertionController != null && insertionController.isCursorBeingModified())) {
1948            // ActionMode should be managed by the currently active cursor controller.
1949            mRestartActionModeOnNextRefresh = false;
1950            return;
1951        }
1952        if (hasSelection) {
1953            hideInsertionPointCursorController();
1954            if (mTextActionMode == null) {
1955                if (mRestartActionModeOnNextRefresh) {
1956                    // To avoid distraction, newly start action mode only when selection action
1957                    // mode is being restarted.
1958                    startSelectionActionModeAsync(false);
1959                }
1960            } else if (selectionController == null || !selectionController.isActive()) {
1961                // Insertion action mode is active. Avoid dismissing the selection.
1962                stopTextActionModeWithPreservingSelection();
1963                startSelectionActionModeAsync(false);
1964            } else {
1965                mTextActionMode.invalidateContentRect();
1966            }
1967        } else {
1968            // Insertion action mode is started only when insertion controller is explicitly
1969            // activated.
1970            if (insertionController == null || !insertionController.isActive()) {
1971                stopTextActionMode();
1972            } else if (mTextActionMode != null) {
1973                mTextActionMode.invalidateContentRect();
1974            }
1975        }
1976        mRestartActionModeOnNextRefresh = false;
1977    }
1978
1979    /**
1980     * Start an Insertion action mode.
1981     */
1982    void startInsertionActionMode() {
1983        if (mInsertionActionModeRunnable != null) {
1984            mTextView.removeCallbacks(mInsertionActionModeRunnable);
1985        }
1986        if (extractedTextModeWillBeStarted()) {
1987            return;
1988        }
1989        stopTextActionMode();
1990
1991        ActionMode.Callback actionModeCallback =
1992                new TextActionModeCallback(false /* hasSelection */);
1993        mTextActionMode = mTextView.startActionMode(
1994                actionModeCallback, ActionMode.TYPE_FLOATING);
1995        if (mTextActionMode != null && getInsertionController() != null) {
1996            getInsertionController().show();
1997        }
1998    }
1999
2000    @NonNull
2001    TextView getTextView() {
2002        return mTextView;
2003    }
2004
2005    @Nullable
2006    ActionMode getTextActionMode() {
2007        return mTextActionMode;
2008    }
2009
2010    void setRestartActionModeOnNextRefresh(boolean value) {
2011        mRestartActionModeOnNextRefresh = value;
2012    }
2013
2014    /**
2015     * Asynchronously starts a selection action mode using the TextClassifier.
2016     */
2017    void startSelectionActionModeAsync(boolean adjustSelection) {
2018        getSelectionActionModeHelper().startActionModeAsync(adjustSelection);
2019    }
2020
2021    /**
2022     * Asynchronously invalidates an action mode using the TextClassifier.
2023     */
2024    void invalidateActionModeAsync() {
2025        getSelectionActionModeHelper().invalidateActionModeAsync();
2026    }
2027
2028    /**
2029     * Synchronously invalidates an action mode without the TextClassifier.
2030     */
2031    private void invalidateActionMode() {
2032        if (mTextActionMode != null) {
2033            mTextActionMode.invalidate();
2034        }
2035    }
2036
2037    private SelectionActionModeHelper getSelectionActionModeHelper() {
2038        if (mSelectionActionModeHelper == null) {
2039            mSelectionActionModeHelper = new SelectionActionModeHelper(this);
2040        }
2041        return mSelectionActionModeHelper;
2042    }
2043
2044    /**
2045     * If the TextView allows text selection, selects the current word when no existing selection
2046     * was available and starts a drag.
2047     *
2048     * @return true if the drag was started.
2049     */
2050    private boolean selectCurrentWordAndStartDrag() {
2051        if (mInsertionActionModeRunnable != null) {
2052            mTextView.removeCallbacks(mInsertionActionModeRunnable);
2053        }
2054        if (extractedTextModeWillBeStarted()) {
2055            return false;
2056        }
2057        if (!checkField()) {
2058            return false;
2059        }
2060        if (!mTextView.hasSelection() && !selectCurrentWord()) {
2061            // No selection and cannot select a word.
2062            return false;
2063        }
2064        stopTextActionModeWithPreservingSelection();
2065        getSelectionController().enterDrag(
2066                SelectionModifierCursorController.DRAG_ACCELERATOR_MODE_WORD);
2067        return true;
2068    }
2069
2070    /**
2071     * Checks whether a selection can be performed on the current TextView.
2072     *
2073     * @return true if a selection can be performed
2074     */
2075    boolean checkField() {
2076        if (!mTextView.canSelectText() || !mTextView.requestFocus()) {
2077            Log.w(TextView.LOG_TAG,
2078                    "TextView does not support text selection. Selection cancelled.");
2079            return false;
2080        }
2081        return true;
2082    }
2083
2084    boolean startSelectionActionModeInternal() {
2085        if (extractedTextModeWillBeStarted()) {
2086            return false;
2087        }
2088        if (mTextActionMode != null) {
2089            // Text action mode is already started
2090            invalidateActionMode();
2091            return false;
2092        }
2093
2094        if (!checkField() || !mTextView.hasSelection()) {
2095            return false;
2096        }
2097
2098        ActionMode.Callback actionModeCallback =
2099                new TextActionModeCallback(true /* hasSelection */);
2100        mTextActionMode = mTextView.startActionMode(actionModeCallback, ActionMode.TYPE_FLOATING);
2101
2102        final boolean selectionStarted = mTextActionMode != null;
2103        if (selectionStarted && !mTextView.isTextSelectable() && mShowSoftInputOnFocus) {
2104            // Show the IME to be able to replace text, except when selecting non editable text.
2105            final InputMethodManager imm = InputMethodManager.peekInstance();
2106            if (imm != null) {
2107                imm.showSoftInput(mTextView, 0, null);
2108            }
2109        }
2110        return selectionStarted;
2111    }
2112
2113    private boolean extractedTextModeWillBeStarted() {
2114        if (!(mTextView.isInExtractedMode())) {
2115            final InputMethodManager imm = InputMethodManager.peekInstance();
2116            return  imm != null && imm.isFullscreenMode();
2117        }
2118        return false;
2119    }
2120
2121    /**
2122     * @return <code>true</code> if it's reasonable to offer to show suggestions depending on
2123     * the current cursor position or selection range. This method is consistent with the
2124     * method to show suggestions {@link SuggestionsPopupWindow#updateSuggestions}.
2125     */
2126    private boolean shouldOfferToShowSuggestions() {
2127        CharSequence text = mTextView.getText();
2128        if (!(text instanceof Spannable)) return false;
2129
2130        final Spannable spannable = (Spannable) text;
2131        final int selectionStart = mTextView.getSelectionStart();
2132        final int selectionEnd = mTextView.getSelectionEnd();
2133        final SuggestionSpan[] suggestionSpans = spannable.getSpans(selectionStart, selectionEnd,
2134                SuggestionSpan.class);
2135        if (suggestionSpans.length == 0) {
2136            return false;
2137        }
2138        if (selectionStart == selectionEnd) {
2139            // Spans overlap the cursor.
2140            for (int i = 0; i < suggestionSpans.length; i++) {
2141                if (suggestionSpans[i].getSuggestions().length > 0) {
2142                    return true;
2143                }
2144            }
2145            return false;
2146        }
2147        int minSpanStart = mTextView.getText().length();
2148        int maxSpanEnd = 0;
2149        int unionOfSpansCoveringSelectionStartStart = mTextView.getText().length();
2150        int unionOfSpansCoveringSelectionStartEnd = 0;
2151        boolean hasValidSuggestions = false;
2152        for (int i = 0; i < suggestionSpans.length; i++) {
2153            final int spanStart = spannable.getSpanStart(suggestionSpans[i]);
2154            final int spanEnd = spannable.getSpanEnd(suggestionSpans[i]);
2155            minSpanStart = Math.min(minSpanStart, spanStart);
2156            maxSpanEnd = Math.max(maxSpanEnd, spanEnd);
2157            if (selectionStart < spanStart || selectionStart > spanEnd) {
2158                // The span doesn't cover the current selection start point.
2159                continue;
2160            }
2161            hasValidSuggestions =
2162                    hasValidSuggestions || suggestionSpans[i].getSuggestions().length > 0;
2163            unionOfSpansCoveringSelectionStartStart =
2164                    Math.min(unionOfSpansCoveringSelectionStartStart, spanStart);
2165            unionOfSpansCoveringSelectionStartEnd =
2166                    Math.max(unionOfSpansCoveringSelectionStartEnd, spanEnd);
2167        }
2168        if (!hasValidSuggestions) {
2169            return false;
2170        }
2171        if (unionOfSpansCoveringSelectionStartStart >= unionOfSpansCoveringSelectionStartEnd) {
2172            // No spans cover the selection start point.
2173            return false;
2174        }
2175        if (minSpanStart < unionOfSpansCoveringSelectionStartStart
2176                || maxSpanEnd > unionOfSpansCoveringSelectionStartEnd) {
2177            // There is a span that is not covered by the union. In this case, we soouldn't offer
2178            // to show suggestions as it's confusing.
2179            return false;
2180        }
2181        return true;
2182    }
2183
2184    /**
2185     * @return <code>true</code> if the cursor is inside an {@link SuggestionSpan} with
2186     * {@link SuggestionSpan#FLAG_EASY_CORRECT} set.
2187     */
2188    private boolean isCursorInsideEasyCorrectionSpan() {
2189        Spannable spannable = (Spannable) mTextView.getText();
2190        SuggestionSpan[] suggestionSpans = spannable.getSpans(mTextView.getSelectionStart(),
2191                mTextView.getSelectionEnd(), SuggestionSpan.class);
2192        for (int i = 0; i < suggestionSpans.length; i++) {
2193            if ((suggestionSpans[i].getFlags() & SuggestionSpan.FLAG_EASY_CORRECT) != 0) {
2194                return true;
2195            }
2196        }
2197        return false;
2198    }
2199
2200    void onTouchUpEvent(MotionEvent event) {
2201        if (getSelectionActionModeHelper().resetSelection(
2202                getTextView().getOffsetForPosition(event.getX(), event.getY()))) {
2203            return;
2204        }
2205
2206        boolean selectAllGotFocus = mSelectAllOnFocus && mTextView.didTouchFocusSelect();
2207        hideCursorAndSpanControllers();
2208        stopTextActionMode();
2209        CharSequence text = mTextView.getText();
2210        if (!selectAllGotFocus && text.length() > 0) {
2211            // Move cursor
2212            final int offset = mTextView.getOffsetForPosition(event.getX(), event.getY());
2213            Selection.setSelection((Spannable) text, offset);
2214            if (mSpellChecker != null) {
2215                // When the cursor moves, the word that was typed may need spell check
2216                mSpellChecker.onSelectionChanged();
2217            }
2218
2219            if (!extractedTextModeWillBeStarted()) {
2220                if (isCursorInsideEasyCorrectionSpan()) {
2221                    // Cancel the single tap delayed runnable.
2222                    if (mInsertionActionModeRunnable != null) {
2223                        mTextView.removeCallbacks(mInsertionActionModeRunnable);
2224                    }
2225
2226                    mShowSuggestionRunnable = new Runnable() {
2227                        public void run() {
2228                            replace();
2229                        }
2230                    };
2231                    // removeCallbacks is performed on every touch
2232                    mTextView.postDelayed(mShowSuggestionRunnable,
2233                            ViewConfiguration.getDoubleTapTimeout());
2234                } else if (hasInsertionController()) {
2235                    getInsertionController().show();
2236                }
2237            }
2238        }
2239    }
2240
2241    protected void stopTextActionMode() {
2242        if (mTextActionMode != null) {
2243            // This will hide the mSelectionModifierCursorController
2244            mTextActionMode.finish();
2245        }
2246    }
2247
2248    private void stopTextActionModeWithPreservingSelection() {
2249        if (mTextActionMode != null) {
2250            mRestartActionModeOnNextRefresh = true;
2251        }
2252        mPreserveSelection = true;
2253        stopTextActionMode();
2254        mPreserveSelection = false;
2255    }
2256
2257    /**
2258     * @return True if this view supports insertion handles.
2259     */
2260    boolean hasInsertionController() {
2261        return mInsertionControllerEnabled;
2262    }
2263
2264    /**
2265     * @return True if this view supports selection handles.
2266     */
2267    boolean hasSelectionController() {
2268        return mSelectionControllerEnabled;
2269    }
2270
2271    private InsertionPointCursorController getInsertionController() {
2272        if (!mInsertionControllerEnabled) {
2273            return null;
2274        }
2275
2276        if (mInsertionPointCursorController == null) {
2277            mInsertionPointCursorController = new InsertionPointCursorController();
2278
2279            final ViewTreeObserver observer = mTextView.getViewTreeObserver();
2280            observer.addOnTouchModeChangeListener(mInsertionPointCursorController);
2281        }
2282
2283        return mInsertionPointCursorController;
2284    }
2285
2286    @Nullable
2287    SelectionModifierCursorController getSelectionController() {
2288        if (!mSelectionControllerEnabled) {
2289            return null;
2290        }
2291
2292        if (mSelectionModifierCursorController == null) {
2293            mSelectionModifierCursorController = new SelectionModifierCursorController();
2294
2295            final ViewTreeObserver observer = mTextView.getViewTreeObserver();
2296            observer.addOnTouchModeChangeListener(mSelectionModifierCursorController);
2297        }
2298
2299        return mSelectionModifierCursorController;
2300    }
2301
2302    @VisibleForTesting
2303    public Drawable[] getCursorDrawable() {
2304        return mCursorDrawable;
2305    }
2306
2307    private void updateCursorPosition(int cursorIndex, int top, int bottom, float horizontal) {
2308        if (mCursorDrawable[cursorIndex] == null) {
2309            mCursorDrawable[cursorIndex] = mTextView.getContext().getDrawable(
2310                    mTextView.mCursorDrawableRes);
2311        }
2312        final Drawable drawable = mCursorDrawable[cursorIndex];
2313        final int left = clampHorizontalPosition(drawable, horizontal);
2314        final int width = drawable.getIntrinsicWidth();
2315        drawable.setBounds(left, top - mTempRect.top, left + width,
2316                bottom + mTempRect.bottom);
2317    }
2318
2319    /**
2320     * Return clamped position for the drawable. If the drawable is within the boundaries of the
2321     * view, then it is offset with the left padding of the cursor drawable. If the drawable is at
2322     * the beginning or the end of the text then its drawable edge is aligned with left or right of
2323     * the view boundary. If the drawable is null, horizontal parameter is aligned to left or right
2324     * of the view.
2325     *
2326     * @param drawable Drawable. Can be null.
2327     * @param horizontal Horizontal position for the drawable.
2328     * @return The clamped horizontal position for the drawable.
2329     */
2330    private int clampHorizontalPosition(@Nullable final Drawable drawable, float horizontal) {
2331        horizontal = Math.max(0.5f, horizontal - 0.5f);
2332        if (mTempRect == null) mTempRect = new Rect();
2333
2334        int drawableWidth = 0;
2335        if (drawable != null) {
2336            drawable.getPadding(mTempRect);
2337            drawableWidth = drawable.getIntrinsicWidth();
2338        } else {
2339            mTempRect.setEmpty();
2340        }
2341
2342        int scrollX = mTextView.getScrollX();
2343        float horizontalDiff = horizontal - scrollX;
2344        int viewClippedWidth = mTextView.getWidth() - mTextView.getCompoundPaddingLeft()
2345                - mTextView.getCompoundPaddingRight();
2346
2347        final int left;
2348        if (horizontalDiff >= (viewClippedWidth - 1f)) {
2349            // at the rightmost position
2350            left = viewClippedWidth + scrollX - (drawableWidth - mTempRect.right);
2351        } else if (Math.abs(horizontalDiff) <= 1f
2352                || (TextUtils.isEmpty(mTextView.getText())
2353                        && (TextView.VERY_WIDE - scrollX) <= (viewClippedWidth + 1f)
2354                        && horizontal <= 1f)) {
2355            // at the leftmost position
2356            left = scrollX - mTempRect.left;
2357        } else {
2358            left = (int) horizontal - mTempRect.left;
2359        }
2360        return left;
2361    }
2362
2363    /**
2364     * Called by the framework in response to a text auto-correction (such as fixing a typo using a
2365     * a dictionary) from the current input method, provided by it calling
2366     * {@link InputConnection#commitCorrection} InputConnection.commitCorrection()}. The default
2367     * implementation flashes the background of the corrected word to provide feedback to the user.
2368     *
2369     * @param info The auto correct info about the text that was corrected.
2370     */
2371    public void onCommitCorrection(CorrectionInfo info) {
2372        if (mCorrectionHighlighter == null) {
2373            mCorrectionHighlighter = new CorrectionHighlighter();
2374        } else {
2375            mCorrectionHighlighter.invalidate(false);
2376        }
2377
2378        mCorrectionHighlighter.highlight(info);
2379        mUndoInputFilter.freezeLastEdit();
2380    }
2381
2382    void onScrollChanged() {
2383        if (mPositionListener != null) {
2384            mPositionListener.onScrollChanged();
2385        }
2386        if (mTextActionMode != null) {
2387            mTextActionMode.invalidateContentRect();
2388        }
2389    }
2390
2391    /**
2392     * @return True when the TextView isFocused and has a valid zero-length selection (cursor).
2393     */
2394    private boolean shouldBlink() {
2395        if (!isCursorVisible() || !mTextView.isFocused()) return false;
2396
2397        final int start = mTextView.getSelectionStart();
2398        if (start < 0) return false;
2399
2400        final int end = mTextView.getSelectionEnd();
2401        if (end < 0) return false;
2402
2403        return start == end;
2404    }
2405
2406    void makeBlink() {
2407        if (shouldBlink()) {
2408            mShowCursor = SystemClock.uptimeMillis();
2409            if (mBlink == null) mBlink = new Blink();
2410            mTextView.removeCallbacks(mBlink);
2411            mTextView.postDelayed(mBlink, BLINK);
2412        } else {
2413            if (mBlink != null) mTextView.removeCallbacks(mBlink);
2414        }
2415    }
2416
2417    private class Blink implements Runnable {
2418        private boolean mCancelled;
2419
2420        public void run() {
2421            if (mCancelled) {
2422                return;
2423            }
2424
2425            mTextView.removeCallbacks(this);
2426
2427            if (shouldBlink()) {
2428                if (mTextView.getLayout() != null) {
2429                    mTextView.invalidateCursorPath();
2430                }
2431
2432                mTextView.postDelayed(this, BLINK);
2433            }
2434        }
2435
2436        void cancel() {
2437            if (!mCancelled) {
2438                mTextView.removeCallbacks(this);
2439                mCancelled = true;
2440            }
2441        }
2442
2443        void uncancel() {
2444            mCancelled = false;
2445        }
2446    }
2447
2448    private DragShadowBuilder getTextThumbnailBuilder(int start, int end) {
2449        TextView shadowView = (TextView) View.inflate(mTextView.getContext(),
2450                com.android.internal.R.layout.text_drag_thumbnail, null);
2451
2452        if (shadowView == null) {
2453            throw new IllegalArgumentException("Unable to inflate text drag thumbnail");
2454        }
2455
2456        if (end - start > DRAG_SHADOW_MAX_TEXT_LENGTH) {
2457            final long range = getCharClusterRange(start + DRAG_SHADOW_MAX_TEXT_LENGTH);
2458            end = TextUtils.unpackRangeEndFromLong(range);
2459        }
2460        final CharSequence text = mTextView.getTransformedText(start, end);
2461        shadowView.setText(text);
2462        shadowView.setTextColor(mTextView.getTextColors());
2463
2464        shadowView.setTextAppearance(R.styleable.Theme_textAppearanceLarge);
2465        shadowView.setGravity(Gravity.CENTER);
2466
2467        shadowView.setLayoutParams(new LayoutParams(ViewGroup.LayoutParams.WRAP_CONTENT,
2468                ViewGroup.LayoutParams.WRAP_CONTENT));
2469
2470        final int size = View.MeasureSpec.makeMeasureSpec(0, View.MeasureSpec.UNSPECIFIED);
2471        shadowView.measure(size, size);
2472
2473        shadowView.layout(0, 0, shadowView.getMeasuredWidth(), shadowView.getMeasuredHeight());
2474        shadowView.invalidate();
2475        return new DragShadowBuilder(shadowView);
2476    }
2477
2478    private static class DragLocalState {
2479        public TextView sourceTextView;
2480        public int start, end;
2481
2482        public DragLocalState(TextView sourceTextView, int start, int end) {
2483            this.sourceTextView = sourceTextView;
2484            this.start = start;
2485            this.end = end;
2486        }
2487    }
2488
2489    void onDrop(DragEvent event) {
2490        SpannableStringBuilder content = new SpannableStringBuilder();
2491
2492        final DragAndDropPermissions permissions = DragAndDropPermissions.obtain(event);
2493        if (permissions != null) {
2494            permissions.takeTransient();
2495        }
2496
2497        try {
2498            ClipData clipData = event.getClipData();
2499            final int itemCount = clipData.getItemCount();
2500            for (int i = 0; i < itemCount; i++) {
2501                Item item = clipData.getItemAt(i);
2502                content.append(item.coerceToStyledText(mTextView.getContext()));
2503            }
2504        } finally {
2505            if (permissions != null) {
2506                permissions.release();
2507            }
2508        }
2509
2510        mTextView.beginBatchEdit();
2511        mUndoInputFilter.freezeLastEdit();
2512        try {
2513            final int offset = mTextView.getOffsetForPosition(event.getX(), event.getY());
2514            Object localState = event.getLocalState();
2515            DragLocalState dragLocalState = null;
2516            if (localState instanceof DragLocalState) {
2517                dragLocalState = (DragLocalState) localState;
2518            }
2519            boolean dragDropIntoItself = dragLocalState != null
2520                    && dragLocalState.sourceTextView == mTextView;
2521
2522            if (dragDropIntoItself) {
2523                if (offset >= dragLocalState.start && offset < dragLocalState.end) {
2524                    // A drop inside the original selection discards the drop.
2525                    return;
2526                }
2527            }
2528
2529            final int originalLength = mTextView.getText().length();
2530            int min = offset;
2531            int max = offset;
2532
2533            Selection.setSelection((Spannable) mTextView.getText(), max);
2534            mTextView.replaceText_internal(min, max, content);
2535
2536            if (dragDropIntoItself) {
2537                int dragSourceStart = dragLocalState.start;
2538                int dragSourceEnd = dragLocalState.end;
2539                if (max <= dragSourceStart) {
2540                    // Inserting text before selection has shifted positions
2541                    final int shift = mTextView.getText().length() - originalLength;
2542                    dragSourceStart += shift;
2543                    dragSourceEnd += shift;
2544                }
2545
2546                // Delete original selection
2547                mTextView.deleteText_internal(dragSourceStart, dragSourceEnd);
2548
2549                // Make sure we do not leave two adjacent spaces.
2550                final int prevCharIdx = Math.max(0,  dragSourceStart - 1);
2551                final int nextCharIdx = Math.min(mTextView.getText().length(), dragSourceStart + 1);
2552                if (nextCharIdx > prevCharIdx + 1) {
2553                    CharSequence t = mTextView.getTransformedText(prevCharIdx, nextCharIdx);
2554                    if (Character.isSpaceChar(t.charAt(0)) && Character.isSpaceChar(t.charAt(1))) {
2555                        mTextView.deleteText_internal(prevCharIdx, prevCharIdx + 1);
2556                    }
2557                }
2558            }
2559        } finally {
2560            mTextView.endBatchEdit();
2561            mUndoInputFilter.freezeLastEdit();
2562        }
2563    }
2564
2565    public void addSpanWatchers(Spannable text) {
2566        final int textLength = text.length();
2567
2568        if (mKeyListener != null) {
2569            text.setSpan(mKeyListener, 0, textLength, Spanned.SPAN_INCLUSIVE_INCLUSIVE);
2570        }
2571
2572        if (mSpanController == null) {
2573            mSpanController = new SpanController();
2574        }
2575        text.setSpan(mSpanController, 0, textLength, Spanned.SPAN_INCLUSIVE_INCLUSIVE);
2576    }
2577
2578    void setContextMenuAnchor(float x, float y) {
2579        mContextMenuAnchorX = x;
2580        mContextMenuAnchorY = y;
2581    }
2582
2583    void onCreateContextMenu(ContextMenu menu) {
2584        if (mIsBeingLongClicked || Float.isNaN(mContextMenuAnchorX)
2585                || Float.isNaN(mContextMenuAnchorY)) {
2586            return;
2587        }
2588        final int offset = mTextView.getOffsetForPosition(mContextMenuAnchorX, mContextMenuAnchorY);
2589        if (offset == -1) {
2590            return;
2591        }
2592
2593        stopTextActionModeWithPreservingSelection();
2594        if (mTextView.canSelectText()) {
2595            final boolean isOnSelection = mTextView.hasSelection()
2596                    && offset >= mTextView.getSelectionStart()
2597                    && offset <= mTextView.getSelectionEnd();
2598            if (!isOnSelection) {
2599                // Right clicked position is not on the selection. Remove the selection and move the
2600                // cursor to the right clicked position.
2601                Selection.setSelection((Spannable) mTextView.getText(), offset);
2602                stopTextActionMode();
2603            }
2604        }
2605
2606        if (shouldOfferToShowSuggestions()) {
2607            final SuggestionInfo[] suggestionInfoArray =
2608                    new SuggestionInfo[SuggestionSpan.SUGGESTIONS_MAX_SIZE];
2609            for (int i = 0; i < suggestionInfoArray.length; i++) {
2610                suggestionInfoArray[i] = new SuggestionInfo();
2611            }
2612            final SubMenu subMenu = menu.addSubMenu(Menu.NONE, Menu.NONE, MENU_ITEM_ORDER_REPLACE,
2613                    com.android.internal.R.string.replace);
2614            final int numItems = mSuggestionHelper.getSuggestionInfo(suggestionInfoArray, null);
2615            for (int i = 0; i < numItems; i++) {
2616                final SuggestionInfo info = suggestionInfoArray[i];
2617                subMenu.add(Menu.NONE, Menu.NONE, i, info.mText)
2618                        .setOnMenuItemClickListener(new MenuItem.OnMenuItemClickListener() {
2619                            @Override
2620                            public boolean onMenuItemClick(MenuItem item) {
2621                                replaceWithSuggestion(info);
2622                                return true;
2623                            }
2624                        });
2625            }
2626        }
2627
2628        menu.add(Menu.NONE, TextView.ID_UNDO, MENU_ITEM_ORDER_UNDO,
2629                com.android.internal.R.string.undo)
2630                .setAlphabeticShortcut('z')
2631                .setOnMenuItemClickListener(mOnContextMenuItemClickListener)
2632                .setEnabled(mTextView.canUndo());
2633        menu.add(Menu.NONE, TextView.ID_REDO, MENU_ITEM_ORDER_REDO,
2634                com.android.internal.R.string.redo)
2635                .setOnMenuItemClickListener(mOnContextMenuItemClickListener)
2636                .setEnabled(mTextView.canRedo());
2637
2638        menu.add(Menu.NONE, TextView.ID_CUT, MENU_ITEM_ORDER_CUT,
2639                com.android.internal.R.string.cut)
2640                .setAlphabeticShortcut('x')
2641                .setOnMenuItemClickListener(mOnContextMenuItemClickListener)
2642                .setEnabled(mTextView.canCut());
2643        menu.add(Menu.NONE, TextView.ID_COPY, MENU_ITEM_ORDER_COPY,
2644                com.android.internal.R.string.copy)
2645                .setAlphabeticShortcut('c')
2646                .setOnMenuItemClickListener(mOnContextMenuItemClickListener)
2647                .setEnabled(mTextView.canCopy());
2648        menu.add(Menu.NONE, TextView.ID_PASTE, MENU_ITEM_ORDER_PASTE,
2649                com.android.internal.R.string.paste)
2650                .setAlphabeticShortcut('v')
2651                .setEnabled(mTextView.canPaste())
2652                .setOnMenuItemClickListener(mOnContextMenuItemClickListener);
2653        menu.add(Menu.NONE, TextView.ID_PASTE_AS_PLAIN_TEXT, MENU_ITEM_ORDER_PASTE_AS_PLAIN_TEXT,
2654                com.android.internal.R.string.paste_as_plain_text)
2655                .setEnabled(mTextView.canPasteAsPlainText())
2656                .setOnMenuItemClickListener(mOnContextMenuItemClickListener);
2657        menu.add(Menu.NONE, TextView.ID_SHARE, MENU_ITEM_ORDER_SHARE,
2658                com.android.internal.R.string.share)
2659                .setEnabled(mTextView.canShare())
2660                .setOnMenuItemClickListener(mOnContextMenuItemClickListener);
2661        menu.add(Menu.NONE, TextView.ID_SELECT_ALL, MENU_ITEM_ORDER_SELECT_ALL,
2662                com.android.internal.R.string.selectAll)
2663                .setAlphabeticShortcut('a')
2664                .setEnabled(mTextView.canSelectAllText())
2665                .setOnMenuItemClickListener(mOnContextMenuItemClickListener);
2666        menu.add(Menu.NONE, TextView.ID_AUTOFILL, MENU_ITEM_ORDER_AUTOFILL,
2667                android.R.string.autofill)
2668                .setEnabled(mTextView.canRequestAutofill())
2669                .setOnMenuItemClickListener(mOnContextMenuItemClickListener);
2670
2671        mPreserveSelection = true;
2672    }
2673
2674    @Nullable
2675    private SuggestionSpan findEquivalentSuggestionSpan(
2676            @NonNull SuggestionSpanInfo suggestionSpanInfo) {
2677        final Editable editable = (Editable) mTextView.getText();
2678        if (editable.getSpanStart(suggestionSpanInfo.mSuggestionSpan) >= 0) {
2679            // Exactly same span is found.
2680            return suggestionSpanInfo.mSuggestionSpan;
2681        }
2682        // Suggestion span couldn't be found. Try to find a suggestion span that has the same
2683        // contents.
2684        final SuggestionSpan[] suggestionSpans = editable.getSpans(suggestionSpanInfo.mSpanStart,
2685                suggestionSpanInfo.mSpanEnd, SuggestionSpan.class);
2686        for (final SuggestionSpan suggestionSpan : suggestionSpans) {
2687            final int start = editable.getSpanStart(suggestionSpan);
2688            if (start != suggestionSpanInfo.mSpanStart) {
2689                continue;
2690            }
2691            final int end = editable.getSpanEnd(suggestionSpan);
2692            if (end != suggestionSpanInfo.mSpanEnd) {
2693                continue;
2694            }
2695            if (suggestionSpan.equals(suggestionSpanInfo.mSuggestionSpan)) {
2696                return suggestionSpan;
2697            }
2698        }
2699        return null;
2700    }
2701
2702    private void replaceWithSuggestion(@NonNull final SuggestionInfo suggestionInfo) {
2703        final SuggestionSpan targetSuggestionSpan = findEquivalentSuggestionSpan(
2704                suggestionInfo.mSuggestionSpanInfo);
2705        if (targetSuggestionSpan == null) {
2706            // Span has been removed
2707            return;
2708        }
2709        final Editable editable = (Editable) mTextView.getText();
2710        final int spanStart = editable.getSpanStart(targetSuggestionSpan);
2711        final int spanEnd = editable.getSpanEnd(targetSuggestionSpan);
2712        if (spanStart < 0 || spanEnd <= spanStart) {
2713            // Span has been removed
2714            return;
2715        }
2716
2717        final String originalText = TextUtils.substring(editable, spanStart, spanEnd);
2718        // SuggestionSpans are removed by replace: save them before
2719        SuggestionSpan[] suggestionSpans = editable.getSpans(spanStart, spanEnd,
2720                SuggestionSpan.class);
2721        final int length = suggestionSpans.length;
2722        int[] suggestionSpansStarts = new int[length];
2723        int[] suggestionSpansEnds = new int[length];
2724        int[] suggestionSpansFlags = new int[length];
2725        for (int i = 0; i < length; i++) {
2726            final SuggestionSpan suggestionSpan = suggestionSpans[i];
2727            suggestionSpansStarts[i] = editable.getSpanStart(suggestionSpan);
2728            suggestionSpansEnds[i] = editable.getSpanEnd(suggestionSpan);
2729            suggestionSpansFlags[i] = editable.getSpanFlags(suggestionSpan);
2730
2731            // Remove potential misspelled flags
2732            int suggestionSpanFlags = suggestionSpan.getFlags();
2733            if ((suggestionSpanFlags & SuggestionSpan.FLAG_MISSPELLED) != 0) {
2734                suggestionSpanFlags &= ~SuggestionSpan.FLAG_MISSPELLED;
2735                suggestionSpanFlags &= ~SuggestionSpan.FLAG_EASY_CORRECT;
2736                suggestionSpan.setFlags(suggestionSpanFlags);
2737            }
2738        }
2739
2740        // Notify source IME of the suggestion pick. Do this before swapping texts.
2741        targetSuggestionSpan.notifySelection(
2742                mTextView.getContext(), originalText, suggestionInfo.mSuggestionIndex);
2743
2744        // Swap text content between actual text and Suggestion span
2745        final int suggestionStart = suggestionInfo.mSuggestionStart;
2746        final int suggestionEnd = suggestionInfo.mSuggestionEnd;
2747        final String suggestion = suggestionInfo.mText.subSequence(
2748                suggestionStart, suggestionEnd).toString();
2749        mTextView.replaceText_internal(spanStart, spanEnd, suggestion);
2750
2751        String[] suggestions = targetSuggestionSpan.getSuggestions();
2752        suggestions[suggestionInfo.mSuggestionIndex] = originalText;
2753
2754        // Restore previous SuggestionSpans
2755        final int lengthDelta = suggestion.length() - (spanEnd - spanStart);
2756        for (int i = 0; i < length; i++) {
2757            // Only spans that include the modified region make sense after replacement
2758            // Spans partially included in the replaced region are removed, there is no
2759            // way to assign them a valid range after replacement
2760            if (suggestionSpansStarts[i] <= spanStart && suggestionSpansEnds[i] >= spanEnd) {
2761                mTextView.setSpan_internal(suggestionSpans[i], suggestionSpansStarts[i],
2762                        suggestionSpansEnds[i] + lengthDelta, suggestionSpansFlags[i]);
2763            }
2764        }
2765        // Move cursor at the end of the replaced word
2766        final int newCursorPosition = spanEnd + lengthDelta;
2767        mTextView.setCursorPosition_internal(newCursorPosition, newCursorPosition);
2768    }
2769
2770    private final MenuItem.OnMenuItemClickListener mOnContextMenuItemClickListener =
2771            new MenuItem.OnMenuItemClickListener() {
2772        @Override
2773        public boolean onMenuItemClick(MenuItem item) {
2774            if (mProcessTextIntentActionsHandler.performMenuItemAction(item)) {
2775                return true;
2776            }
2777            return mTextView.onTextContextMenuItem(item.getItemId());
2778        }
2779    };
2780
2781    /**
2782     * Controls the {@link EasyEditSpan} monitoring when it is added, and when the related
2783     * pop-up should be displayed.
2784     * Also monitors {@link Selection} to call back to the attached input method.
2785     */
2786    private class SpanController implements SpanWatcher {
2787
2788        private static final int DISPLAY_TIMEOUT_MS = 3000; // 3 secs
2789
2790        private EasyEditPopupWindow mPopupWindow;
2791
2792        private Runnable mHidePopup;
2793
2794        // This function is pure but inner classes can't have static functions
2795        private boolean isNonIntermediateSelectionSpan(final Spannable text,
2796                final Object span) {
2797            return (Selection.SELECTION_START == span || Selection.SELECTION_END == span)
2798                    && (text.getSpanFlags(span) & Spanned.SPAN_INTERMEDIATE) == 0;
2799        }
2800
2801        @Override
2802        public void onSpanAdded(Spannable text, Object span, int start, int end) {
2803            if (isNonIntermediateSelectionSpan(text, span)) {
2804                sendUpdateSelection();
2805            } else if (span instanceof EasyEditSpan) {
2806                if (mPopupWindow == null) {
2807                    mPopupWindow = new EasyEditPopupWindow();
2808                    mHidePopup = new Runnable() {
2809                        @Override
2810                        public void run() {
2811                            hide();
2812                        }
2813                    };
2814                }
2815
2816                // Make sure there is only at most one EasyEditSpan in the text
2817                if (mPopupWindow.mEasyEditSpan != null) {
2818                    mPopupWindow.mEasyEditSpan.setDeleteEnabled(false);
2819                }
2820
2821                mPopupWindow.setEasyEditSpan((EasyEditSpan) span);
2822                mPopupWindow.setOnDeleteListener(new EasyEditDeleteListener() {
2823                    @Override
2824                    public void onDeleteClick(EasyEditSpan span) {
2825                        Editable editable = (Editable) mTextView.getText();
2826                        int start = editable.getSpanStart(span);
2827                        int end = editable.getSpanEnd(span);
2828                        if (start >= 0 && end >= 0) {
2829                            sendEasySpanNotification(EasyEditSpan.TEXT_DELETED, span);
2830                            mTextView.deleteText_internal(start, end);
2831                        }
2832                        editable.removeSpan(span);
2833                    }
2834                });
2835
2836                if (mTextView.getWindowVisibility() != View.VISIBLE) {
2837                    // The window is not visible yet, ignore the text change.
2838                    return;
2839                }
2840
2841                if (mTextView.getLayout() == null) {
2842                    // The view has not been laid out yet, ignore the text change
2843                    return;
2844                }
2845
2846                if (extractedTextModeWillBeStarted()) {
2847                    // The input is in extract mode. Do not handle the easy edit in
2848                    // the original TextView, as the ExtractEditText will do
2849                    return;
2850                }
2851
2852                mPopupWindow.show();
2853                mTextView.removeCallbacks(mHidePopup);
2854                mTextView.postDelayed(mHidePopup, DISPLAY_TIMEOUT_MS);
2855            }
2856        }
2857
2858        @Override
2859        public void onSpanRemoved(Spannable text, Object span, int start, int end) {
2860            if (isNonIntermediateSelectionSpan(text, span)) {
2861                sendUpdateSelection();
2862            } else if (mPopupWindow != null && span == mPopupWindow.mEasyEditSpan) {
2863                hide();
2864            }
2865        }
2866
2867        @Override
2868        public void onSpanChanged(Spannable text, Object span, int previousStart, int previousEnd,
2869                int newStart, int newEnd) {
2870            if (isNonIntermediateSelectionSpan(text, span)) {
2871                sendUpdateSelection();
2872            } else if (mPopupWindow != null && span instanceof EasyEditSpan) {
2873                EasyEditSpan easyEditSpan = (EasyEditSpan) span;
2874                sendEasySpanNotification(EasyEditSpan.TEXT_MODIFIED, easyEditSpan);
2875                text.removeSpan(easyEditSpan);
2876            }
2877        }
2878
2879        public void hide() {
2880            if (mPopupWindow != null) {
2881                mPopupWindow.hide();
2882                mTextView.removeCallbacks(mHidePopup);
2883            }
2884        }
2885
2886        private void sendEasySpanNotification(int textChangedType, EasyEditSpan span) {
2887            try {
2888                PendingIntent pendingIntent = span.getPendingIntent();
2889                if (pendingIntent != null) {
2890                    Intent intent = new Intent();
2891                    intent.putExtra(EasyEditSpan.EXTRA_TEXT_CHANGED_TYPE, textChangedType);
2892                    pendingIntent.send(mTextView.getContext(), 0, intent);
2893                }
2894            } catch (CanceledException e) {
2895                // This should not happen, as we should try to send the intent only once.
2896                Log.w(TAG, "PendingIntent for notification cannot be sent", e);
2897            }
2898        }
2899    }
2900
2901    /**
2902     * Listens for the delete event triggered by {@link EasyEditPopupWindow}.
2903     */
2904    private interface EasyEditDeleteListener {
2905
2906        /**
2907         * Clicks the delete pop-up.
2908         */
2909        void onDeleteClick(EasyEditSpan span);
2910    }
2911
2912    /**
2913     * Displays the actions associated to an {@link EasyEditSpan}. The pop-up is controlled
2914     * by {@link SpanController}.
2915     */
2916    private class EasyEditPopupWindow extends PinnedPopupWindow
2917            implements OnClickListener {
2918        private static final int POPUP_TEXT_LAYOUT =
2919                com.android.internal.R.layout.text_edit_action_popup_text;
2920        private TextView mDeleteTextView;
2921        private EasyEditSpan mEasyEditSpan;
2922        private EasyEditDeleteListener mOnDeleteListener;
2923
2924        @Override
2925        protected void createPopupWindow() {
2926            mPopupWindow = new PopupWindow(mTextView.getContext(), null,
2927                    com.android.internal.R.attr.textSelectHandleWindowStyle);
2928            mPopupWindow.setInputMethodMode(PopupWindow.INPUT_METHOD_NOT_NEEDED);
2929            mPopupWindow.setClippingEnabled(true);
2930        }
2931
2932        @Override
2933        protected void initContentView() {
2934            LinearLayout linearLayout = new LinearLayout(mTextView.getContext());
2935            linearLayout.setOrientation(LinearLayout.HORIZONTAL);
2936            mContentView = linearLayout;
2937            mContentView.setBackgroundResource(
2938                    com.android.internal.R.drawable.text_edit_side_paste_window);
2939
2940            LayoutInflater inflater = (LayoutInflater) mTextView.getContext()
2941                    .getSystemService(Context.LAYOUT_INFLATER_SERVICE);
2942
2943            LayoutParams wrapContent = new LayoutParams(
2944                    ViewGroup.LayoutParams.WRAP_CONTENT, ViewGroup.LayoutParams.WRAP_CONTENT);
2945
2946            mDeleteTextView = (TextView) inflater.inflate(POPUP_TEXT_LAYOUT, null);
2947            mDeleteTextView.setLayoutParams(wrapContent);
2948            mDeleteTextView.setText(com.android.internal.R.string.delete);
2949            mDeleteTextView.setOnClickListener(this);
2950            mContentView.addView(mDeleteTextView);
2951        }
2952
2953        public void setEasyEditSpan(EasyEditSpan easyEditSpan) {
2954            mEasyEditSpan = easyEditSpan;
2955        }
2956
2957        private void setOnDeleteListener(EasyEditDeleteListener listener) {
2958            mOnDeleteListener = listener;
2959        }
2960
2961        @Override
2962        public void onClick(View view) {
2963            if (view == mDeleteTextView
2964                    && mEasyEditSpan != null && mEasyEditSpan.isDeleteEnabled()
2965                    && mOnDeleteListener != null) {
2966                mOnDeleteListener.onDeleteClick(mEasyEditSpan);
2967            }
2968        }
2969
2970        @Override
2971        public void hide() {
2972            if (mEasyEditSpan != null) {
2973                mEasyEditSpan.setDeleteEnabled(false);
2974            }
2975            mOnDeleteListener = null;
2976            super.hide();
2977        }
2978
2979        @Override
2980        protected int getTextOffset() {
2981            // Place the pop-up at the end of the span
2982            Editable editable = (Editable) mTextView.getText();
2983            return editable.getSpanEnd(mEasyEditSpan);
2984        }
2985
2986        @Override
2987        protected int getVerticalLocalPosition(int line) {
2988            return mTextView.getLayout().getLineBottom(line);
2989        }
2990
2991        @Override
2992        protected int clipVertically(int positionY) {
2993            // As we display the pop-up below the span, no vertical clipping is required.
2994            return positionY;
2995        }
2996    }
2997
2998    private class PositionListener implements ViewTreeObserver.OnPreDrawListener {
2999        // 3 handles
3000        // 3 ActionPopup [replace, suggestion, easyedit] (suggestionsPopup first hides the others)
3001        // 1 CursorAnchorInfoNotifier
3002        private static final int MAXIMUM_NUMBER_OF_LISTENERS = 7;
3003        private TextViewPositionListener[] mPositionListeners =
3004                new TextViewPositionListener[MAXIMUM_NUMBER_OF_LISTENERS];
3005        private boolean[] mCanMove = new boolean[MAXIMUM_NUMBER_OF_LISTENERS];
3006        private boolean mPositionHasChanged = true;
3007        // Absolute position of the TextView with respect to its parent window
3008        private int mPositionX, mPositionY;
3009        private int mPositionXOnScreen, mPositionYOnScreen;
3010        private int mNumberOfListeners;
3011        private boolean mScrollHasChanged;
3012        final int[] mTempCoords = new int[2];
3013
3014        public void addSubscriber(TextViewPositionListener positionListener, boolean canMove) {
3015            if (mNumberOfListeners == 0) {
3016                updatePosition();
3017                ViewTreeObserver vto = mTextView.getViewTreeObserver();
3018                vto.addOnPreDrawListener(this);
3019            }
3020
3021            int emptySlotIndex = -1;
3022            for (int i = 0; i < MAXIMUM_NUMBER_OF_LISTENERS; i++) {
3023                TextViewPositionListener listener = mPositionListeners[i];
3024                if (listener == positionListener) {
3025                    return;
3026                } else if (emptySlotIndex < 0 && listener == null) {
3027                    emptySlotIndex = i;
3028                }
3029            }
3030
3031            mPositionListeners[emptySlotIndex] = positionListener;
3032            mCanMove[emptySlotIndex] = canMove;
3033            mNumberOfListeners++;
3034        }
3035
3036        public void removeSubscriber(TextViewPositionListener positionListener) {
3037            for (int i = 0; i < MAXIMUM_NUMBER_OF_LISTENERS; i++) {
3038                if (mPositionListeners[i] == positionListener) {
3039                    mPositionListeners[i] = null;
3040                    mNumberOfListeners--;
3041                    break;
3042                }
3043            }
3044
3045            if (mNumberOfListeners == 0) {
3046                ViewTreeObserver vto = mTextView.getViewTreeObserver();
3047                vto.removeOnPreDrawListener(this);
3048            }
3049        }
3050
3051        public int getPositionX() {
3052            return mPositionX;
3053        }
3054
3055        public int getPositionY() {
3056            return mPositionY;
3057        }
3058
3059        public int getPositionXOnScreen() {
3060            return mPositionXOnScreen;
3061        }
3062
3063        public int getPositionYOnScreen() {
3064            return mPositionYOnScreen;
3065        }
3066
3067        @Override
3068        public boolean onPreDraw() {
3069            updatePosition();
3070
3071            for (int i = 0; i < MAXIMUM_NUMBER_OF_LISTENERS; i++) {
3072                if (mPositionHasChanged || mScrollHasChanged || mCanMove[i]) {
3073                    TextViewPositionListener positionListener = mPositionListeners[i];
3074                    if (positionListener != null) {
3075                        positionListener.updatePosition(mPositionX, mPositionY,
3076                                mPositionHasChanged, mScrollHasChanged);
3077                    }
3078                }
3079            }
3080
3081            mScrollHasChanged = false;
3082            return true;
3083        }
3084
3085        private void updatePosition() {
3086            mTextView.getLocationInWindow(mTempCoords);
3087
3088            mPositionHasChanged = mTempCoords[0] != mPositionX || mTempCoords[1] != mPositionY;
3089
3090            mPositionX = mTempCoords[0];
3091            mPositionY = mTempCoords[1];
3092
3093            mTextView.getLocationOnScreen(mTempCoords);
3094
3095            mPositionXOnScreen = mTempCoords[0];
3096            mPositionYOnScreen = mTempCoords[1];
3097        }
3098
3099        public void onScrollChanged() {
3100            mScrollHasChanged = true;
3101        }
3102    }
3103
3104    private abstract class PinnedPopupWindow implements TextViewPositionListener {
3105        protected PopupWindow mPopupWindow;
3106        protected ViewGroup mContentView;
3107        int mPositionX, mPositionY;
3108        int mClippingLimitLeft, mClippingLimitRight;
3109
3110        protected abstract void createPopupWindow();
3111        protected abstract void initContentView();
3112        protected abstract int getTextOffset();
3113        protected abstract int getVerticalLocalPosition(int line);
3114        protected abstract int clipVertically(int positionY);
3115        protected void setUp() {
3116        }
3117
3118        public PinnedPopupWindow() {
3119            // Due to calling subclass methods in base constructor, subclass constructor is not
3120            // called before subclass methods, e.g. createPopupWindow or initContentView. To give
3121            // a chance to initialize subclasses, call setUp() method here.
3122            // TODO: It is good to extract non trivial initialization code from constructor.
3123            setUp();
3124
3125            createPopupWindow();
3126
3127            mPopupWindow.setWindowLayoutType(
3128                    WindowManager.LayoutParams.TYPE_APPLICATION_ABOVE_SUB_PANEL);
3129            mPopupWindow.setWidth(ViewGroup.LayoutParams.WRAP_CONTENT);
3130            mPopupWindow.setHeight(ViewGroup.LayoutParams.WRAP_CONTENT);
3131
3132            initContentView();
3133
3134            LayoutParams wrapContent = new LayoutParams(ViewGroup.LayoutParams.WRAP_CONTENT,
3135                    ViewGroup.LayoutParams.WRAP_CONTENT);
3136            mContentView.setLayoutParams(wrapContent);
3137
3138            mPopupWindow.setContentView(mContentView);
3139        }
3140
3141        public void show() {
3142            getPositionListener().addSubscriber(this, false /* offset is fixed */);
3143
3144            computeLocalPosition();
3145
3146            final PositionListener positionListener = getPositionListener();
3147            updatePosition(positionListener.getPositionX(), positionListener.getPositionY());
3148        }
3149
3150        protected void measureContent() {
3151            final DisplayMetrics displayMetrics = mTextView.getResources().getDisplayMetrics();
3152            mContentView.measure(
3153                    View.MeasureSpec.makeMeasureSpec(displayMetrics.widthPixels,
3154                            View.MeasureSpec.AT_MOST),
3155                    View.MeasureSpec.makeMeasureSpec(displayMetrics.heightPixels,
3156                            View.MeasureSpec.AT_MOST));
3157        }
3158
3159        /* The popup window will be horizontally centered on the getTextOffset() and vertically
3160         * positioned according to viewportToContentHorizontalOffset.
3161         *
3162         * This method assumes that mContentView has properly been measured from its content. */
3163        private void computeLocalPosition() {
3164            measureContent();
3165            final int width = mContentView.getMeasuredWidth();
3166            final int offset = getTextOffset();
3167            mPositionX = (int) (mTextView.getLayout().getPrimaryHorizontal(offset) - width / 2.0f);
3168            mPositionX += mTextView.viewportToContentHorizontalOffset();
3169
3170            final int line = mTextView.getLayout().getLineForOffset(offset);
3171            mPositionY = getVerticalLocalPosition(line);
3172            mPositionY += mTextView.viewportToContentVerticalOffset();
3173        }
3174
3175        private void updatePosition(int parentPositionX, int parentPositionY) {
3176            int positionX = parentPositionX + mPositionX;
3177            int positionY = parentPositionY + mPositionY;
3178
3179            positionY = clipVertically(positionY);
3180
3181            // Horizontal clipping
3182            final DisplayMetrics displayMetrics = mTextView.getResources().getDisplayMetrics();
3183            final int width = mContentView.getMeasuredWidth();
3184            positionX = Math.min(
3185                    displayMetrics.widthPixels - width + mClippingLimitRight, positionX);
3186            positionX = Math.max(-mClippingLimitLeft, positionX);
3187
3188            if (isShowing()) {
3189                mPopupWindow.update(positionX, positionY, -1, -1);
3190            } else {
3191                mPopupWindow.showAtLocation(mTextView, Gravity.NO_GRAVITY,
3192                        positionX, positionY);
3193            }
3194        }
3195
3196        public void hide() {
3197            if (!isShowing()) {
3198                return;
3199            }
3200            mPopupWindow.dismiss();
3201            getPositionListener().removeSubscriber(this);
3202        }
3203
3204        @Override
3205        public void updatePosition(int parentPositionX, int parentPositionY,
3206                boolean parentPositionChanged, boolean parentScrolled) {
3207            // Either parentPositionChanged or parentScrolled is true, check if still visible
3208            if (isShowing() && isOffsetVisible(getTextOffset())) {
3209                if (parentScrolled) computeLocalPosition();
3210                updatePosition(parentPositionX, parentPositionY);
3211            } else {
3212                hide();
3213            }
3214        }
3215
3216        public boolean isShowing() {
3217            return mPopupWindow.isShowing();
3218        }
3219    }
3220
3221    private static final class SuggestionInfo {
3222        // Range of actual suggestion within mText
3223        int mSuggestionStart, mSuggestionEnd;
3224
3225        // The SuggestionSpan that this TextView represents
3226        final SuggestionSpanInfo mSuggestionSpanInfo = new SuggestionSpanInfo();
3227
3228        // The index of this suggestion inside suggestionSpan
3229        int mSuggestionIndex;
3230
3231        final SpannableStringBuilder mText = new SpannableStringBuilder();
3232
3233        void clear() {
3234            mSuggestionSpanInfo.clear();
3235            mText.clear();
3236        }
3237
3238        // Utility method to set attributes about a SuggestionSpan.
3239        void setSpanInfo(SuggestionSpan span, int spanStart, int spanEnd) {
3240            mSuggestionSpanInfo.mSuggestionSpan = span;
3241            mSuggestionSpanInfo.mSpanStart = spanStart;
3242            mSuggestionSpanInfo.mSpanEnd = spanEnd;
3243        }
3244    }
3245
3246    private static final class SuggestionSpanInfo {
3247        // The SuggestionSpan;
3248        @Nullable
3249        SuggestionSpan mSuggestionSpan;
3250
3251        // The SuggestionSpan start position
3252        int mSpanStart;
3253
3254        // The SuggestionSpan end position
3255        int mSpanEnd;
3256
3257        void clear() {
3258            mSuggestionSpan = null;
3259        }
3260    }
3261
3262    private class SuggestionHelper {
3263        private final Comparator<SuggestionSpan> mSuggestionSpanComparator =
3264                new SuggestionSpanComparator();
3265        private final HashMap<SuggestionSpan, Integer> mSpansLengths =
3266                new HashMap<SuggestionSpan, Integer>();
3267
3268        private class SuggestionSpanComparator implements Comparator<SuggestionSpan> {
3269            public int compare(SuggestionSpan span1, SuggestionSpan span2) {
3270                final int flag1 = span1.getFlags();
3271                final int flag2 = span2.getFlags();
3272                if (flag1 != flag2) {
3273                    // The order here should match what is used in updateDrawState
3274                    final boolean easy1 = (flag1 & SuggestionSpan.FLAG_EASY_CORRECT) != 0;
3275                    final boolean easy2 = (flag2 & SuggestionSpan.FLAG_EASY_CORRECT) != 0;
3276                    final boolean misspelled1 = (flag1 & SuggestionSpan.FLAG_MISSPELLED) != 0;
3277                    final boolean misspelled2 = (flag2 & SuggestionSpan.FLAG_MISSPELLED) != 0;
3278                    if (easy1 && !misspelled1) return -1;
3279                    if (easy2 && !misspelled2) return 1;
3280                    if (misspelled1) return -1;
3281                    if (misspelled2) return 1;
3282                }
3283
3284                return mSpansLengths.get(span1).intValue() - mSpansLengths.get(span2).intValue();
3285            }
3286        }
3287
3288        /**
3289         * Returns the suggestion spans that cover the current cursor position. The suggestion
3290         * spans are sorted according to the length of text that they are attached to.
3291         */
3292        private SuggestionSpan[] getSortedSuggestionSpans() {
3293            int pos = mTextView.getSelectionStart();
3294            Spannable spannable = (Spannable) mTextView.getText();
3295            SuggestionSpan[] suggestionSpans = spannable.getSpans(pos, pos, SuggestionSpan.class);
3296
3297            mSpansLengths.clear();
3298            for (SuggestionSpan suggestionSpan : suggestionSpans) {
3299                int start = spannable.getSpanStart(suggestionSpan);
3300                int end = spannable.getSpanEnd(suggestionSpan);
3301                mSpansLengths.put(suggestionSpan, Integer.valueOf(end - start));
3302            }
3303
3304            // The suggestions are sorted according to their types (easy correction first, then
3305            // misspelled) and to the length of the text that they cover (shorter first).
3306            Arrays.sort(suggestionSpans, mSuggestionSpanComparator);
3307            mSpansLengths.clear();
3308
3309            return suggestionSpans;
3310        }
3311
3312        /**
3313         * Gets the SuggestionInfo list that contains suggestion information at the current cursor
3314         * position.
3315         *
3316         * @param suggestionInfos SuggestionInfo array the results will be set.
3317         * @param misspelledSpanInfo a struct the misspelled SuggestionSpan info will be set.
3318         * @return the number of suggestions actually fetched.
3319         */
3320        public int getSuggestionInfo(SuggestionInfo[] suggestionInfos,
3321                @Nullable SuggestionSpanInfo misspelledSpanInfo) {
3322            final Spannable spannable = (Spannable) mTextView.getText();
3323            final SuggestionSpan[] suggestionSpans = getSortedSuggestionSpans();
3324            final int nbSpans = suggestionSpans.length;
3325            if (nbSpans == 0) return 0;
3326
3327            int numberOfSuggestions = 0;
3328            for (final SuggestionSpan suggestionSpan : suggestionSpans) {
3329                final int spanStart = spannable.getSpanStart(suggestionSpan);
3330                final int spanEnd = spannable.getSpanEnd(suggestionSpan);
3331
3332                if (misspelledSpanInfo != null
3333                        && (suggestionSpan.getFlags() & SuggestionSpan.FLAG_MISSPELLED) != 0) {
3334                    misspelledSpanInfo.mSuggestionSpan = suggestionSpan;
3335                    misspelledSpanInfo.mSpanStart = spanStart;
3336                    misspelledSpanInfo.mSpanEnd = spanEnd;
3337                }
3338
3339                final String[] suggestions = suggestionSpan.getSuggestions();
3340                final int nbSuggestions = suggestions.length;
3341                suggestionLoop:
3342                for (int suggestionIndex = 0; suggestionIndex < nbSuggestions; suggestionIndex++) {
3343                    final String suggestion = suggestions[suggestionIndex];
3344                    for (int i = 0; i < numberOfSuggestions; i++) {
3345                        final SuggestionInfo otherSuggestionInfo = suggestionInfos[i];
3346                        if (otherSuggestionInfo.mText.toString().equals(suggestion)) {
3347                            final int otherSpanStart =
3348                                    otherSuggestionInfo.mSuggestionSpanInfo.mSpanStart;
3349                            final int otherSpanEnd =
3350                                    otherSuggestionInfo.mSuggestionSpanInfo.mSpanEnd;
3351                            if (spanStart == otherSpanStart && spanEnd == otherSpanEnd) {
3352                                continue suggestionLoop;
3353                            }
3354                        }
3355                    }
3356
3357                    SuggestionInfo suggestionInfo = suggestionInfos[numberOfSuggestions];
3358                    suggestionInfo.setSpanInfo(suggestionSpan, spanStart, spanEnd);
3359                    suggestionInfo.mSuggestionIndex = suggestionIndex;
3360                    suggestionInfo.mSuggestionStart = 0;
3361                    suggestionInfo.mSuggestionEnd = suggestion.length();
3362                    suggestionInfo.mText.replace(0, suggestionInfo.mText.length(), suggestion);
3363                    numberOfSuggestions++;
3364                    if (numberOfSuggestions >= suggestionInfos.length) {
3365                        return numberOfSuggestions;
3366                    }
3367                }
3368            }
3369            return numberOfSuggestions;
3370        }
3371    }
3372
3373    @VisibleForTesting
3374    public class SuggestionsPopupWindow extends PinnedPopupWindow implements OnItemClickListener {
3375        private static final int MAX_NUMBER_SUGGESTIONS = SuggestionSpan.SUGGESTIONS_MAX_SIZE;
3376
3377        // Key of intent extras for inserting new word into user dictionary.
3378        private static final String USER_DICTIONARY_EXTRA_WORD = "word";
3379        private static final String USER_DICTIONARY_EXTRA_LOCALE = "locale";
3380
3381        private SuggestionInfo[] mSuggestionInfos;
3382        private int mNumberOfSuggestions;
3383        private boolean mCursorWasVisibleBeforeSuggestions;
3384        private boolean mIsShowingUp = false;
3385        private SuggestionAdapter mSuggestionsAdapter;
3386        private TextAppearanceSpan mHighlightSpan;  // TODO: Make mHighlightSpan final.
3387        private TextView mAddToDictionaryButton;
3388        private TextView mDeleteButton;
3389        private ListView mSuggestionListView;
3390        private final SuggestionSpanInfo mMisspelledSpanInfo = new SuggestionSpanInfo();
3391        private int mContainerMarginWidth;
3392        private int mContainerMarginTop;
3393        private LinearLayout mContainerView;
3394        private Context mContext;  // TODO: Make mContext final.
3395
3396        private class CustomPopupWindow extends PopupWindow {
3397
3398            @Override
3399            public void dismiss() {
3400                if (!isShowing()) {
3401                    return;
3402                }
3403                super.dismiss();
3404                getPositionListener().removeSubscriber(SuggestionsPopupWindow.this);
3405
3406                // Safe cast since show() checks that mTextView.getText() is an Editable
3407                ((Spannable) mTextView.getText()).removeSpan(mSuggestionRangeSpan);
3408
3409                mTextView.setCursorVisible(mCursorWasVisibleBeforeSuggestions);
3410                if (hasInsertionController() && !extractedTextModeWillBeStarted()) {
3411                    getInsertionController().show();
3412                }
3413            }
3414        }
3415
3416        public SuggestionsPopupWindow() {
3417            mCursorWasVisibleBeforeSuggestions = mCursorVisible;
3418        }
3419
3420        @Override
3421        protected void setUp() {
3422            mContext = applyDefaultTheme(mTextView.getContext());
3423            mHighlightSpan = new TextAppearanceSpan(mContext,
3424                    mTextView.mTextEditSuggestionHighlightStyle);
3425        }
3426
3427        private Context applyDefaultTheme(Context originalContext) {
3428            TypedArray a = originalContext.obtainStyledAttributes(
3429                    new int[]{com.android.internal.R.attr.isLightTheme});
3430            boolean isLightTheme = a.getBoolean(0, true);
3431            int themeId = isLightTheme ? R.style.ThemeOverlay_Material_Light
3432                    : R.style.ThemeOverlay_Material_Dark;
3433            a.recycle();
3434            return new ContextThemeWrapper(originalContext, themeId);
3435        }
3436
3437        @Override
3438        protected void createPopupWindow() {
3439            mPopupWindow = new CustomPopupWindow();
3440            mPopupWindow.setInputMethodMode(PopupWindow.INPUT_METHOD_NOT_NEEDED);
3441            mPopupWindow.setBackgroundDrawable(new ColorDrawable(Color.TRANSPARENT));
3442            mPopupWindow.setFocusable(true);
3443            mPopupWindow.setClippingEnabled(false);
3444        }
3445
3446        @Override
3447        protected void initContentView() {
3448            final LayoutInflater inflater = (LayoutInflater) mContext.getSystemService(
3449                    Context.LAYOUT_INFLATER_SERVICE);
3450            mContentView = (ViewGroup) inflater.inflate(
3451                    mTextView.mTextEditSuggestionContainerLayout, null);
3452
3453            mContainerView = (LinearLayout) mContentView.findViewById(
3454                    com.android.internal.R.id.suggestionWindowContainer);
3455            ViewGroup.MarginLayoutParams lp =
3456                    (ViewGroup.MarginLayoutParams) mContainerView.getLayoutParams();
3457            mContainerMarginWidth = lp.leftMargin + lp.rightMargin;
3458            mContainerMarginTop = lp.topMargin;
3459            mClippingLimitLeft = lp.leftMargin;
3460            mClippingLimitRight = lp.rightMargin;
3461
3462            mSuggestionListView = (ListView) mContentView.findViewById(
3463                    com.android.internal.R.id.suggestionContainer);
3464
3465            mSuggestionsAdapter = new SuggestionAdapter();
3466            mSuggestionListView.setAdapter(mSuggestionsAdapter);
3467            mSuggestionListView.setOnItemClickListener(this);
3468
3469            // Inflate the suggestion items once and for all.
3470            mSuggestionInfos = new SuggestionInfo[MAX_NUMBER_SUGGESTIONS];
3471            for (int i = 0; i < mSuggestionInfos.length; i++) {
3472                mSuggestionInfos[i] = new SuggestionInfo();
3473            }
3474
3475            mAddToDictionaryButton = (TextView) mContentView.findViewById(
3476                    com.android.internal.R.id.addToDictionaryButton);
3477            mAddToDictionaryButton.setOnClickListener(new View.OnClickListener() {
3478                public void onClick(View v) {
3479                    final SuggestionSpan misspelledSpan =
3480                            findEquivalentSuggestionSpan(mMisspelledSpanInfo);
3481                    if (misspelledSpan == null) {
3482                        // Span has been removed.
3483                        return;
3484                    }
3485                    final Editable editable = (Editable) mTextView.getText();
3486                    final int spanStart = editable.getSpanStart(misspelledSpan);
3487                    final int spanEnd = editable.getSpanEnd(misspelledSpan);
3488                    if (spanStart < 0 || spanEnd <= spanStart) {
3489                        return;
3490                    }
3491                    final String originalText = TextUtils.substring(editable, spanStart, spanEnd);
3492
3493                    final Intent intent = new Intent(Settings.ACTION_USER_DICTIONARY_INSERT);
3494                    intent.putExtra(USER_DICTIONARY_EXTRA_WORD, originalText);
3495                    intent.putExtra(USER_DICTIONARY_EXTRA_LOCALE,
3496                            mTextView.getTextServicesLocale().toString());
3497                    intent.setFlags(intent.getFlags() | Intent.FLAG_ACTIVITY_NEW_TASK);
3498                    mTextView.getContext().startActivity(intent);
3499                    // There is no way to know if the word was indeed added. Re-check.
3500                    // TODO The ExtractEditText should remove the span in the original text instead
3501                    editable.removeSpan(mMisspelledSpanInfo.mSuggestionSpan);
3502                    Selection.setSelection(editable, spanEnd);
3503                    updateSpellCheckSpans(spanStart, spanEnd, false);
3504                    hideWithCleanUp();
3505                }
3506            });
3507
3508            mDeleteButton = (TextView) mContentView.findViewById(
3509                    com.android.internal.R.id.deleteButton);
3510            mDeleteButton.setOnClickListener(new View.OnClickListener() {
3511                public void onClick(View v) {
3512                    final Editable editable = (Editable) mTextView.getText();
3513
3514                    final int spanUnionStart = editable.getSpanStart(mSuggestionRangeSpan);
3515                    int spanUnionEnd = editable.getSpanEnd(mSuggestionRangeSpan);
3516                    if (spanUnionStart >= 0 && spanUnionEnd > spanUnionStart) {
3517                        // Do not leave two adjacent spaces after deletion, or one at beginning of
3518                        // text
3519                        if (spanUnionEnd < editable.length()
3520                                && Character.isSpaceChar(editable.charAt(spanUnionEnd))
3521                                && (spanUnionStart == 0
3522                                        || Character.isSpaceChar(
3523                                                editable.charAt(spanUnionStart - 1)))) {
3524                            spanUnionEnd = spanUnionEnd + 1;
3525                        }
3526                        mTextView.deleteText_internal(spanUnionStart, spanUnionEnd);
3527                    }
3528                    hideWithCleanUp();
3529                }
3530            });
3531
3532        }
3533
3534        public boolean isShowingUp() {
3535            return mIsShowingUp;
3536        }
3537
3538        public void onParentLostFocus() {
3539            mIsShowingUp = false;
3540        }
3541
3542        private class SuggestionAdapter extends BaseAdapter {
3543            private LayoutInflater mInflater = (LayoutInflater) mContext.getSystemService(
3544                    Context.LAYOUT_INFLATER_SERVICE);
3545
3546            @Override
3547            public int getCount() {
3548                return mNumberOfSuggestions;
3549            }
3550
3551            @Override
3552            public Object getItem(int position) {
3553                return mSuggestionInfos[position];
3554            }
3555
3556            @Override
3557            public long getItemId(int position) {
3558                return position;
3559            }
3560
3561            @Override
3562            public View getView(int position, View convertView, ViewGroup parent) {
3563                TextView textView = (TextView) convertView;
3564
3565                if (textView == null) {
3566                    textView = (TextView) mInflater.inflate(mTextView.mTextEditSuggestionItemLayout,
3567                            parent, false);
3568                }
3569
3570                final SuggestionInfo suggestionInfo = mSuggestionInfos[position];
3571                textView.setText(suggestionInfo.mText);
3572                return textView;
3573            }
3574        }
3575
3576        @VisibleForTesting
3577        public ViewGroup getContentViewForTesting() {
3578            return mContentView;
3579        }
3580
3581        @Override
3582        public void show() {
3583            if (!(mTextView.getText() instanceof Editable)) return;
3584            if (extractedTextModeWillBeStarted()) {
3585                return;
3586            }
3587
3588            if (updateSuggestions()) {
3589                mCursorWasVisibleBeforeSuggestions = mCursorVisible;
3590                mTextView.setCursorVisible(false);
3591                mIsShowingUp = true;
3592                super.show();
3593            }
3594        }
3595
3596        @Override
3597        protected void measureContent() {
3598            final DisplayMetrics displayMetrics = mTextView.getResources().getDisplayMetrics();
3599            final int horizontalMeasure = View.MeasureSpec.makeMeasureSpec(
3600                    displayMetrics.widthPixels, View.MeasureSpec.AT_MOST);
3601            final int verticalMeasure = View.MeasureSpec.makeMeasureSpec(
3602                    displayMetrics.heightPixels, View.MeasureSpec.AT_MOST);
3603
3604            int width = 0;
3605            View view = null;
3606            for (int i = 0; i < mNumberOfSuggestions; i++) {
3607                view = mSuggestionsAdapter.getView(i, view, mContentView);
3608                view.getLayoutParams().width = LayoutParams.WRAP_CONTENT;
3609                view.measure(horizontalMeasure, verticalMeasure);
3610                width = Math.max(width, view.getMeasuredWidth());
3611            }
3612
3613            if (mAddToDictionaryButton.getVisibility() != View.GONE) {
3614                mAddToDictionaryButton.measure(horizontalMeasure, verticalMeasure);
3615                width = Math.max(width, mAddToDictionaryButton.getMeasuredWidth());
3616            }
3617
3618            mDeleteButton.measure(horizontalMeasure, verticalMeasure);
3619            width = Math.max(width, mDeleteButton.getMeasuredWidth());
3620
3621            width += mContainerView.getPaddingLeft() + mContainerView.getPaddingRight()
3622                    + mContainerMarginWidth;
3623
3624            // Enforce the width based on actual text widths
3625            mContentView.measure(
3626                    View.MeasureSpec.makeMeasureSpec(width, View.MeasureSpec.EXACTLY),
3627                    verticalMeasure);
3628
3629            Drawable popupBackground = mPopupWindow.getBackground();
3630            if (popupBackground != null) {
3631                if (mTempRect == null) mTempRect = new Rect();
3632                popupBackground.getPadding(mTempRect);
3633                width += mTempRect.left + mTempRect.right;
3634            }
3635            mPopupWindow.setWidth(width);
3636        }
3637
3638        @Override
3639        protected int getTextOffset() {
3640            return (mTextView.getSelectionStart() + mTextView.getSelectionStart()) / 2;
3641        }
3642
3643        @Override
3644        protected int getVerticalLocalPosition(int line) {
3645            return mTextView.getLayout().getLineBottom(line) - mContainerMarginTop;
3646        }
3647
3648        @Override
3649        protected int clipVertically(int positionY) {
3650            final int height = mContentView.getMeasuredHeight();
3651            final DisplayMetrics displayMetrics = mTextView.getResources().getDisplayMetrics();
3652            return Math.min(positionY, displayMetrics.heightPixels - height);
3653        }
3654
3655        private void hideWithCleanUp() {
3656            for (final SuggestionInfo info : mSuggestionInfos) {
3657                info.clear();
3658            }
3659            mMisspelledSpanInfo.clear();
3660            hide();
3661        }
3662
3663        private boolean updateSuggestions() {
3664            Spannable spannable = (Spannable) mTextView.getText();
3665            mNumberOfSuggestions =
3666                    mSuggestionHelper.getSuggestionInfo(mSuggestionInfos, mMisspelledSpanInfo);
3667            if (mNumberOfSuggestions == 0 && mMisspelledSpanInfo.mSuggestionSpan == null) {
3668                return false;
3669            }
3670
3671            int spanUnionStart = mTextView.getText().length();
3672            int spanUnionEnd = 0;
3673
3674            for (int i = 0; i < mNumberOfSuggestions; i++) {
3675                final SuggestionSpanInfo spanInfo = mSuggestionInfos[i].mSuggestionSpanInfo;
3676                spanUnionStart = Math.min(spanUnionStart, spanInfo.mSpanStart);
3677                spanUnionEnd = Math.max(spanUnionEnd, spanInfo.mSpanEnd);
3678            }
3679            if (mMisspelledSpanInfo.mSuggestionSpan != null) {
3680                spanUnionStart = Math.min(spanUnionStart, mMisspelledSpanInfo.mSpanStart);
3681                spanUnionEnd = Math.max(spanUnionEnd, mMisspelledSpanInfo.mSpanEnd);
3682            }
3683
3684            for (int i = 0; i < mNumberOfSuggestions; i++) {
3685                highlightTextDifferences(mSuggestionInfos[i], spanUnionStart, spanUnionEnd);
3686            }
3687
3688            // Make "Add to dictionary" item visible if there is a span with the misspelled flag
3689            int addToDictionaryButtonVisibility = View.GONE;
3690            if (mMisspelledSpanInfo.mSuggestionSpan != null) {
3691                if (mMisspelledSpanInfo.mSpanStart >= 0
3692                        && mMisspelledSpanInfo.mSpanEnd > mMisspelledSpanInfo.mSpanStart) {
3693                    addToDictionaryButtonVisibility = View.VISIBLE;
3694                }
3695            }
3696            mAddToDictionaryButton.setVisibility(addToDictionaryButtonVisibility);
3697
3698            if (mSuggestionRangeSpan == null) mSuggestionRangeSpan = new SuggestionRangeSpan();
3699            final int underlineColor;
3700            if (mNumberOfSuggestions != 0) {
3701                underlineColor =
3702                        mSuggestionInfos[0].mSuggestionSpanInfo.mSuggestionSpan.getUnderlineColor();
3703            } else {
3704                underlineColor = mMisspelledSpanInfo.mSuggestionSpan.getUnderlineColor();
3705            }
3706
3707            if (underlineColor == 0) {
3708                // Fallback on the default highlight color when the first span does not provide one
3709                mSuggestionRangeSpan.setBackgroundColor(mTextView.mHighlightColor);
3710            } else {
3711                final float BACKGROUND_TRANSPARENCY = 0.4f;
3712                final int newAlpha = (int) (Color.alpha(underlineColor) * BACKGROUND_TRANSPARENCY);
3713                mSuggestionRangeSpan.setBackgroundColor(
3714                        (underlineColor & 0x00FFFFFF) + (newAlpha << 24));
3715            }
3716            spannable.setSpan(mSuggestionRangeSpan, spanUnionStart, spanUnionEnd,
3717                    Spanned.SPAN_EXCLUSIVE_EXCLUSIVE);
3718
3719            mSuggestionsAdapter.notifyDataSetChanged();
3720            return true;
3721        }
3722
3723        private void highlightTextDifferences(SuggestionInfo suggestionInfo, int unionStart,
3724                int unionEnd) {
3725            final Spannable text = (Spannable) mTextView.getText();
3726            final int spanStart = suggestionInfo.mSuggestionSpanInfo.mSpanStart;
3727            final int spanEnd = suggestionInfo.mSuggestionSpanInfo.mSpanEnd;
3728
3729            // Adjust the start/end of the suggestion span
3730            suggestionInfo.mSuggestionStart = spanStart - unionStart;
3731            suggestionInfo.mSuggestionEnd = suggestionInfo.mSuggestionStart
3732                    + suggestionInfo.mText.length();
3733
3734            suggestionInfo.mText.setSpan(mHighlightSpan, 0, suggestionInfo.mText.length(),
3735                    Spanned.SPAN_EXCLUSIVE_EXCLUSIVE);
3736
3737            // Add the text before and after the span.
3738            final String textAsString = text.toString();
3739            suggestionInfo.mText.insert(0, textAsString.substring(unionStart, spanStart));
3740            suggestionInfo.mText.append(textAsString.substring(spanEnd, unionEnd));
3741        }
3742
3743        @Override
3744        public void onItemClick(AdapterView<?> parent, View view, int position, long id) {
3745            SuggestionInfo suggestionInfo = mSuggestionInfos[position];
3746            replaceWithSuggestion(suggestionInfo);
3747            hideWithCleanUp();
3748        }
3749    }
3750
3751    /**
3752     * An ActionMode Callback class that is used to provide actions while in text insertion or
3753     * selection mode.
3754     *
3755     * The default callback provides a subset of Select All, Cut, Copy, Paste, Share and Replace
3756     * actions, depending on which of these this TextView supports and the current selection.
3757     */
3758    private class TextActionModeCallback extends ActionMode.Callback2 {
3759        private final Path mSelectionPath = new Path();
3760        private final RectF mSelectionBounds = new RectF();
3761        private final boolean mHasSelection;
3762        private final int mHandleHeight;
3763
3764        public TextActionModeCallback(boolean hasSelection) {
3765            mHasSelection = hasSelection;
3766            if (mHasSelection) {
3767                SelectionModifierCursorController selectionController = getSelectionController();
3768                if (selectionController.mStartHandle == null) {
3769                    // As these are for initializing selectionController, hide() must be called.
3770                    selectionController.initDrawables();
3771                    selectionController.initHandles();
3772                    selectionController.hide();
3773                }
3774                mHandleHeight = Math.max(
3775                        mSelectHandleLeft.getMinimumHeight(),
3776                        mSelectHandleRight.getMinimumHeight());
3777            } else {
3778                InsertionPointCursorController insertionController = getInsertionController();
3779                if (insertionController != null) {
3780                    insertionController.getHandle();
3781                    mHandleHeight = mSelectHandleCenter.getMinimumHeight();
3782                } else {
3783                    mHandleHeight = 0;
3784                }
3785            }
3786        }
3787
3788        @Override
3789        public boolean onCreateActionMode(ActionMode mode, Menu menu) {
3790            mode.setTitle(null);
3791            mode.setSubtitle(null);
3792            mode.setTitleOptionalHint(true);
3793            populateMenuWithItems(menu);
3794
3795            Callback customCallback = getCustomCallback();
3796            if (customCallback != null) {
3797                if (!customCallback.onCreateActionMode(mode, menu)) {
3798                    // The custom mode can choose to cancel the action mode, dismiss selection.
3799                    Selection.setSelection((Spannable) mTextView.getText(),
3800                            mTextView.getSelectionEnd());
3801                    return false;
3802                }
3803            }
3804
3805            if (mTextView.canProcessText()) {
3806                mProcessTextIntentActionsHandler.onInitializeMenu(menu);
3807            }
3808
3809            if (menu.hasVisibleItems() || mode.getCustomView() != null) {
3810                if (mHasSelection && !mTextView.hasTransientState()) {
3811                    mTextView.setHasTransientState(true);
3812                }
3813                return true;
3814            } else {
3815                return false;
3816            }
3817        }
3818
3819        private Callback getCustomCallback() {
3820            return mHasSelection
3821                    ? mCustomSelectionActionModeCallback
3822                    : mCustomInsertionActionModeCallback;
3823        }
3824
3825        private void populateMenuWithItems(Menu menu) {
3826            if (mTextView.canCut()) {
3827                menu.add(Menu.NONE, TextView.ID_CUT, MENU_ITEM_ORDER_CUT,
3828                        com.android.internal.R.string.cut)
3829                                .setAlphabeticShortcut('x')
3830                                .setShowAsAction(MenuItem.SHOW_AS_ACTION_ALWAYS);
3831            }
3832
3833            if (mTextView.canCopy()) {
3834                menu.add(Menu.NONE, TextView.ID_COPY, MENU_ITEM_ORDER_COPY,
3835                        com.android.internal.R.string.copy)
3836                                .setAlphabeticShortcut('c')
3837                                .setShowAsAction(MenuItem.SHOW_AS_ACTION_ALWAYS);
3838            }
3839
3840            if (mTextView.canPaste()) {
3841                menu.add(Menu.NONE, TextView.ID_PASTE, MENU_ITEM_ORDER_PASTE,
3842                        com.android.internal.R.string.paste)
3843                                .setAlphabeticShortcut('v')
3844                                .setShowAsAction(MenuItem.SHOW_AS_ACTION_ALWAYS);
3845            }
3846
3847            if (mTextView.canShare()) {
3848                menu.add(Menu.NONE, TextView.ID_SHARE, MENU_ITEM_ORDER_SHARE,
3849                        com.android.internal.R.string.share)
3850                        .setShowAsAction(MenuItem.SHOW_AS_ACTION_IF_ROOM);
3851            }
3852
3853            if (mTextView.canRequestAutofill()) {
3854                final String selected = mTextView.getSelectedText();
3855                if (selected == null || selected.isEmpty()) {
3856                    menu.add(Menu.NONE, TextView.ID_AUTOFILL, MENU_ITEM_ORDER_AUTOFILL,
3857                            com.android.internal.R.string.autofill)
3858                            .setShowAsAction(MenuItem.SHOW_AS_OVERFLOW_ALWAYS);
3859                }
3860            }
3861
3862            if (mTextView.canPasteAsPlainText()) {
3863                menu.add(
3864                        Menu.NONE,
3865                        TextView.ID_PASTE_AS_PLAIN_TEXT,
3866                        MENU_ITEM_ORDER_PASTE_AS_PLAIN_TEXT,
3867                        com.android.internal.R.string.paste_as_plain_text)
3868                        .setShowAsAction(MenuItem.SHOW_AS_ACTION_IF_ROOM);
3869            }
3870
3871            updateSelectAllItem(menu);
3872            updateReplaceItem(menu);
3873            updateAssistMenuItem(menu);
3874        }
3875
3876        @Override
3877        public boolean onPrepareActionMode(ActionMode mode, Menu menu) {
3878            updateSelectAllItem(menu);
3879            updateReplaceItem(menu);
3880            updateAssistMenuItem(menu);
3881
3882            Callback customCallback = getCustomCallback();
3883            if (customCallback != null) {
3884                return customCallback.onPrepareActionMode(mode, menu);
3885            }
3886            return true;
3887        }
3888
3889        private void updateSelectAllItem(Menu menu) {
3890            boolean canSelectAll = mTextView.canSelectAllText();
3891            boolean selectAllItemExists = menu.findItem(TextView.ID_SELECT_ALL) != null;
3892            if (canSelectAll && !selectAllItemExists) {
3893                menu.add(Menu.NONE, TextView.ID_SELECT_ALL, MENU_ITEM_ORDER_SELECT_ALL,
3894                        com.android.internal.R.string.selectAll)
3895                    .setShowAsAction(MenuItem.SHOW_AS_ACTION_IF_ROOM);
3896            } else if (!canSelectAll && selectAllItemExists) {
3897                menu.removeItem(TextView.ID_SELECT_ALL);
3898            }
3899        }
3900
3901        private void updateReplaceItem(Menu menu) {
3902            boolean canReplace = mTextView.isSuggestionsEnabled() && shouldOfferToShowSuggestions();
3903            boolean replaceItemExists = menu.findItem(TextView.ID_REPLACE) != null;
3904            if (canReplace && !replaceItemExists) {
3905                menu.add(Menu.NONE, TextView.ID_REPLACE, MENU_ITEM_ORDER_REPLACE,
3906                        com.android.internal.R.string.replace)
3907                    .setShowAsAction(MenuItem.SHOW_AS_ACTION_IF_ROOM);
3908            } else if (!canReplace && replaceItemExists) {
3909                menu.removeItem(TextView.ID_REPLACE);
3910            }
3911        }
3912
3913        private void updateAssistMenuItem(Menu menu) {
3914            menu.removeItem(TextView.ID_ASSIST);
3915            final TextClassification textClassification =
3916                    getSelectionActionModeHelper().getTextClassification();
3917            if (canAssist()) {
3918                menu.add(TextView.ID_ASSIST, TextView.ID_ASSIST, MENU_ITEM_ORDER_ASSIST,
3919                        textClassification.getLabel())
3920                        .setIcon(textClassification.getIcon())
3921                        .setShowAsAction(MenuItem.SHOW_AS_ACTION_ALWAYS);
3922                mMetricsLogger.write(
3923                        new LogMaker(MetricsEvent.TEXT_SELECTION_MENU_ITEM_ASSIST)
3924                                .setType(MetricsEvent.TYPE_OPEN)
3925                                .setSubtype(textClassification.getLogType()));
3926            }
3927        }
3928
3929        private boolean canAssist() {
3930            final TextClassification textClassification =
3931                    getSelectionActionModeHelper().getTextClassification();
3932            return mTextView.isDeviceProvisioned()
3933                    && textClassification != null
3934                    && (textClassification.getIcon() != null
3935                            || !TextUtils.isEmpty(textClassification.getLabel()))
3936                    && (textClassification.getOnClickListener() != null
3937                            || (textClassification.getIntent() != null
3938                                    && mTextView.getContext().canStartActivityForResult()));
3939        }
3940
3941        @Override
3942        public boolean onActionItemClicked(ActionMode mode, MenuItem item) {
3943            getSelectionActionModeHelper().onSelectionAction();
3944
3945            if (mProcessTextIntentActionsHandler.performMenuItemAction(item)) {
3946                return true;
3947            }
3948            Callback customCallback = getCustomCallback();
3949            if (customCallback != null && customCallback.onActionItemClicked(mode, item)) {
3950                return true;
3951            }
3952            final TextClassification textClassification =
3953                    getSelectionActionModeHelper().getTextClassification();
3954            if (TextView.ID_ASSIST == item.getItemId() && textClassification != null) {
3955                final OnClickListener onClickListener =
3956                        textClassification.getOnClickListener();
3957                if (onClickListener != null) {
3958                    onClickListener.onClick(mTextView);
3959                } else {
3960                    final Intent intent = textClassification.getIntent();
3961                    if (intent != null) {
3962                        TextClassification.createStartActivityOnClickListener(
3963                                mTextView.getContext(), intent)
3964                                .onClick(mTextView);
3965                    }
3966                }
3967                mMetricsLogger.action(
3968                        MetricsEvent.ACTION_TEXT_SELECTION_MENU_ITEM_ASSIST,
3969                        textClassification.getLogType());
3970                stopTextActionMode();
3971                return true;
3972            }
3973            return mTextView.onTextContextMenuItem(item.getItemId());
3974        }
3975
3976        @Override
3977        public void onDestroyActionMode(ActionMode mode) {
3978            // Clear mTextActionMode not to recursively destroy action mode by clearing selection.
3979            getSelectionActionModeHelper().onDestroyActionMode();
3980            mTextActionMode = null;
3981            Callback customCallback = getCustomCallback();
3982            if (customCallback != null) {
3983                customCallback.onDestroyActionMode(mode);
3984            }
3985
3986            if (!mPreserveSelection) {
3987                /*
3988                 * Leave current selection when we tentatively destroy action mode for the
3989                 * selection. If we're detaching from a window, we'll bring back the selection
3990                 * mode when (if) we get reattached.
3991                 */
3992                Selection.setSelection((Spannable) mTextView.getText(),
3993                        mTextView.getSelectionEnd());
3994            }
3995
3996            if (mSelectionModifierCursorController != null) {
3997                mSelectionModifierCursorController.hide();
3998            }
3999        }
4000
4001        @Override
4002        public void onGetContentRect(ActionMode mode, View view, Rect outRect) {
4003            if (!view.equals(mTextView) || mTextView.getLayout() == null) {
4004                super.onGetContentRect(mode, view, outRect);
4005                return;
4006            }
4007            if (mTextView.getSelectionStart() != mTextView.getSelectionEnd()) {
4008                // We have a selection.
4009                mSelectionPath.reset();
4010                mTextView.getLayout().getSelectionPath(
4011                        mTextView.getSelectionStart(), mTextView.getSelectionEnd(), mSelectionPath);
4012                mSelectionPath.computeBounds(mSelectionBounds, true);
4013                mSelectionBounds.bottom += mHandleHeight;
4014            } else if (mCursorCount == 2) {
4015                // We have a split cursor. In this case, we take the rectangle that includes both
4016                // parts of the cursor to ensure we don't obscure either of them.
4017                Rect firstCursorBounds = mCursorDrawable[0].getBounds();
4018                Rect secondCursorBounds = mCursorDrawable[1].getBounds();
4019                mSelectionBounds.set(
4020                        Math.min(firstCursorBounds.left, secondCursorBounds.left),
4021                        Math.min(firstCursorBounds.top, secondCursorBounds.top),
4022                        Math.max(firstCursorBounds.right, secondCursorBounds.right),
4023                        Math.max(firstCursorBounds.bottom, secondCursorBounds.bottom)
4024                                + mHandleHeight);
4025            } else {
4026                // We have a single cursor.
4027                Layout layout = mTextView.getLayout();
4028                int line = layout.getLineForOffset(mTextView.getSelectionStart());
4029                float primaryHorizontal = clampHorizontalPosition(null,
4030                        layout.getPrimaryHorizontal(mTextView.getSelectionStart()));
4031                mSelectionBounds.set(
4032                        primaryHorizontal,
4033                        layout.getLineTop(line),
4034                        primaryHorizontal,
4035                        layout.getLineTop(line + 1) + mHandleHeight);
4036            }
4037            // Take TextView's padding and scroll into account.
4038            int textHorizontalOffset = mTextView.viewportToContentHorizontalOffset();
4039            int textVerticalOffset = mTextView.viewportToContentVerticalOffset();
4040            outRect.set(
4041                    (int) Math.floor(mSelectionBounds.left + textHorizontalOffset),
4042                    (int) Math.floor(mSelectionBounds.top + textVerticalOffset),
4043                    (int) Math.ceil(mSelectionBounds.right + textHorizontalOffset),
4044                    (int) Math.ceil(mSelectionBounds.bottom + textVerticalOffset));
4045        }
4046    }
4047
4048    /**
4049     * A listener to call {@link InputMethodManager#updateCursorAnchorInfo(View, CursorAnchorInfo)}
4050     * while the input method is requesting the cursor/anchor position. Does nothing as long as
4051     * {@link InputMethodManager#isWatchingCursor(View)} returns false.
4052     */
4053    private final class CursorAnchorInfoNotifier implements TextViewPositionListener {
4054        final CursorAnchorInfo.Builder mSelectionInfoBuilder = new CursorAnchorInfo.Builder();
4055        final int[] mTmpIntOffset = new int[2];
4056        final Matrix mViewToScreenMatrix = new Matrix();
4057
4058        @Override
4059        public void updatePosition(int parentPositionX, int parentPositionY,
4060                boolean parentPositionChanged, boolean parentScrolled) {
4061            final InputMethodState ims = mInputMethodState;
4062            if (ims == null || ims.mBatchEditNesting > 0) {
4063                return;
4064            }
4065            final InputMethodManager imm = InputMethodManager.peekInstance();
4066            if (null == imm) {
4067                return;
4068            }
4069            if (!imm.isActive(mTextView)) {
4070                return;
4071            }
4072            // Skip if the IME has not requested the cursor/anchor position.
4073            if (!imm.isCursorAnchorInfoEnabled()) {
4074                return;
4075            }
4076            Layout layout = mTextView.getLayout();
4077            if (layout == null) {
4078                return;
4079            }
4080
4081            final CursorAnchorInfo.Builder builder = mSelectionInfoBuilder;
4082            builder.reset();
4083
4084            final int selectionStart = mTextView.getSelectionStart();
4085            builder.setSelectionRange(selectionStart, mTextView.getSelectionEnd());
4086
4087            // Construct transformation matrix from view local coordinates to screen coordinates.
4088            mViewToScreenMatrix.set(mTextView.getMatrix());
4089            mTextView.getLocationOnScreen(mTmpIntOffset);
4090            mViewToScreenMatrix.postTranslate(mTmpIntOffset[0], mTmpIntOffset[1]);
4091            builder.setMatrix(mViewToScreenMatrix);
4092
4093            final float viewportToContentHorizontalOffset =
4094                    mTextView.viewportToContentHorizontalOffset();
4095            final float viewportToContentVerticalOffset =
4096                    mTextView.viewportToContentVerticalOffset();
4097
4098            final CharSequence text = mTextView.getText();
4099            if (text instanceof Spannable) {
4100                final Spannable sp = (Spannable) text;
4101                int composingTextStart = EditableInputConnection.getComposingSpanStart(sp);
4102                int composingTextEnd = EditableInputConnection.getComposingSpanEnd(sp);
4103                if (composingTextEnd < composingTextStart) {
4104                    final int temp = composingTextEnd;
4105                    composingTextEnd = composingTextStart;
4106                    composingTextStart = temp;
4107                }
4108                final boolean hasComposingText =
4109                        (0 <= composingTextStart) && (composingTextStart < composingTextEnd);
4110                if (hasComposingText) {
4111                    final CharSequence composingText = text.subSequence(composingTextStart,
4112                            composingTextEnd);
4113                    builder.setComposingText(composingTextStart, composingText);
4114                    mTextView.populateCharacterBounds(builder, composingTextStart,
4115                            composingTextEnd, viewportToContentHorizontalOffset,
4116                            viewportToContentVerticalOffset);
4117                }
4118            }
4119
4120            // Treat selectionStart as the insertion point.
4121            if (0 <= selectionStart) {
4122                final int offset = selectionStart;
4123                final int line = layout.getLineForOffset(offset);
4124                final float insertionMarkerX = layout.getPrimaryHorizontal(offset)
4125                        + viewportToContentHorizontalOffset;
4126                final float insertionMarkerTop = layout.getLineTop(line)
4127                        + viewportToContentVerticalOffset;
4128                final float insertionMarkerBaseline = layout.getLineBaseline(line)
4129                        + viewportToContentVerticalOffset;
4130                final float insertionMarkerBottom = layout.getLineBottom(line)
4131                        + viewportToContentVerticalOffset;
4132                final boolean isTopVisible = mTextView
4133                        .isPositionVisible(insertionMarkerX, insertionMarkerTop);
4134                final boolean isBottomVisible = mTextView
4135                        .isPositionVisible(insertionMarkerX, insertionMarkerBottom);
4136                int insertionMarkerFlags = 0;
4137                if (isTopVisible || isBottomVisible) {
4138                    insertionMarkerFlags |= CursorAnchorInfo.FLAG_HAS_VISIBLE_REGION;
4139                }
4140                if (!isTopVisible || !isBottomVisible) {
4141                    insertionMarkerFlags |= CursorAnchorInfo.FLAG_HAS_INVISIBLE_REGION;
4142                }
4143                if (layout.isRtlCharAt(offset)) {
4144                    insertionMarkerFlags |= CursorAnchorInfo.FLAG_IS_RTL;
4145                }
4146                builder.setInsertionMarkerLocation(insertionMarkerX, insertionMarkerTop,
4147                        insertionMarkerBaseline, insertionMarkerBottom, insertionMarkerFlags);
4148            }
4149
4150            imm.updateCursorAnchorInfo(mTextView, builder.build());
4151        }
4152    }
4153
4154    @VisibleForTesting
4155    public abstract class HandleView extends View implements TextViewPositionListener {
4156        protected Drawable mDrawable;
4157        protected Drawable mDrawableLtr;
4158        protected Drawable mDrawableRtl;
4159        private final PopupWindow mContainer;
4160        // Position with respect to the parent TextView
4161        private int mPositionX, mPositionY;
4162        private boolean mIsDragging;
4163        // Offset from touch position to mPosition
4164        private float mTouchToWindowOffsetX, mTouchToWindowOffsetY;
4165        protected int mHotspotX;
4166        protected int mHorizontalGravity;
4167        // Offsets the hotspot point up, so that cursor is not hidden by the finger when moving up
4168        private float mTouchOffsetY;
4169        // Where the touch position should be on the handle to ensure a maximum cursor visibility
4170        private float mIdealVerticalOffset;
4171        // Parent's (TextView) previous position in window
4172        private int mLastParentX, mLastParentY;
4173        // Parent's (TextView) previous position on screen
4174        private int mLastParentXOnScreen, mLastParentYOnScreen;
4175        // Previous text character offset
4176        protected int mPreviousOffset = -1;
4177        // Previous text character offset
4178        private boolean mPositionHasChanged = true;
4179        // Minimum touch target size for handles
4180        private int mMinSize;
4181        // Indicates the line of text that the handle is on.
4182        protected int mPrevLine = UNSET_LINE;
4183        // Indicates the line of text that the user was touching. This can differ from mPrevLine
4184        // when selecting text when the handles jump to the end / start of words which may be on
4185        // a different line.
4186        protected int mPreviousLineTouched = UNSET_LINE;
4187
4188        private HandleView(Drawable drawableLtr, Drawable drawableRtl, final int id) {
4189            super(mTextView.getContext());
4190            setId(id);
4191            mContainer = new PopupWindow(mTextView.getContext(), null,
4192                    com.android.internal.R.attr.textSelectHandleWindowStyle);
4193            mContainer.setSplitTouchEnabled(true);
4194            mContainer.setClippingEnabled(false);
4195            mContainer.setWindowLayoutType(WindowManager.LayoutParams.TYPE_APPLICATION_SUB_PANEL);
4196            mContainer.setWidth(ViewGroup.LayoutParams.WRAP_CONTENT);
4197            mContainer.setHeight(ViewGroup.LayoutParams.WRAP_CONTENT);
4198            mContainer.setContentView(this);
4199
4200            mDrawableLtr = drawableLtr;
4201            mDrawableRtl = drawableRtl;
4202            mMinSize = mTextView.getContext().getResources().getDimensionPixelSize(
4203                    com.android.internal.R.dimen.text_handle_min_size);
4204
4205            updateDrawable();
4206
4207            final int handleHeight = getPreferredHeight();
4208            mTouchOffsetY = -0.3f * handleHeight;
4209            mIdealVerticalOffset = 0.7f * handleHeight;
4210        }
4211
4212        public float getIdealVerticalOffset() {
4213            return mIdealVerticalOffset;
4214        }
4215
4216        protected void updateDrawable() {
4217            if (mIsDragging) {
4218                // Don't update drawable during dragging.
4219                return;
4220            }
4221            final Layout layout = mTextView.getLayout();
4222            if (layout == null) {
4223                return;
4224            }
4225            final int offset = getCurrentCursorOffset();
4226            final boolean isRtlCharAtOffset = isAtRtlRun(layout, offset);
4227            final Drawable oldDrawable = mDrawable;
4228            mDrawable = isRtlCharAtOffset ? mDrawableRtl : mDrawableLtr;
4229            mHotspotX = getHotspotX(mDrawable, isRtlCharAtOffset);
4230            mHorizontalGravity = getHorizontalGravity(isRtlCharAtOffset);
4231            if (oldDrawable != mDrawable && isShowing()) {
4232                // Update popup window position.
4233                mPositionX = getCursorHorizontalPosition(layout, offset) - mHotspotX
4234                        - getHorizontalOffset() + getCursorOffset();
4235                mPositionX += mTextView.viewportToContentHorizontalOffset();
4236                mPositionHasChanged = true;
4237                updatePosition(mLastParentX, mLastParentY, false, false);
4238                postInvalidate();
4239            }
4240        }
4241
4242        protected abstract int getHotspotX(Drawable drawable, boolean isRtlRun);
4243        protected abstract int getHorizontalGravity(boolean isRtlRun);
4244
4245        // Touch-up filter: number of previous positions remembered
4246        private static final int HISTORY_SIZE = 5;
4247        private static final int TOUCH_UP_FILTER_DELAY_AFTER = 150;
4248        private static final int TOUCH_UP_FILTER_DELAY_BEFORE = 350;
4249        private final long[] mPreviousOffsetsTimes = new long[HISTORY_SIZE];
4250        private final int[] mPreviousOffsets = new int[HISTORY_SIZE];
4251        private int mPreviousOffsetIndex = 0;
4252        private int mNumberPreviousOffsets = 0;
4253
4254        private void startTouchUpFilter(int offset) {
4255            mNumberPreviousOffsets = 0;
4256            addPositionToTouchUpFilter(offset);
4257        }
4258
4259        private void addPositionToTouchUpFilter(int offset) {
4260            mPreviousOffsetIndex = (mPreviousOffsetIndex + 1) % HISTORY_SIZE;
4261            mPreviousOffsets[mPreviousOffsetIndex] = offset;
4262            mPreviousOffsetsTimes[mPreviousOffsetIndex] = SystemClock.uptimeMillis();
4263            mNumberPreviousOffsets++;
4264        }
4265
4266        private void filterOnTouchUp(boolean fromTouchScreen) {
4267            final long now = SystemClock.uptimeMillis();
4268            int i = 0;
4269            int index = mPreviousOffsetIndex;
4270            final int iMax = Math.min(mNumberPreviousOffsets, HISTORY_SIZE);
4271            while (i < iMax && (now - mPreviousOffsetsTimes[index]) < TOUCH_UP_FILTER_DELAY_AFTER) {
4272                i++;
4273                index = (mPreviousOffsetIndex - i + HISTORY_SIZE) % HISTORY_SIZE;
4274            }
4275
4276            if (i > 0 && i < iMax
4277                    && (now - mPreviousOffsetsTimes[index]) > TOUCH_UP_FILTER_DELAY_BEFORE) {
4278                positionAtCursorOffset(mPreviousOffsets[index], false, fromTouchScreen);
4279            }
4280        }
4281
4282        public boolean offsetHasBeenChanged() {
4283            return mNumberPreviousOffsets > 1;
4284        }
4285
4286        @Override
4287        protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
4288            setMeasuredDimension(getPreferredWidth(), getPreferredHeight());
4289        }
4290
4291        @Override
4292        public void invalidate() {
4293            super.invalidate();
4294            if (isShowing()) {
4295                positionAtCursorOffset(getCurrentCursorOffset(), true, false);
4296            }
4297        };
4298
4299        private int getPreferredWidth() {
4300            return Math.max(mDrawable.getIntrinsicWidth(), mMinSize);
4301        }
4302
4303        private int getPreferredHeight() {
4304            return Math.max(mDrawable.getIntrinsicHeight(), mMinSize);
4305        }
4306
4307        public void show() {
4308            if (isShowing()) return;
4309
4310            getPositionListener().addSubscriber(this, true /* local position may change */);
4311
4312            // Make sure the offset is always considered new, even when focusing at same position
4313            mPreviousOffset = -1;
4314            positionAtCursorOffset(getCurrentCursorOffset(), false, false);
4315        }
4316
4317        protected void dismiss() {
4318            mIsDragging = false;
4319            mContainer.dismiss();
4320            onDetached();
4321        }
4322
4323        public void hide() {
4324            dismiss();
4325
4326            getPositionListener().removeSubscriber(this);
4327        }
4328
4329        public boolean isShowing() {
4330            return mContainer.isShowing();
4331        }
4332
4333        private boolean isVisible() {
4334            // Always show a dragging handle.
4335            if (mIsDragging) {
4336                return true;
4337            }
4338
4339            if (mTextView.isInBatchEditMode()) {
4340                return false;
4341            }
4342
4343            return mTextView.isPositionVisible(
4344                    mPositionX + mHotspotX + getHorizontalOffset(), mPositionY);
4345        }
4346
4347        public abstract int getCurrentCursorOffset();
4348
4349        protected abstract void updateSelection(int offset);
4350
4351        protected abstract void updatePosition(float x, float y, boolean fromTouchScreen);
4352
4353        protected boolean isAtRtlRun(@NonNull Layout layout, int offset) {
4354            return layout.isRtlCharAt(offset);
4355        }
4356
4357        @VisibleForTesting
4358        public float getHorizontal(@NonNull Layout layout, int offset) {
4359            return layout.getPrimaryHorizontal(offset);
4360        }
4361
4362        protected int getOffsetAtCoordinate(@NonNull Layout layout, int line, float x) {
4363            return mTextView.getOffsetAtCoordinate(line, x);
4364        }
4365
4366        /**
4367         * @param offset Cursor offset. Must be in [-1, length].
4368         * @param forceUpdatePosition whether to force update the position.  This should be true
4369         * when If the parent has been scrolled, for example.
4370         * @param fromTouchScreen {@code true} if the cursor is moved with motion events from the
4371         * touch screen.
4372         */
4373        protected void positionAtCursorOffset(int offset, boolean forceUpdatePosition,
4374                boolean fromTouchScreen) {
4375            // A HandleView relies on the layout, which may be nulled by external methods
4376            Layout layout = mTextView.getLayout();
4377            if (layout == null) {
4378                // Will update controllers' state, hiding them and stopping selection mode if needed
4379                prepareCursorControllers();
4380                return;
4381            }
4382            layout = mTextView.getLayout();
4383
4384            boolean offsetChanged = offset != mPreviousOffset;
4385            if (offsetChanged || forceUpdatePosition) {
4386                if (offsetChanged) {
4387                    updateSelection(offset);
4388                    if (fromTouchScreen && mHapticTextHandleEnabled) {
4389                        mTextView.performHapticFeedback(HapticFeedbackConstants.TEXT_HANDLE_MOVE);
4390                    }
4391                    addPositionToTouchUpFilter(offset);
4392                }
4393                final int line = layout.getLineForOffset(offset);
4394                mPrevLine = line;
4395
4396                mPositionX = getCursorHorizontalPosition(layout, offset) - mHotspotX
4397                        - getHorizontalOffset() + getCursorOffset();
4398                mPositionY = layout.getLineBottom(line);
4399
4400                // Take TextView's padding and scroll into account.
4401                mPositionX += mTextView.viewportToContentHorizontalOffset();
4402                mPositionY += mTextView.viewportToContentVerticalOffset();
4403
4404                mPreviousOffset = offset;
4405                mPositionHasChanged = true;
4406            }
4407        }
4408
4409        /**
4410         * Return the clamped horizontal position for the first cursor.
4411         *
4412         * @param layout Text layout.
4413         * @param offset Character offset for the cursor.
4414         * @return The clamped horizontal position for the cursor.
4415         */
4416        int getCursorHorizontalPosition(Layout layout, int offset) {
4417            return (int) (getHorizontal(layout, offset) - 0.5f);
4418        }
4419
4420        @Override
4421        public void updatePosition(int parentPositionX, int parentPositionY,
4422                boolean parentPositionChanged, boolean parentScrolled) {
4423            positionAtCursorOffset(getCurrentCursorOffset(), parentScrolled, false);
4424            if (parentPositionChanged || mPositionHasChanged) {
4425                if (mIsDragging) {
4426                    // Update touchToWindow offset in case of parent scrolling while dragging
4427                    if (parentPositionX != mLastParentX || parentPositionY != mLastParentY) {
4428                        mTouchToWindowOffsetX += parentPositionX - mLastParentX;
4429                        mTouchToWindowOffsetY += parentPositionY - mLastParentY;
4430                        mLastParentX = parentPositionX;
4431                        mLastParentY = parentPositionY;
4432                    }
4433
4434                    onHandleMoved();
4435                }
4436
4437                if (isVisible()) {
4438                    // Transform to the window coordinates to follow the view tranformation.
4439                    final int[] pts = { mPositionX + mHotspotX + getHorizontalOffset(), mPositionY};
4440                    mTextView.transformFromViewToWindowSpace(pts);
4441                    pts[0] -= mHotspotX + getHorizontalOffset();
4442
4443                    if (isShowing()) {
4444                        mContainer.update(pts[0], pts[1], -1, -1);
4445                    } else {
4446                        mContainer.showAtLocation(mTextView, Gravity.NO_GRAVITY, pts[0], pts[1]);
4447                    }
4448                } else {
4449                    if (isShowing()) {
4450                        dismiss();
4451                    }
4452                }
4453
4454                mPositionHasChanged = false;
4455            }
4456        }
4457
4458        @Override
4459        protected void onDraw(Canvas c) {
4460            final int drawWidth = mDrawable.getIntrinsicWidth();
4461            final int left = getHorizontalOffset();
4462
4463            mDrawable.setBounds(left, 0, left + drawWidth, mDrawable.getIntrinsicHeight());
4464            mDrawable.draw(c);
4465        }
4466
4467        private int getHorizontalOffset() {
4468            final int width = getPreferredWidth();
4469            final int drawWidth = mDrawable.getIntrinsicWidth();
4470            final int left;
4471            switch (mHorizontalGravity) {
4472                case Gravity.LEFT:
4473                    left = 0;
4474                    break;
4475                default:
4476                case Gravity.CENTER:
4477                    left = (width - drawWidth) / 2;
4478                    break;
4479                case Gravity.RIGHT:
4480                    left = width - drawWidth;
4481                    break;
4482            }
4483            return left;
4484        }
4485
4486        protected int getCursorOffset() {
4487            return 0;
4488        }
4489
4490        @Override
4491        public boolean onTouchEvent(MotionEvent ev) {
4492            updateFloatingToolbarVisibility(ev);
4493
4494            switch (ev.getActionMasked()) {
4495                case MotionEvent.ACTION_DOWN: {
4496                    startTouchUpFilter(getCurrentCursorOffset());
4497
4498                    final PositionListener positionListener = getPositionListener();
4499                    mLastParentX = positionListener.getPositionX();
4500                    mLastParentY = positionListener.getPositionY();
4501                    mLastParentXOnScreen = positionListener.getPositionXOnScreen();
4502                    mLastParentYOnScreen = positionListener.getPositionYOnScreen();
4503
4504                    final float xInWindow = ev.getRawX() - mLastParentXOnScreen + mLastParentX;
4505                    final float yInWindow = ev.getRawY() - mLastParentYOnScreen + mLastParentY;
4506                    mTouchToWindowOffsetX = xInWindow - mPositionX;
4507                    mTouchToWindowOffsetY = yInWindow - mPositionY;
4508
4509                    mIsDragging = true;
4510                    mPreviousLineTouched = UNSET_LINE;
4511                    break;
4512                }
4513
4514                case MotionEvent.ACTION_MOVE: {
4515                    final float xInWindow = ev.getRawX() - mLastParentXOnScreen + mLastParentX;
4516                    final float yInWindow = ev.getRawY() - mLastParentYOnScreen + mLastParentY;
4517
4518                    // Vertical hysteresis: vertical down movement tends to snap to ideal offset
4519                    final float previousVerticalOffset = mTouchToWindowOffsetY - mLastParentY;
4520                    final float currentVerticalOffset = yInWindow - mPositionY - mLastParentY;
4521                    float newVerticalOffset;
4522                    if (previousVerticalOffset < mIdealVerticalOffset) {
4523                        newVerticalOffset = Math.min(currentVerticalOffset, mIdealVerticalOffset);
4524                        newVerticalOffset = Math.max(newVerticalOffset, previousVerticalOffset);
4525                    } else {
4526                        newVerticalOffset = Math.max(currentVerticalOffset, mIdealVerticalOffset);
4527                        newVerticalOffset = Math.min(newVerticalOffset, previousVerticalOffset);
4528                    }
4529                    mTouchToWindowOffsetY = newVerticalOffset + mLastParentY;
4530
4531                    final float newPosX =
4532                            xInWindow - mTouchToWindowOffsetX + mHotspotX + getHorizontalOffset();
4533                    final float newPosY = yInWindow - mTouchToWindowOffsetY + mTouchOffsetY;
4534
4535                    updatePosition(newPosX, newPosY,
4536                            ev.isFromSource(InputDevice.SOURCE_TOUCHSCREEN));
4537                    break;
4538                }
4539
4540                case MotionEvent.ACTION_UP:
4541                    filterOnTouchUp(ev.isFromSource(InputDevice.SOURCE_TOUCHSCREEN));
4542                    mIsDragging = false;
4543                    updateDrawable();
4544                    break;
4545
4546                case MotionEvent.ACTION_CANCEL:
4547                    mIsDragging = false;
4548                    updateDrawable();
4549                    break;
4550            }
4551            return true;
4552        }
4553
4554        public boolean isDragging() {
4555            return mIsDragging;
4556        }
4557
4558        void onHandleMoved() {}
4559
4560        public void onDetached() {}
4561    }
4562
4563    private class InsertionHandleView extends HandleView {
4564        private static final int DELAY_BEFORE_HANDLE_FADES_OUT = 4000;
4565        private static final int RECENT_CUT_COPY_DURATION = 15 * 1000; // seconds
4566
4567        // Used to detect taps on the insertion handle, which will affect the insertion action mode
4568        private float mDownPositionX, mDownPositionY;
4569        private Runnable mHider;
4570
4571        public InsertionHandleView(Drawable drawable) {
4572            super(drawable, drawable, com.android.internal.R.id.insertion_handle);
4573        }
4574
4575        @Override
4576        public void show() {
4577            super.show();
4578
4579            final long durationSinceCutOrCopy =
4580                    SystemClock.uptimeMillis() - TextView.sLastCutCopyOrTextChangedTime;
4581
4582            // Cancel the single tap delayed runnable.
4583            if (mInsertionActionModeRunnable != null
4584                    && ((mTapState == TAP_STATE_DOUBLE_TAP)
4585                            || (mTapState == TAP_STATE_TRIPLE_CLICK)
4586                            || isCursorInsideEasyCorrectionSpan())) {
4587                mTextView.removeCallbacks(mInsertionActionModeRunnable);
4588            }
4589
4590            // Prepare and schedule the single tap runnable to run exactly after the double tap
4591            // timeout has passed.
4592            if ((mTapState != TAP_STATE_DOUBLE_TAP) && (mTapState != TAP_STATE_TRIPLE_CLICK)
4593                    && !isCursorInsideEasyCorrectionSpan()
4594                    && (durationSinceCutOrCopy < RECENT_CUT_COPY_DURATION)) {
4595                if (mTextActionMode == null) {
4596                    if (mInsertionActionModeRunnable == null) {
4597                        mInsertionActionModeRunnable = new Runnable() {
4598                            @Override
4599                            public void run() {
4600                                startInsertionActionMode();
4601                            }
4602                        };
4603                    }
4604                    mTextView.postDelayed(
4605                            mInsertionActionModeRunnable,
4606                            ViewConfiguration.getDoubleTapTimeout() + 1);
4607                }
4608
4609            }
4610
4611            hideAfterDelay();
4612        }
4613
4614        private void hideAfterDelay() {
4615            if (mHider == null) {
4616                mHider = new Runnable() {
4617                    public void run() {
4618                        hide();
4619                    }
4620                };
4621            } else {
4622                removeHiderCallback();
4623            }
4624            mTextView.postDelayed(mHider, DELAY_BEFORE_HANDLE_FADES_OUT);
4625        }
4626
4627        private void removeHiderCallback() {
4628            if (mHider != null) {
4629                mTextView.removeCallbacks(mHider);
4630            }
4631        }
4632
4633        @Override
4634        protected int getHotspotX(Drawable drawable, boolean isRtlRun) {
4635            return drawable.getIntrinsicWidth() / 2;
4636        }
4637
4638        @Override
4639        protected int getHorizontalGravity(boolean isRtlRun) {
4640            return Gravity.CENTER_HORIZONTAL;
4641        }
4642
4643        @Override
4644        protected int getCursorOffset() {
4645            int offset = super.getCursorOffset();
4646            final Drawable cursor = mCursorCount > 0 ? mCursorDrawable[0] : null;
4647            if (cursor != null) {
4648                cursor.getPadding(mTempRect);
4649                offset += (cursor.getIntrinsicWidth() - mTempRect.left - mTempRect.right) / 2;
4650            }
4651            return offset;
4652        }
4653
4654        @Override
4655        int getCursorHorizontalPosition(Layout layout, int offset) {
4656            final Drawable drawable = mCursorCount > 0 ? mCursorDrawable[0] : null;
4657            if (drawable != null) {
4658                final float horizontal = getHorizontal(layout, offset);
4659                return clampHorizontalPosition(drawable, horizontal) + mTempRect.left;
4660            }
4661            return super.getCursorHorizontalPosition(layout, offset);
4662        }
4663
4664        @Override
4665        public boolean onTouchEvent(MotionEvent ev) {
4666            final boolean result = super.onTouchEvent(ev);
4667
4668            switch (ev.getActionMasked()) {
4669                case MotionEvent.ACTION_DOWN:
4670                    mDownPositionX = ev.getRawX();
4671                    mDownPositionY = ev.getRawY();
4672                    break;
4673
4674                case MotionEvent.ACTION_UP:
4675                    if (!offsetHasBeenChanged()) {
4676                        final float deltaX = mDownPositionX - ev.getRawX();
4677                        final float deltaY = mDownPositionY - ev.getRawY();
4678                        final float distanceSquared = deltaX * deltaX + deltaY * deltaY;
4679
4680                        final ViewConfiguration viewConfiguration = ViewConfiguration.get(
4681                                mTextView.getContext());
4682                        final int touchSlop = viewConfiguration.getScaledTouchSlop();
4683
4684                        if (distanceSquared < touchSlop * touchSlop) {
4685                            // Tapping on the handle toggles the insertion action mode.
4686                            if (mTextActionMode != null) {
4687                                stopTextActionMode();
4688                            } else {
4689                                startInsertionActionMode();
4690                            }
4691                        }
4692                    } else {
4693                        if (mTextActionMode != null) {
4694                            mTextActionMode.invalidateContentRect();
4695                        }
4696                    }
4697                    hideAfterDelay();
4698                    break;
4699
4700                case MotionEvent.ACTION_CANCEL:
4701                    hideAfterDelay();
4702                    break;
4703
4704                default:
4705                    break;
4706            }
4707
4708            return result;
4709        }
4710
4711        @Override
4712        public int getCurrentCursorOffset() {
4713            return mTextView.getSelectionStart();
4714        }
4715
4716        @Override
4717        public void updateSelection(int offset) {
4718            Selection.setSelection((Spannable) mTextView.getText(), offset);
4719        }
4720
4721        @Override
4722        protected void updatePosition(float x, float y, boolean fromTouchScreen) {
4723            Layout layout = mTextView.getLayout();
4724            int offset;
4725            if (layout != null) {
4726                if (mPreviousLineTouched == UNSET_LINE) {
4727                    mPreviousLineTouched = mTextView.getLineAtCoordinate(y);
4728                }
4729                int currLine = getCurrentLineAdjustedForSlop(layout, mPreviousLineTouched, y);
4730                offset = getOffsetAtCoordinate(layout, currLine, x);
4731                mPreviousLineTouched = currLine;
4732            } else {
4733                offset = -1;
4734            }
4735            positionAtCursorOffset(offset, false, fromTouchScreen);
4736            if (mTextActionMode != null) {
4737                invalidateActionMode();
4738            }
4739        }
4740
4741        @Override
4742        void onHandleMoved() {
4743            super.onHandleMoved();
4744            removeHiderCallback();
4745        }
4746
4747        @Override
4748        public void onDetached() {
4749            super.onDetached();
4750            removeHiderCallback();
4751        }
4752    }
4753
4754    @Retention(RetentionPolicy.SOURCE)
4755    @IntDef({HANDLE_TYPE_SELECTION_START, HANDLE_TYPE_SELECTION_END})
4756    public @interface HandleType {}
4757    public static final int HANDLE_TYPE_SELECTION_START = 0;
4758    public static final int HANDLE_TYPE_SELECTION_END = 1;
4759
4760    private class SelectionHandleView extends HandleView {
4761        // Indicates the handle type, selection start (HANDLE_TYPE_SELECTION_START) or selection
4762        // end (HANDLE_TYPE_SELECTION_END).
4763        @HandleType
4764        private final int mHandleType;
4765        // Indicates whether the cursor is making adjustments within a word.
4766        private boolean mInWord = false;
4767        // Difference between touch position and word boundary position.
4768        private float mTouchWordDelta;
4769        // X value of the previous updatePosition call.
4770        private float mPrevX;
4771        // Indicates if the handle has moved a boundary between LTR and RTL text.
4772        private boolean mLanguageDirectionChanged = false;
4773        // Distance from edge of horizontally scrolling text view
4774        // to use to switch to character mode.
4775        private final float mTextViewEdgeSlop;
4776        // Used to save text view location.
4777        private final int[] mTextViewLocation = new int[2];
4778
4779        public SelectionHandleView(Drawable drawableLtr, Drawable drawableRtl, int id,
4780                @HandleType int handleType) {
4781            super(drawableLtr, drawableRtl, id);
4782            mHandleType = handleType;
4783            ViewConfiguration viewConfiguration = ViewConfiguration.get(mTextView.getContext());
4784            mTextViewEdgeSlop = viewConfiguration.getScaledTouchSlop() * 4;
4785        }
4786
4787        private boolean isStartHandle() {
4788            return mHandleType == HANDLE_TYPE_SELECTION_START;
4789        }
4790
4791        @Override
4792        protected int getHotspotX(Drawable drawable, boolean isRtlRun) {
4793            if (isRtlRun == isStartHandle()) {
4794                return drawable.getIntrinsicWidth() / 4;
4795            } else {
4796                return (drawable.getIntrinsicWidth() * 3) / 4;
4797            }
4798        }
4799
4800        @Override
4801        protected int getHorizontalGravity(boolean isRtlRun) {
4802            return (isRtlRun == isStartHandle()) ? Gravity.LEFT : Gravity.RIGHT;
4803        }
4804
4805        @Override
4806        public int getCurrentCursorOffset() {
4807            return isStartHandle() ? mTextView.getSelectionStart() : mTextView.getSelectionEnd();
4808        }
4809
4810        @Override
4811        protected void updateSelection(int offset) {
4812            if (isStartHandle()) {
4813                Selection.setSelection((Spannable) mTextView.getText(), offset,
4814                        mTextView.getSelectionEnd());
4815            } else {
4816                Selection.setSelection((Spannable) mTextView.getText(),
4817                        mTextView.getSelectionStart(), offset);
4818            }
4819            updateDrawable();
4820            if (mTextActionMode != null) {
4821                invalidateActionMode();
4822            }
4823        }
4824
4825        @Override
4826        protected void updatePosition(float x, float y, boolean fromTouchScreen) {
4827            final Layout layout = mTextView.getLayout();
4828            if (layout == null) {
4829                // HandleView will deal appropriately in positionAtCursorOffset when
4830                // layout is null.
4831                positionAndAdjustForCrossingHandles(mTextView.getOffsetForPosition(x, y),
4832                        fromTouchScreen);
4833                return;
4834            }
4835
4836            if (mPreviousLineTouched == UNSET_LINE) {
4837                mPreviousLineTouched = mTextView.getLineAtCoordinate(y);
4838            }
4839
4840            boolean positionCursor = false;
4841            final int anotherHandleOffset =
4842                    isStartHandle() ? mTextView.getSelectionEnd() : mTextView.getSelectionStart();
4843            int currLine = getCurrentLineAdjustedForSlop(layout, mPreviousLineTouched, y);
4844            int initialOffset = getOffsetAtCoordinate(layout, currLine, x);
4845
4846            if (isStartHandle() && initialOffset >= anotherHandleOffset
4847                    || !isStartHandle() && initialOffset <= anotherHandleOffset) {
4848                // Handles have crossed, bound it to the first selected line and
4849                // adjust by word / char as normal.
4850                currLine = layout.getLineForOffset(anotherHandleOffset);
4851                initialOffset = getOffsetAtCoordinate(layout, currLine, x);
4852            }
4853
4854            int offset = initialOffset;
4855            final int wordEnd = getWordEnd(offset);
4856            final int wordStart = getWordStart(offset);
4857
4858            if (mPrevX == UNSET_X_VALUE) {
4859                mPrevX = x;
4860            }
4861
4862            final int currentOffset = getCurrentCursorOffset();
4863            final boolean rtlAtCurrentOffset = isAtRtlRun(layout, currentOffset);
4864            final boolean atRtl = isAtRtlRun(layout, offset);
4865            final boolean isLvlBoundary = layout.isLevelBoundary(offset);
4866
4867            // We can't determine if the user is expanding or shrinking the selection if they're
4868            // on a bi-di boundary, so until they've moved past the boundary we'll just place
4869            // the cursor at the current position.
4870            if (isLvlBoundary || (rtlAtCurrentOffset && !atRtl) || (!rtlAtCurrentOffset && atRtl)) {
4871                // We're on a boundary or this is the first direction change -- just update
4872                // to the current position.
4873                mLanguageDirectionChanged = true;
4874                mTouchWordDelta = 0.0f;
4875                positionAndAdjustForCrossingHandles(offset, fromTouchScreen);
4876                return;
4877            } else if (mLanguageDirectionChanged && !isLvlBoundary) {
4878                // We've just moved past the boundary so update the position. After this we can
4879                // figure out if the user is expanding or shrinking to go by word or character.
4880                positionAndAdjustForCrossingHandles(offset, fromTouchScreen);
4881                mTouchWordDelta = 0.0f;
4882                mLanguageDirectionChanged = false;
4883                return;
4884            }
4885
4886            boolean isExpanding;
4887            final float xDiff = x - mPrevX;
4888            if (isStartHandle()) {
4889                isExpanding = currLine < mPreviousLineTouched;
4890            } else {
4891                isExpanding = currLine > mPreviousLineTouched;
4892            }
4893            if (atRtl == isStartHandle()) {
4894                isExpanding |= xDiff > 0;
4895            } else {
4896                isExpanding |= xDiff < 0;
4897            }
4898
4899            if (mTextView.getHorizontallyScrolling()) {
4900                if (positionNearEdgeOfScrollingView(x, atRtl)
4901                        && ((isStartHandle() && mTextView.getScrollX() != 0)
4902                                || (!isStartHandle()
4903                                        && mTextView.canScrollHorizontally(atRtl ? -1 : 1)))
4904                        && ((isExpanding && ((isStartHandle() && offset < currentOffset)
4905                                || (!isStartHandle() && offset > currentOffset)))
4906                                        || !isExpanding)) {
4907                    // If we're expanding ensure that the offset is actually expanding compared to
4908                    // the current offset, if the handle snapped to the word, the finger position
4909                    // may be out of sync and we don't want the selection to jump back.
4910                    mTouchWordDelta = 0.0f;
4911                    final int nextOffset = (atRtl == isStartHandle())
4912                            ? layout.getOffsetToRightOf(mPreviousOffset)
4913                            : layout.getOffsetToLeftOf(mPreviousOffset);
4914                    positionAndAdjustForCrossingHandles(nextOffset, fromTouchScreen);
4915                    return;
4916                }
4917            }
4918
4919            if (isExpanding) {
4920                // User is increasing the selection.
4921                int wordBoundary = isStartHandle() ? wordStart : wordEnd;
4922                final boolean snapToWord = (!mInWord
4923                        || (isStartHandle() ? currLine < mPrevLine : currLine > mPrevLine))
4924                                && atRtl == isAtRtlRun(layout, wordBoundary);
4925                if (snapToWord) {
4926                    // Sometimes words can be broken across lines (Chinese, hyphenation).
4927                    // We still snap to the word boundary but we only use the letters on the
4928                    // current line to determine if the user is far enough into the word to snap.
4929                    if (layout.getLineForOffset(wordBoundary) != currLine) {
4930                        wordBoundary = isStartHandle()
4931                                ? layout.getLineStart(currLine) : layout.getLineEnd(currLine);
4932                    }
4933                    final int offsetThresholdToSnap = isStartHandle()
4934                            ? wordEnd - ((wordEnd - wordBoundary) / 2)
4935                            : wordStart + ((wordBoundary - wordStart) / 2);
4936                    if (isStartHandle()
4937                            && (offset <= offsetThresholdToSnap || currLine < mPrevLine)) {
4938                        // User is far enough into the word or on a different line so we expand by
4939                        // word.
4940                        offset = wordStart;
4941                    } else if (!isStartHandle()
4942                            && (offset >= offsetThresholdToSnap || currLine > mPrevLine)) {
4943                        // User is far enough into the word or on a different line so we expand by
4944                        // word.
4945                        offset = wordEnd;
4946                    } else {
4947                        offset = mPreviousOffset;
4948                    }
4949                }
4950                if ((isStartHandle() && offset < initialOffset)
4951                        || (!isStartHandle() && offset > initialOffset)) {
4952                    final float adjustedX = getHorizontal(layout, offset);
4953                    mTouchWordDelta =
4954                            mTextView.convertToLocalHorizontalCoordinate(x) - adjustedX;
4955                } else {
4956                    mTouchWordDelta = 0.0f;
4957                }
4958                positionCursor = true;
4959            } else {
4960                final int adjustedOffset =
4961                        getOffsetAtCoordinate(layout, currLine, x - mTouchWordDelta);
4962                final boolean shrinking = isStartHandle()
4963                        ? adjustedOffset > mPreviousOffset || currLine > mPrevLine
4964                        : adjustedOffset < mPreviousOffset || currLine < mPrevLine;
4965                if (shrinking) {
4966                    // User is shrinking the selection.
4967                    if (currLine != mPrevLine) {
4968                        // We're on a different line, so we'll snap to word boundaries.
4969                        offset = isStartHandle() ? wordStart : wordEnd;
4970                        if ((isStartHandle() && offset < initialOffset)
4971                                || (!isStartHandle() && offset > initialOffset)) {
4972                            final float adjustedX = getHorizontal(layout, offset);
4973                            mTouchWordDelta =
4974                                    mTextView.convertToLocalHorizontalCoordinate(x) - adjustedX;
4975                        } else {
4976                            mTouchWordDelta = 0.0f;
4977                        }
4978                    } else {
4979                        offset = adjustedOffset;
4980                    }
4981                    positionCursor = true;
4982                } else if ((isStartHandle() && adjustedOffset < mPreviousOffset)
4983                        || (!isStartHandle() && adjustedOffset > mPreviousOffset)) {
4984                    // Handle has jumped to the word boundary, and the user is moving
4985                    // their finger towards the handle, the delta should be updated.
4986                    mTouchWordDelta = mTextView.convertToLocalHorizontalCoordinate(x)
4987                            - getHorizontal(layout, mPreviousOffset);
4988                }
4989            }
4990
4991            if (positionCursor) {
4992                mPreviousLineTouched = currLine;
4993                positionAndAdjustForCrossingHandles(offset, fromTouchScreen);
4994            }
4995            mPrevX = x;
4996        }
4997
4998        @Override
4999        protected void positionAtCursorOffset(int offset, boolean forceUpdatePosition,
5000                boolean fromTouchScreen) {
5001            super.positionAtCursorOffset(offset, forceUpdatePosition, fromTouchScreen);
5002            mInWord = (offset != -1) && !getWordIteratorWithText().isBoundary(offset);
5003        }
5004
5005        @Override
5006        public boolean onTouchEvent(MotionEvent event) {
5007            boolean superResult = super.onTouchEvent(event);
5008            if (event.getActionMasked() == MotionEvent.ACTION_DOWN) {
5009                // Reset the touch word offset and x value when the user
5010                // re-engages the handle.
5011                mTouchWordDelta = 0.0f;
5012                mPrevX = UNSET_X_VALUE;
5013            }
5014            return superResult;
5015        }
5016
5017        private void positionAndAdjustForCrossingHandles(int offset, boolean fromTouchScreen) {
5018            final int anotherHandleOffset =
5019                    isStartHandle() ? mTextView.getSelectionEnd() : mTextView.getSelectionStart();
5020            if ((isStartHandle() && offset >= anotherHandleOffset)
5021                    || (!isStartHandle() && offset <= anotherHandleOffset)) {
5022                mTouchWordDelta = 0.0f;
5023                final Layout layout = mTextView.getLayout();
5024                if (layout != null && offset != anotherHandleOffset) {
5025                    final float horiz = getHorizontal(layout, offset);
5026                    final float anotherHandleHoriz = getHorizontal(layout, anotherHandleOffset,
5027                            !isStartHandle());
5028                    final float currentHoriz = getHorizontal(layout, mPreviousOffset);
5029                    if (currentHoriz < anotherHandleHoriz && horiz < anotherHandleHoriz
5030                            || currentHoriz > anotherHandleHoriz && horiz > anotherHandleHoriz) {
5031                        // This handle passes another one as it crossed a direction boundary.
5032                        // Don't minimize the selection, but keep the handle at the run boundary.
5033                        final int currentOffset = getCurrentCursorOffset();
5034                        final int offsetToGetRunRange = isStartHandle()
5035                                ? currentOffset : Math.max(currentOffset - 1, 0);
5036                        final long range = layout.getRunRange(offsetToGetRunRange);
5037                        if (isStartHandle()) {
5038                            offset = TextUtils.unpackRangeStartFromLong(range);
5039                        } else {
5040                            offset = TextUtils.unpackRangeEndFromLong(range);
5041                        }
5042                        positionAtCursorOffset(offset, false, fromTouchScreen);
5043                        return;
5044                    }
5045                }
5046                // Handles can not cross and selection is at least one character.
5047                offset = getNextCursorOffset(anotherHandleOffset, !isStartHandle());
5048            }
5049            positionAtCursorOffset(offset, false, fromTouchScreen);
5050        }
5051
5052        private boolean positionNearEdgeOfScrollingView(float x, boolean atRtl) {
5053            mTextView.getLocationOnScreen(mTextViewLocation);
5054            boolean nearEdge;
5055            if (atRtl == isStartHandle()) {
5056                int rightEdge = mTextViewLocation[0] + mTextView.getWidth()
5057                        - mTextView.getPaddingRight();
5058                nearEdge = x > rightEdge - mTextViewEdgeSlop;
5059            } else {
5060                int leftEdge = mTextViewLocation[0] + mTextView.getPaddingLeft();
5061                nearEdge = x < leftEdge + mTextViewEdgeSlop;
5062            }
5063            return nearEdge;
5064        }
5065
5066        @Override
5067        protected boolean isAtRtlRun(@NonNull Layout layout, int offset) {
5068            final int offsetToCheck = isStartHandle() ? offset : Math.max(offset - 1, 0);
5069            return layout.isRtlCharAt(offsetToCheck);
5070        }
5071
5072        @Override
5073        public float getHorizontal(@NonNull Layout layout, int offset) {
5074            return getHorizontal(layout, offset, isStartHandle());
5075        }
5076
5077        private float getHorizontal(@NonNull Layout layout, int offset, boolean startHandle) {
5078            final int line = layout.getLineForOffset(offset);
5079            final int offsetToCheck = startHandle ? offset : Math.max(offset - 1, 0);
5080            final boolean isRtlChar = layout.isRtlCharAt(offsetToCheck);
5081            final boolean isRtlParagraph = layout.getParagraphDirection(line) == -1;
5082            return (isRtlChar == isRtlParagraph)
5083                    ? layout.getPrimaryHorizontal(offset) : layout.getSecondaryHorizontal(offset);
5084        }
5085
5086        @Override
5087        protected int getOffsetAtCoordinate(@NonNull Layout layout, int line, float x) {
5088            final float localX = mTextView.convertToLocalHorizontalCoordinate(x);
5089            final int primaryOffset = layout.getOffsetForHorizontal(line, localX, true);
5090            if (!layout.isLevelBoundary(primaryOffset)) {
5091                return primaryOffset;
5092            }
5093            final int secondaryOffset = layout.getOffsetForHorizontal(line, localX, false);
5094            final int currentOffset = getCurrentCursorOffset();
5095            final int primaryDiff = Math.abs(primaryOffset - currentOffset);
5096            final int secondaryDiff = Math.abs(secondaryOffset - currentOffset);
5097            if (primaryDiff < secondaryDiff) {
5098                return primaryOffset;
5099            } else if (primaryDiff > secondaryDiff) {
5100                return secondaryOffset;
5101            } else {
5102                final int offsetToCheck = isStartHandle()
5103                        ? currentOffset : Math.max(currentOffset - 1, 0);
5104                final boolean isRtlChar = layout.isRtlCharAt(offsetToCheck);
5105                final boolean isRtlParagraph = layout.getParagraphDirection(line) == -1;
5106                return isRtlChar == isRtlParagraph ? primaryOffset : secondaryOffset;
5107            }
5108        }
5109    }
5110
5111    private int getCurrentLineAdjustedForSlop(Layout layout, int prevLine, float y) {
5112        final int trueLine = mTextView.getLineAtCoordinate(y);
5113        if (layout == null || prevLine > layout.getLineCount()
5114                || layout.getLineCount() <= 0 || prevLine < 0) {
5115            // Invalid parameters, just return whatever line is at y.
5116            return trueLine;
5117        }
5118
5119        if (Math.abs(trueLine - prevLine) >= 2) {
5120            // Only stick to lines if we're within a line of the previous selection.
5121            return trueLine;
5122        }
5123
5124        final float verticalOffset = mTextView.viewportToContentVerticalOffset();
5125        final int lineCount = layout.getLineCount();
5126        final float slop = mTextView.getLineHeight() * LINE_SLOP_MULTIPLIER_FOR_HANDLEVIEWS;
5127
5128        final float firstLineTop = layout.getLineTop(0) + verticalOffset;
5129        final float prevLineTop = layout.getLineTop(prevLine) + verticalOffset;
5130        final float yTopBound = Math.max(prevLineTop - slop, firstLineTop + slop);
5131
5132        final float lastLineBottom = layout.getLineBottom(lineCount - 1) + verticalOffset;
5133        final float prevLineBottom = layout.getLineBottom(prevLine) + verticalOffset;
5134        final float yBottomBound = Math.min(prevLineBottom + slop, lastLineBottom - slop);
5135
5136        // Determine if we've moved lines based on y position and previous line.
5137        int currLine;
5138        if (y <= yTopBound) {
5139            currLine = Math.max(prevLine - 1, 0);
5140        } else if (y >= yBottomBound) {
5141            currLine = Math.min(prevLine + 1, lineCount - 1);
5142        } else {
5143            currLine = prevLine;
5144        }
5145        return currLine;
5146    }
5147
5148    /**
5149     * A CursorController instance can be used to control a cursor in the text.
5150     */
5151    private interface CursorController extends ViewTreeObserver.OnTouchModeChangeListener {
5152        /**
5153         * Makes the cursor controller visible on screen.
5154         * See also {@link #hide()}.
5155         */
5156        public void show();
5157
5158        /**
5159         * Hide the cursor controller from screen.
5160         * See also {@link #show()}.
5161         */
5162        public void hide();
5163
5164        /**
5165         * Called when the view is detached from window. Perform house keeping task, such as
5166         * stopping Runnable thread that would otherwise keep a reference on the context, thus
5167         * preventing the activity from being recycled.
5168         */
5169        public void onDetached();
5170
5171        public boolean isCursorBeingModified();
5172
5173        public boolean isActive();
5174    }
5175
5176    private class InsertionPointCursorController implements CursorController {
5177        private InsertionHandleView mHandle;
5178
5179        public void show() {
5180            getHandle().show();
5181
5182            if (mSelectionModifierCursorController != null) {
5183                mSelectionModifierCursorController.hide();
5184            }
5185        }
5186
5187        public void hide() {
5188            if (mHandle != null) {
5189                mHandle.hide();
5190            }
5191        }
5192
5193        public void onTouchModeChanged(boolean isInTouchMode) {
5194            if (!isInTouchMode) {
5195                hide();
5196            }
5197        }
5198
5199        private InsertionHandleView getHandle() {
5200            if (mSelectHandleCenter == null) {
5201                mSelectHandleCenter = mTextView.getContext().getDrawable(
5202                        mTextView.mTextSelectHandleRes);
5203            }
5204            if (mHandle == null) {
5205                mHandle = new InsertionHandleView(mSelectHandleCenter);
5206            }
5207            return mHandle;
5208        }
5209
5210        @Override
5211        public void onDetached() {
5212            final ViewTreeObserver observer = mTextView.getViewTreeObserver();
5213            observer.removeOnTouchModeChangeListener(this);
5214
5215            if (mHandle != null) mHandle.onDetached();
5216        }
5217
5218        @Override
5219        public boolean isCursorBeingModified() {
5220            return mHandle != null && mHandle.isDragging();
5221        }
5222
5223        @Override
5224        public boolean isActive() {
5225            return mHandle != null && mHandle.isShowing();
5226        }
5227
5228        public void invalidateHandle() {
5229            if (mHandle != null) {
5230                mHandle.invalidate();
5231            }
5232        }
5233    }
5234
5235    class SelectionModifierCursorController implements CursorController {
5236        // The cursor controller handles, lazily created when shown.
5237        private SelectionHandleView mStartHandle;
5238        private SelectionHandleView mEndHandle;
5239        // The offsets of that last touch down event. Remembered to start selection there.
5240        private int mMinTouchOffset, mMaxTouchOffset;
5241
5242        private float mDownPositionX, mDownPositionY;
5243        private boolean mGestureStayedInTapRegion;
5244
5245        // Where the user first starts the drag motion.
5246        private int mStartOffset = -1;
5247
5248        private boolean mHaventMovedEnoughToStartDrag;
5249        // The line that a selection happened most recently with the drag accelerator.
5250        private int mLineSelectionIsOn = -1;
5251        // Whether the drag accelerator has selected past the initial line.
5252        private boolean mSwitchedLines = false;
5253
5254        // Indicates the drag accelerator mode that the user is currently using.
5255        private int mDragAcceleratorMode = DRAG_ACCELERATOR_MODE_INACTIVE;
5256        // Drag accelerator is inactive.
5257        private static final int DRAG_ACCELERATOR_MODE_INACTIVE = 0;
5258        // Character based selection by dragging. Only for mouse.
5259        private static final int DRAG_ACCELERATOR_MODE_CHARACTER = 1;
5260        // Word based selection by dragging. Enabled after long pressing or double tapping.
5261        private static final int DRAG_ACCELERATOR_MODE_WORD = 2;
5262        // Paragraph based selection by dragging. Enabled after mouse triple click.
5263        private static final int DRAG_ACCELERATOR_MODE_PARAGRAPH = 3;
5264
5265        SelectionModifierCursorController() {
5266            resetTouchOffsets();
5267        }
5268
5269        public void show() {
5270            if (mTextView.isInBatchEditMode()) {
5271                return;
5272            }
5273            initDrawables();
5274            initHandles();
5275        }
5276
5277        private void initDrawables() {
5278            if (mSelectHandleLeft == null) {
5279                mSelectHandleLeft = mTextView.getContext().getDrawable(
5280                        mTextView.mTextSelectHandleLeftRes);
5281            }
5282            if (mSelectHandleRight == null) {
5283                mSelectHandleRight = mTextView.getContext().getDrawable(
5284                        mTextView.mTextSelectHandleRightRes);
5285            }
5286        }
5287
5288        private void initHandles() {
5289            // Lazy object creation has to be done before updatePosition() is called.
5290            if (mStartHandle == null) {
5291                mStartHandle = new SelectionHandleView(mSelectHandleLeft, mSelectHandleRight,
5292                        com.android.internal.R.id.selection_start_handle,
5293                        HANDLE_TYPE_SELECTION_START);
5294            }
5295            if (mEndHandle == null) {
5296                mEndHandle = new SelectionHandleView(mSelectHandleRight, mSelectHandleLeft,
5297                        com.android.internal.R.id.selection_end_handle,
5298                        HANDLE_TYPE_SELECTION_END);
5299            }
5300
5301            mStartHandle.show();
5302            mEndHandle.show();
5303
5304            hideInsertionPointCursorController();
5305        }
5306
5307        public void hide() {
5308            if (mStartHandle != null) mStartHandle.hide();
5309            if (mEndHandle != null) mEndHandle.hide();
5310        }
5311
5312        public void enterDrag(int dragAcceleratorMode) {
5313            // Just need to init the handles / hide insertion cursor.
5314            show();
5315            mDragAcceleratorMode = dragAcceleratorMode;
5316            // Start location of selection.
5317            mStartOffset = mTextView.getOffsetForPosition(mLastDownPositionX,
5318                    mLastDownPositionY);
5319            mLineSelectionIsOn = mTextView.getLineAtCoordinate(mLastDownPositionY);
5320            // Don't show the handles until user has lifted finger.
5321            hide();
5322
5323            // This stops scrolling parents from intercepting the touch event, allowing
5324            // the user to continue dragging across the screen to select text; TextView will
5325            // scroll as necessary.
5326            mTextView.getParent().requestDisallowInterceptTouchEvent(true);
5327            mTextView.cancelLongPress();
5328        }
5329
5330        public void onTouchEvent(MotionEvent event) {
5331            // This is done even when the View does not have focus, so that long presses can start
5332            // selection and tap can move cursor from this tap position.
5333            final float eventX = event.getX();
5334            final float eventY = event.getY();
5335            final boolean isMouse = event.isFromSource(InputDevice.SOURCE_MOUSE);
5336            switch (event.getActionMasked()) {
5337                case MotionEvent.ACTION_DOWN:
5338                    if (extractedTextModeWillBeStarted()) {
5339                        // Prevent duplicating the selection handles until the mode starts.
5340                        hide();
5341                    } else {
5342                        // Remember finger down position, to be able to start selection from there.
5343                        mMinTouchOffset = mMaxTouchOffset = mTextView.getOffsetForPosition(
5344                                eventX, eventY);
5345
5346                        // Double tap detection
5347                        if (mGestureStayedInTapRegion) {
5348                            if (mTapState == TAP_STATE_DOUBLE_TAP
5349                                    || mTapState == TAP_STATE_TRIPLE_CLICK) {
5350                                final float deltaX = eventX - mDownPositionX;
5351                                final float deltaY = eventY - mDownPositionY;
5352                                final float distanceSquared = deltaX * deltaX + deltaY * deltaY;
5353
5354                                ViewConfiguration viewConfiguration = ViewConfiguration.get(
5355                                        mTextView.getContext());
5356                                int doubleTapSlop = viewConfiguration.getScaledDoubleTapSlop();
5357                                boolean stayedInArea =
5358                                        distanceSquared < doubleTapSlop * doubleTapSlop;
5359
5360                                if (stayedInArea && (isMouse || isPositionOnText(eventX, eventY))) {
5361                                    if (mTapState == TAP_STATE_DOUBLE_TAP) {
5362                                        selectCurrentWordAndStartDrag();
5363                                    } else if (mTapState == TAP_STATE_TRIPLE_CLICK) {
5364                                        selectCurrentParagraphAndStartDrag();
5365                                    }
5366                                    mDiscardNextActionUp = true;
5367                                }
5368                            }
5369                        }
5370
5371                        mDownPositionX = eventX;
5372                        mDownPositionY = eventY;
5373                        mGestureStayedInTapRegion = true;
5374                        mHaventMovedEnoughToStartDrag = true;
5375                    }
5376                    break;
5377
5378                case MotionEvent.ACTION_POINTER_DOWN:
5379                case MotionEvent.ACTION_POINTER_UP:
5380                    // Handle multi-point gestures. Keep min and max offset positions.
5381                    // Only activated for devices that correctly handle multi-touch.
5382                    if (mTextView.getContext().getPackageManager().hasSystemFeature(
5383                            PackageManager.FEATURE_TOUCHSCREEN_MULTITOUCH_DISTINCT)) {
5384                        updateMinAndMaxOffsets(event);
5385                    }
5386                    break;
5387
5388                case MotionEvent.ACTION_MOVE:
5389                    final ViewConfiguration viewConfig = ViewConfiguration.get(
5390                            mTextView.getContext());
5391                    final int touchSlop = viewConfig.getScaledTouchSlop();
5392
5393                    if (mGestureStayedInTapRegion || mHaventMovedEnoughToStartDrag) {
5394                        final float deltaX = eventX - mDownPositionX;
5395                        final float deltaY = eventY - mDownPositionY;
5396                        final float distanceSquared = deltaX * deltaX + deltaY * deltaY;
5397
5398                        if (mGestureStayedInTapRegion) {
5399                            int doubleTapTouchSlop = viewConfig.getScaledDoubleTapTouchSlop();
5400                            mGestureStayedInTapRegion =
5401                                    distanceSquared <= doubleTapTouchSlop * doubleTapTouchSlop;
5402                        }
5403                        if (mHaventMovedEnoughToStartDrag) {
5404                            // We don't start dragging until the user has moved enough.
5405                            mHaventMovedEnoughToStartDrag =
5406                                    distanceSquared <= touchSlop * touchSlop;
5407                        }
5408                    }
5409
5410                    if (isMouse && !isDragAcceleratorActive()) {
5411                        final int offset = mTextView.getOffsetForPosition(eventX, eventY);
5412                        if (mTextView.hasSelection()
5413                                && (!mHaventMovedEnoughToStartDrag || mStartOffset != offset)
5414                                && offset >= mTextView.getSelectionStart()
5415                                && offset <= mTextView.getSelectionEnd()) {
5416                            startDragAndDrop();
5417                            break;
5418                        }
5419
5420                        if (mStartOffset != offset) {
5421                            // Start character based drag accelerator.
5422                            stopTextActionMode();
5423                            enterDrag(DRAG_ACCELERATOR_MODE_CHARACTER);
5424                            mDiscardNextActionUp = true;
5425                            mHaventMovedEnoughToStartDrag = false;
5426                        }
5427                    }
5428
5429                    if (mStartHandle != null && mStartHandle.isShowing()) {
5430                        // Don't do the drag if the handles are showing already.
5431                        break;
5432                    }
5433
5434                    updateSelection(event);
5435                    break;
5436
5437                case MotionEvent.ACTION_UP:
5438                    if (!isDragAcceleratorActive()) {
5439                        break;
5440                    }
5441                    updateSelection(event);
5442
5443                    // No longer dragging to select text, let the parent intercept events.
5444                    mTextView.getParent().requestDisallowInterceptTouchEvent(false);
5445
5446                    // No longer the first dragging motion, reset.
5447                    resetDragAcceleratorState();
5448
5449                    if (mTextView.hasSelection()) {
5450                        // Drag selection should not be adjusted by the text classifier.
5451                        startSelectionActionModeAsync(mHaventMovedEnoughToStartDrag);
5452                    }
5453                    break;
5454            }
5455        }
5456
5457        private void updateSelection(MotionEvent event) {
5458            if (mTextView.getLayout() != null) {
5459                switch (mDragAcceleratorMode) {
5460                    case DRAG_ACCELERATOR_MODE_CHARACTER:
5461                        updateCharacterBasedSelection(event);
5462                        break;
5463                    case DRAG_ACCELERATOR_MODE_WORD:
5464                        updateWordBasedSelection(event);
5465                        break;
5466                    case DRAG_ACCELERATOR_MODE_PARAGRAPH:
5467                        updateParagraphBasedSelection(event);
5468                        break;
5469                }
5470            }
5471        }
5472
5473        /**
5474         * If the TextView allows text selection, selects the current paragraph and starts a drag.
5475         *
5476         * @return true if the drag was started.
5477         */
5478        private boolean selectCurrentParagraphAndStartDrag() {
5479            if (mInsertionActionModeRunnable != null) {
5480                mTextView.removeCallbacks(mInsertionActionModeRunnable);
5481            }
5482            stopTextActionMode();
5483            if (!selectCurrentParagraph()) {
5484                return false;
5485            }
5486            enterDrag(SelectionModifierCursorController.DRAG_ACCELERATOR_MODE_PARAGRAPH);
5487            return true;
5488        }
5489
5490        private void updateCharacterBasedSelection(MotionEvent event) {
5491            final int offset = mTextView.getOffsetForPosition(event.getX(), event.getY());
5492            updateSelectionInternal(mStartOffset, offset,
5493                    event.isFromSource(InputDevice.SOURCE_TOUCHSCREEN));
5494        }
5495
5496        private void updateWordBasedSelection(MotionEvent event) {
5497            if (mHaventMovedEnoughToStartDrag) {
5498                return;
5499            }
5500            final boolean isMouse = event.isFromSource(InputDevice.SOURCE_MOUSE);
5501            final ViewConfiguration viewConfig = ViewConfiguration.get(
5502                    mTextView.getContext());
5503            final float eventX = event.getX();
5504            final float eventY = event.getY();
5505            final int currLine;
5506            if (isMouse) {
5507                // No need to offset the y coordinate for mouse input.
5508                currLine = mTextView.getLineAtCoordinate(eventY);
5509            } else {
5510                float y = eventY;
5511                if (mSwitchedLines) {
5512                    // Offset the finger by the same vertical offset as the handles.
5513                    // This improves visibility of the content being selected by
5514                    // shifting the finger below the content, this is applied once
5515                    // the user has switched lines.
5516                    final int touchSlop = viewConfig.getScaledTouchSlop();
5517                    final float fingerOffset = (mStartHandle != null)
5518                            ? mStartHandle.getIdealVerticalOffset()
5519                            : touchSlop;
5520                    y = eventY - fingerOffset;
5521                }
5522
5523                currLine = getCurrentLineAdjustedForSlop(mTextView.getLayout(), mLineSelectionIsOn,
5524                        y);
5525                if (!mSwitchedLines && currLine != mLineSelectionIsOn) {
5526                    // Break early here, we want to offset the finger position from
5527                    // the selection highlight, once the user moved their finger
5528                    // to a different line we should apply the offset and *not* switch
5529                    // lines until recomputing the position with the finger offset.
5530                    mSwitchedLines = true;
5531                    return;
5532                }
5533            }
5534
5535            int startOffset;
5536            int offset = mTextView.getOffsetAtCoordinate(currLine, eventX);
5537            // Snap to word boundaries.
5538            if (mStartOffset < offset) {
5539                // Expanding with end handle.
5540                offset = getWordEnd(offset);
5541                startOffset = getWordStart(mStartOffset);
5542            } else {
5543                // Expanding with start handle.
5544                offset = getWordStart(offset);
5545                startOffset = getWordEnd(mStartOffset);
5546                if (startOffset == offset) {
5547                    offset = getNextCursorOffset(offset, false);
5548                }
5549            }
5550            mLineSelectionIsOn = currLine;
5551            updateSelectionInternal(startOffset, offset,
5552                    event.isFromSource(InputDevice.SOURCE_TOUCHSCREEN));
5553        }
5554
5555        private void updateParagraphBasedSelection(MotionEvent event) {
5556            final int offset = mTextView.getOffsetForPosition(event.getX(), event.getY());
5557
5558            final int start = Math.min(offset, mStartOffset);
5559            final int end = Math.max(offset, mStartOffset);
5560            final long paragraphsRange = getParagraphsRange(start, end);
5561            final int selectionStart = TextUtils.unpackRangeStartFromLong(paragraphsRange);
5562            final int selectionEnd = TextUtils.unpackRangeEndFromLong(paragraphsRange);
5563            updateSelectionInternal(selectionStart, selectionEnd,
5564                    event.isFromSource(InputDevice.SOURCE_TOUCHSCREEN));
5565        }
5566
5567        private void updateSelectionInternal(int selectionStart, int selectionEnd,
5568                boolean fromTouchScreen) {
5569            final boolean performHapticFeedback = fromTouchScreen && mHapticTextHandleEnabled
5570                    && ((mTextView.getSelectionStart() != selectionStart)
5571                            || (mTextView.getSelectionEnd() != selectionEnd));
5572            Selection.setSelection((Spannable) mTextView.getText(), selectionStart, selectionEnd);
5573            if (performHapticFeedback) {
5574                mTextView.performHapticFeedback(HapticFeedbackConstants.TEXT_HANDLE_MOVE);
5575            }
5576        }
5577
5578        /**
5579         * @param event
5580         */
5581        private void updateMinAndMaxOffsets(MotionEvent event) {
5582            int pointerCount = event.getPointerCount();
5583            for (int index = 0; index < pointerCount; index++) {
5584                int offset = mTextView.getOffsetForPosition(event.getX(index), event.getY(index));
5585                if (offset < mMinTouchOffset) mMinTouchOffset = offset;
5586                if (offset > mMaxTouchOffset) mMaxTouchOffset = offset;
5587            }
5588        }
5589
5590        public int getMinTouchOffset() {
5591            return mMinTouchOffset;
5592        }
5593
5594        public int getMaxTouchOffset() {
5595            return mMaxTouchOffset;
5596        }
5597
5598        public void resetTouchOffsets() {
5599            mMinTouchOffset = mMaxTouchOffset = -1;
5600            resetDragAcceleratorState();
5601        }
5602
5603        private void resetDragAcceleratorState() {
5604            mStartOffset = -1;
5605            mDragAcceleratorMode = DRAG_ACCELERATOR_MODE_INACTIVE;
5606            mSwitchedLines = false;
5607            final int selectionStart = mTextView.getSelectionStart();
5608            final int selectionEnd = mTextView.getSelectionEnd();
5609            if (selectionStart > selectionEnd) {
5610                Selection.setSelection((Spannable) mTextView.getText(),
5611                        selectionEnd, selectionStart);
5612            }
5613        }
5614
5615        /**
5616         * @return true iff this controller is currently used to move the selection start.
5617         */
5618        public boolean isSelectionStartDragged() {
5619            return mStartHandle != null && mStartHandle.isDragging();
5620        }
5621
5622        @Override
5623        public boolean isCursorBeingModified() {
5624            return isDragAcceleratorActive() || isSelectionStartDragged()
5625                    || (mEndHandle != null && mEndHandle.isDragging());
5626        }
5627
5628        /**
5629         * @return true if the user is selecting text using the drag accelerator.
5630         */
5631        public boolean isDragAcceleratorActive() {
5632            return mDragAcceleratorMode != DRAG_ACCELERATOR_MODE_INACTIVE;
5633        }
5634
5635        public void onTouchModeChanged(boolean isInTouchMode) {
5636            if (!isInTouchMode) {
5637                hide();
5638            }
5639        }
5640
5641        @Override
5642        public void onDetached() {
5643            final ViewTreeObserver observer = mTextView.getViewTreeObserver();
5644            observer.removeOnTouchModeChangeListener(this);
5645
5646            if (mStartHandle != null) mStartHandle.onDetached();
5647            if (mEndHandle != null) mEndHandle.onDetached();
5648        }
5649
5650        @Override
5651        public boolean isActive() {
5652            return mStartHandle != null && mStartHandle.isShowing();
5653        }
5654
5655        public void invalidateHandles() {
5656            if (mStartHandle != null) {
5657                mStartHandle.invalidate();
5658            }
5659            if (mEndHandle != null) {
5660                mEndHandle.invalidate();
5661            }
5662        }
5663    }
5664
5665    private class CorrectionHighlighter {
5666        private final Path mPath = new Path();
5667        private final Paint mPaint = new Paint(Paint.ANTI_ALIAS_FLAG);
5668        private int mStart, mEnd;
5669        private long mFadingStartTime;
5670        private RectF mTempRectF;
5671        private static final int FADE_OUT_DURATION = 400;
5672
5673        public CorrectionHighlighter() {
5674            mPaint.setCompatibilityScaling(
5675                    mTextView.getResources().getCompatibilityInfo().applicationScale);
5676            mPaint.setStyle(Paint.Style.FILL);
5677        }
5678
5679        public void highlight(CorrectionInfo info) {
5680            mStart = info.getOffset();
5681            mEnd = mStart + info.getNewText().length();
5682            mFadingStartTime = SystemClock.uptimeMillis();
5683
5684            if (mStart < 0 || mEnd < 0) {
5685                stopAnimation();
5686            }
5687        }
5688
5689        public void draw(Canvas canvas, int cursorOffsetVertical) {
5690            if (updatePath() && updatePaint()) {
5691                if (cursorOffsetVertical != 0) {
5692                    canvas.translate(0, cursorOffsetVertical);
5693                }
5694
5695                canvas.drawPath(mPath, mPaint);
5696
5697                if (cursorOffsetVertical != 0) {
5698                    canvas.translate(0, -cursorOffsetVertical);
5699                }
5700                invalidate(true); // TODO invalidate cursor region only
5701            } else {
5702                stopAnimation();
5703                invalidate(false); // TODO invalidate cursor region only
5704            }
5705        }
5706
5707        private boolean updatePaint() {
5708            final long duration = SystemClock.uptimeMillis() - mFadingStartTime;
5709            if (duration > FADE_OUT_DURATION) return false;
5710
5711            final float coef = 1.0f - (float) duration / FADE_OUT_DURATION;
5712            final int highlightColorAlpha = Color.alpha(mTextView.mHighlightColor);
5713            final int color = (mTextView.mHighlightColor & 0x00FFFFFF)
5714                    + ((int) (highlightColorAlpha * coef) << 24);
5715            mPaint.setColor(color);
5716            return true;
5717        }
5718
5719        private boolean updatePath() {
5720            final Layout layout = mTextView.getLayout();
5721            if (layout == null) return false;
5722
5723            // Update in case text is edited while the animation is run
5724            final int length = mTextView.getText().length();
5725            int start = Math.min(length, mStart);
5726            int end = Math.min(length, mEnd);
5727
5728            mPath.reset();
5729            layout.getSelectionPath(start, end, mPath);
5730            return true;
5731        }
5732
5733        private void invalidate(boolean delayed) {
5734            if (mTextView.getLayout() == null) return;
5735
5736            if (mTempRectF == null) mTempRectF = new RectF();
5737            mPath.computeBounds(mTempRectF, false);
5738
5739            int left = mTextView.getCompoundPaddingLeft();
5740            int top = mTextView.getExtendedPaddingTop() + mTextView.getVerticalOffset(true);
5741
5742            if (delayed) {
5743                mTextView.postInvalidateOnAnimation(
5744                        left + (int) mTempRectF.left, top + (int) mTempRectF.top,
5745                        left + (int) mTempRectF.right, top + (int) mTempRectF.bottom);
5746            } else {
5747                mTextView.postInvalidate((int) mTempRectF.left, (int) mTempRectF.top,
5748                        (int) mTempRectF.right, (int) mTempRectF.bottom);
5749            }
5750        }
5751
5752        private void stopAnimation() {
5753            Editor.this.mCorrectionHighlighter = null;
5754        }
5755    }
5756
5757    private static class ErrorPopup extends PopupWindow {
5758        private boolean mAbove = false;
5759        private final TextView mView;
5760        private int mPopupInlineErrorBackgroundId = 0;
5761        private int mPopupInlineErrorAboveBackgroundId = 0;
5762
5763        ErrorPopup(TextView v, int width, int height) {
5764            super(v, width, height);
5765            mView = v;
5766            // Make sure the TextView has a background set as it will be used the first time it is
5767            // shown and positioned. Initialized with below background, which should have
5768            // dimensions identical to the above version for this to work (and is more likely).
5769            mPopupInlineErrorBackgroundId = getResourceId(mPopupInlineErrorBackgroundId,
5770                    com.android.internal.R.styleable.Theme_errorMessageBackground);
5771            mView.setBackgroundResource(mPopupInlineErrorBackgroundId);
5772        }
5773
5774        void fixDirection(boolean above) {
5775            mAbove = above;
5776
5777            if (above) {
5778                mPopupInlineErrorAboveBackgroundId =
5779                    getResourceId(mPopupInlineErrorAboveBackgroundId,
5780                            com.android.internal.R.styleable.Theme_errorMessageAboveBackground);
5781            } else {
5782                mPopupInlineErrorBackgroundId = getResourceId(mPopupInlineErrorBackgroundId,
5783                        com.android.internal.R.styleable.Theme_errorMessageBackground);
5784            }
5785
5786            mView.setBackgroundResource(
5787                    above ? mPopupInlineErrorAboveBackgroundId : mPopupInlineErrorBackgroundId);
5788        }
5789
5790        private int getResourceId(int currentId, int index) {
5791            if (currentId == 0) {
5792                TypedArray styledAttributes = mView.getContext().obtainStyledAttributes(
5793                        R.styleable.Theme);
5794                currentId = styledAttributes.getResourceId(index, 0);
5795                styledAttributes.recycle();
5796            }
5797            return currentId;
5798        }
5799
5800        @Override
5801        public void update(int x, int y, int w, int h, boolean force) {
5802            super.update(x, y, w, h, force);
5803
5804            boolean above = isAboveAnchor();
5805            if (above != mAbove) {
5806                fixDirection(above);
5807            }
5808        }
5809    }
5810
5811    static class InputContentType {
5812        int imeOptions = EditorInfo.IME_NULL;
5813        String privateImeOptions;
5814        CharSequence imeActionLabel;
5815        int imeActionId;
5816        Bundle extras;
5817        OnEditorActionListener onEditorActionListener;
5818        boolean enterDown;
5819        LocaleList imeHintLocales;
5820    }
5821
5822    static class InputMethodState {
5823        ExtractedTextRequest mExtractedTextRequest;
5824        final ExtractedText mExtractedText = new ExtractedText();
5825        int mBatchEditNesting;
5826        boolean mCursorChanged;
5827        boolean mSelectionModeChanged;
5828        boolean mContentChanged;
5829        int mChangedStart, mChangedEnd, mChangedDelta;
5830    }
5831
5832    /**
5833     * @return True iff (start, end) is a valid range within the text.
5834     */
5835    private static boolean isValidRange(CharSequence text, int start, int end) {
5836        return 0 <= start && start <= end && end <= text.length();
5837    }
5838
5839    @VisibleForTesting
5840    public SuggestionsPopupWindow getSuggestionsPopupWindowForTesting() {
5841        return mSuggestionsPopupWindow;
5842    }
5843
5844    /**
5845     * An InputFilter that monitors text input to maintain undo history. It does not modify the
5846     * text being typed (and hence always returns null from the filter() method).
5847     *
5848     * TODO: Make this span aware.
5849     */
5850    public static class UndoInputFilter implements InputFilter {
5851        private final Editor mEditor;
5852
5853        // Whether the current filter pass is directly caused by an end-user text edit.
5854        private boolean mIsUserEdit;
5855
5856        // Whether the text field is handling an IME composition. Must be parceled in case the user
5857        // rotates the screen during composition.
5858        private boolean mHasComposition;
5859
5860        // Whether the user is expanding or shortening the text
5861        private boolean mExpanding;
5862
5863        // Whether the previous edit operation was in the current batch edit.
5864        private boolean mPreviousOperationWasInSameBatchEdit;
5865
5866        public UndoInputFilter(Editor editor) {
5867            mEditor = editor;
5868        }
5869
5870        public void saveInstanceState(Parcel parcel) {
5871            parcel.writeInt(mIsUserEdit ? 1 : 0);
5872            parcel.writeInt(mHasComposition ? 1 : 0);
5873            parcel.writeInt(mExpanding ? 1 : 0);
5874            parcel.writeInt(mPreviousOperationWasInSameBatchEdit ? 1 : 0);
5875        }
5876
5877        public void restoreInstanceState(Parcel parcel) {
5878            mIsUserEdit = parcel.readInt() != 0;
5879            mHasComposition = parcel.readInt() != 0;
5880            mExpanding = parcel.readInt() != 0;
5881            mPreviousOperationWasInSameBatchEdit = parcel.readInt() != 0;
5882        }
5883
5884        /**
5885         * Signals that a user-triggered edit is starting.
5886         */
5887        public void beginBatchEdit() {
5888            if (DEBUG_UNDO) Log.d(TAG, "beginBatchEdit");
5889            mIsUserEdit = true;
5890        }
5891
5892        public void endBatchEdit() {
5893            if (DEBUG_UNDO) Log.d(TAG, "endBatchEdit");
5894            mIsUserEdit = false;
5895            mPreviousOperationWasInSameBatchEdit = false;
5896        }
5897
5898        @Override
5899        public CharSequence filter(CharSequence source, int start, int end,
5900                Spanned dest, int dstart, int dend) {
5901            if (DEBUG_UNDO) {
5902                Log.d(TAG, "filter: source=" + source + " (" + start + "-" + end + ") "
5903                        + "dest=" + dest + " (" + dstart + "-" + dend + ")");
5904            }
5905
5906            // Check to see if this edit should be tracked for undo.
5907            if (!canUndoEdit(source, start, end, dest, dstart, dend)) {
5908                return null;
5909            }
5910
5911            final boolean hadComposition = mHasComposition;
5912            mHasComposition = isComposition(source);
5913            final boolean wasExpanding = mExpanding;
5914            boolean shouldCreateSeparateState = false;
5915            if ((end - start) != (dend - dstart)) {
5916                mExpanding = (end - start) > (dend - dstart);
5917                if (hadComposition && mExpanding != wasExpanding) {
5918                    shouldCreateSeparateState = true;
5919                }
5920            }
5921
5922            // Handle edit.
5923            handleEdit(source, start, end, dest, dstart, dend, shouldCreateSeparateState);
5924            return null;
5925        }
5926
5927        void freezeLastEdit() {
5928            mEditor.mUndoManager.beginUpdate("Edit text");
5929            EditOperation lastEdit = getLastEdit();
5930            if (lastEdit != null) {
5931                lastEdit.mFrozen = true;
5932            }
5933            mEditor.mUndoManager.endUpdate();
5934        }
5935
5936        @Retention(RetentionPolicy.SOURCE)
5937        @IntDef({MERGE_EDIT_MODE_FORCE_MERGE, MERGE_EDIT_MODE_NEVER_MERGE, MERGE_EDIT_MODE_NORMAL})
5938        private @interface MergeMode {}
5939        private static final int MERGE_EDIT_MODE_FORCE_MERGE = 0;
5940        private static final int MERGE_EDIT_MODE_NEVER_MERGE = 1;
5941        /** Use {@link EditOperation#mergeWith} to merge */
5942        private static final int MERGE_EDIT_MODE_NORMAL = 2;
5943
5944        private void handleEdit(CharSequence source, int start, int end,
5945                Spanned dest, int dstart, int dend, boolean shouldCreateSeparateState) {
5946            // An application may install a TextWatcher to provide additional modifications after
5947            // the initial input filters run (e.g. a credit card formatter that adds spaces to a
5948            // string). This results in multiple filter() calls for what the user considers to be
5949            // a single operation. Always undo the whole set of changes in one step.
5950            @MergeMode
5951            final int mergeMode;
5952            if (isInTextWatcher() || mPreviousOperationWasInSameBatchEdit) {
5953                mergeMode = MERGE_EDIT_MODE_FORCE_MERGE;
5954            } else if (shouldCreateSeparateState) {
5955                mergeMode = MERGE_EDIT_MODE_NEVER_MERGE;
5956            } else {
5957                mergeMode = MERGE_EDIT_MODE_NORMAL;
5958            }
5959            // Build a new operation with all the information from this edit.
5960            String newText = TextUtils.substring(source, start, end);
5961            String oldText = TextUtils.substring(dest, dstart, dend);
5962            EditOperation edit = new EditOperation(mEditor, oldText, dstart, newText,
5963                    mHasComposition);
5964            if (mHasComposition && TextUtils.equals(edit.mNewText, edit.mOldText)) {
5965                return;
5966            }
5967            recordEdit(edit, mergeMode);
5968        }
5969
5970        private EditOperation getLastEdit() {
5971            final UndoManager um = mEditor.mUndoManager;
5972            return um.getLastOperation(
5973                  EditOperation.class, mEditor.mUndoOwner, UndoManager.MERGE_MODE_UNIQUE);
5974        }
5975        /**
5976         * Fetches the last undo operation and checks to see if a new edit should be merged into it.
5977         * If forceMerge is true then the new edit is always merged.
5978         */
5979        private void recordEdit(EditOperation edit, @MergeMode int mergeMode) {
5980            // Fetch the last edit operation and attempt to merge in the new edit.
5981            final UndoManager um = mEditor.mUndoManager;
5982            um.beginUpdate("Edit text");
5983            EditOperation lastEdit = getLastEdit();
5984            if (lastEdit == null) {
5985                // Add this as the first edit.
5986                if (DEBUG_UNDO) Log.d(TAG, "filter: adding first op " + edit);
5987                um.addOperation(edit, UndoManager.MERGE_MODE_NONE);
5988            } else if (mergeMode == MERGE_EDIT_MODE_FORCE_MERGE) {
5989                // Forced merges take priority because they could be the result of a non-user-edit
5990                // change and this case should not create a new undo operation.
5991                if (DEBUG_UNDO) Log.d(TAG, "filter: force merge " + edit);
5992                lastEdit.forceMergeWith(edit);
5993            } else if (!mIsUserEdit) {
5994                // An application directly modified the Editable outside of a text edit. Treat this
5995                // as a new change and don't attempt to merge.
5996                if (DEBUG_UNDO) Log.d(TAG, "non-user edit, new op " + edit);
5997                um.commitState(mEditor.mUndoOwner);
5998                um.addOperation(edit, UndoManager.MERGE_MODE_NONE);
5999            } else if (mergeMode == MERGE_EDIT_MODE_NORMAL && lastEdit.mergeWith(edit)) {
6000                // Merge succeeded, nothing else to do.
6001                if (DEBUG_UNDO) Log.d(TAG, "filter: merge succeeded, created " + lastEdit);
6002            } else {
6003                // Could not merge with the last edit, so commit the last edit and add this edit.
6004                if (DEBUG_UNDO) Log.d(TAG, "filter: merge failed, adding " + edit);
6005                um.commitState(mEditor.mUndoOwner);
6006                um.addOperation(edit, UndoManager.MERGE_MODE_NONE);
6007            }
6008            mPreviousOperationWasInSameBatchEdit = mIsUserEdit;
6009            um.endUpdate();
6010        }
6011
6012        private boolean canUndoEdit(CharSequence source, int start, int end,
6013                Spanned dest, int dstart, int dend) {
6014            if (!mEditor.mAllowUndo) {
6015                if (DEBUG_UNDO) Log.d(TAG, "filter: undo is disabled");
6016                return false;
6017            }
6018
6019            if (mEditor.mUndoManager.isInUndo()) {
6020                if (DEBUG_UNDO) Log.d(TAG, "filter: skipping, currently performing undo/redo");
6021                return false;
6022            }
6023
6024            // Text filters run before input operations are applied. However, some input operations
6025            // are invalid and will throw exceptions when applied. This is common in tests. Don't
6026            // attempt to undo invalid operations.
6027            if (!isValidRange(source, start, end) || !isValidRange(dest, dstart, dend)) {
6028                if (DEBUG_UNDO) Log.d(TAG, "filter: invalid op");
6029                return false;
6030            }
6031
6032            // Earlier filters can rewrite input to be a no-op, for example due to a length limit
6033            // on an input field. Skip no-op changes.
6034            if (start == end && dstart == dend) {
6035                if (DEBUG_UNDO) Log.d(TAG, "filter: skipping no-op");
6036                return false;
6037            }
6038
6039            return true;
6040        }
6041
6042        private static boolean isComposition(CharSequence source) {
6043            if (!(source instanceof Spannable)) {
6044                return false;
6045            }
6046            // This is a composition edit if the source has a non-zero-length composing span.
6047            Spannable text = (Spannable) source;
6048            int composeBegin = EditableInputConnection.getComposingSpanStart(text);
6049            int composeEnd = EditableInputConnection.getComposingSpanEnd(text);
6050            return composeBegin < composeEnd;
6051        }
6052
6053        private boolean isInTextWatcher() {
6054            CharSequence text = mEditor.mTextView.getText();
6055            return (text instanceof SpannableStringBuilder)
6056                    && ((SpannableStringBuilder) text).getTextWatcherDepth() > 0;
6057        }
6058    }
6059
6060    /**
6061     * An operation to undo a single "edit" to a text view.
6062     */
6063    public static class EditOperation extends UndoOperation<Editor> {
6064        private static final int TYPE_INSERT = 0;
6065        private static final int TYPE_DELETE = 1;
6066        private static final int TYPE_REPLACE = 2;
6067
6068        private int mType;
6069        private String mOldText;
6070        private String mNewText;
6071        private int mStart;
6072
6073        private int mOldCursorPos;
6074        private int mNewCursorPos;
6075        private boolean mFrozen;
6076        private boolean mIsComposition;
6077
6078        /**
6079         * Constructs an edit operation from a text input operation on editor that replaces the
6080         * oldText starting at dstart with newText.
6081         */
6082        public EditOperation(Editor editor, String oldText, int dstart, String newText,
6083                boolean isComposition) {
6084            super(editor.mUndoOwner);
6085            mOldText = oldText;
6086            mNewText = newText;
6087
6088            // Determine the type of the edit.
6089            if (mNewText.length() > 0 && mOldText.length() == 0) {
6090                mType = TYPE_INSERT;
6091            } else if (mNewText.length() == 0 && mOldText.length() > 0) {
6092                mType = TYPE_DELETE;
6093            } else {
6094                mType = TYPE_REPLACE;
6095            }
6096
6097            mStart = dstart;
6098            // Store cursor data.
6099            mOldCursorPos = editor.mTextView.getSelectionStart();
6100            mNewCursorPos = dstart + mNewText.length();
6101            mIsComposition = isComposition;
6102        }
6103
6104        public EditOperation(Parcel src, ClassLoader loader) {
6105            super(src, loader);
6106            mType = src.readInt();
6107            mOldText = src.readString();
6108            mNewText = src.readString();
6109            mStart = src.readInt();
6110            mOldCursorPos = src.readInt();
6111            mNewCursorPos = src.readInt();
6112            mFrozen = src.readInt() == 1;
6113            mIsComposition = src.readInt() == 1;
6114        }
6115
6116        @Override
6117        public void writeToParcel(Parcel dest, int flags) {
6118            dest.writeInt(mType);
6119            dest.writeString(mOldText);
6120            dest.writeString(mNewText);
6121            dest.writeInt(mStart);
6122            dest.writeInt(mOldCursorPos);
6123            dest.writeInt(mNewCursorPos);
6124            dest.writeInt(mFrozen ? 1 : 0);
6125            dest.writeInt(mIsComposition ? 1 : 0);
6126        }
6127
6128        private int getNewTextEnd() {
6129            return mStart + mNewText.length();
6130        }
6131
6132        private int getOldTextEnd() {
6133            return mStart + mOldText.length();
6134        }
6135
6136        @Override
6137        public void commit() {
6138        }
6139
6140        @Override
6141        public void undo() {
6142            if (DEBUG_UNDO) Log.d(TAG, "undo");
6143            // Remove the new text and insert the old.
6144            Editor editor = getOwnerData();
6145            Editable text = (Editable) editor.mTextView.getText();
6146            modifyText(text, mStart, getNewTextEnd(), mOldText, mStart, mOldCursorPos);
6147        }
6148
6149        @Override
6150        public void redo() {
6151            if (DEBUG_UNDO) Log.d(TAG, "redo");
6152            // Remove the old text and insert the new.
6153            Editor editor = getOwnerData();
6154            Editable text = (Editable) editor.mTextView.getText();
6155            modifyText(text, mStart, getOldTextEnd(), mNewText, mStart, mNewCursorPos);
6156        }
6157
6158        /**
6159         * Attempts to merge this existing operation with a new edit.
6160         * @param edit The new edit operation.
6161         * @return If the merge succeeded, returns true. Otherwise returns false and leaves this
6162         * object unchanged.
6163         */
6164        private boolean mergeWith(EditOperation edit) {
6165            if (DEBUG_UNDO) {
6166                Log.d(TAG, "mergeWith old " + this);
6167                Log.d(TAG, "mergeWith new " + edit);
6168            }
6169
6170            if (mFrozen) {
6171                return false;
6172            }
6173
6174            switch (mType) {
6175                case TYPE_INSERT:
6176                    return mergeInsertWith(edit);
6177                case TYPE_DELETE:
6178                    return mergeDeleteWith(edit);
6179                case TYPE_REPLACE:
6180                    return mergeReplaceWith(edit);
6181                default:
6182                    return false;
6183            }
6184        }
6185
6186        private boolean mergeInsertWith(EditOperation edit) {
6187            if (edit.mType == TYPE_INSERT) {
6188                // Merge insertions that are contiguous even when it's frozen.
6189                if (getNewTextEnd() != edit.mStart) {
6190                    return false;
6191                }
6192                mNewText += edit.mNewText;
6193                mNewCursorPos = edit.mNewCursorPos;
6194                mFrozen = edit.mFrozen;
6195                mIsComposition = edit.mIsComposition;
6196                return true;
6197            }
6198            if (mIsComposition && edit.mType == TYPE_REPLACE
6199                    && mStart <= edit.mStart && getNewTextEnd() >= edit.getOldTextEnd()) {
6200                // Merge insertion with replace as they can be single insertion.
6201                mNewText = mNewText.substring(0, edit.mStart - mStart) + edit.mNewText
6202                        + mNewText.substring(edit.getOldTextEnd() - mStart, mNewText.length());
6203                mNewCursorPos = edit.mNewCursorPos;
6204                mIsComposition = edit.mIsComposition;
6205                return true;
6206            }
6207            return false;
6208        }
6209
6210        // TODO: Support forward delete.
6211        private boolean mergeDeleteWith(EditOperation edit) {
6212            // Only merge continuous deletes.
6213            if (edit.mType != TYPE_DELETE) {
6214                return false;
6215            }
6216            // Only merge deletions that are contiguous.
6217            if (mStart != edit.getOldTextEnd()) {
6218                return false;
6219            }
6220            mStart = edit.mStart;
6221            mOldText = edit.mOldText + mOldText;
6222            mNewCursorPos = edit.mNewCursorPos;
6223            mIsComposition = edit.mIsComposition;
6224            return true;
6225        }
6226
6227        private boolean mergeReplaceWith(EditOperation edit) {
6228            if (edit.mType == TYPE_INSERT && getNewTextEnd() == edit.mStart) {
6229                // Merge with adjacent insert.
6230                mNewText += edit.mNewText;
6231                mNewCursorPos = edit.mNewCursorPos;
6232                return true;
6233            }
6234            if (!mIsComposition) {
6235                return false;
6236            }
6237            if (edit.mType == TYPE_DELETE && mStart <= edit.mStart
6238                    && getNewTextEnd() >= edit.getOldTextEnd()) {
6239                // Merge with delete as they can be single operation.
6240                mNewText = mNewText.substring(0, edit.mStart - mStart)
6241                        + mNewText.substring(edit.getOldTextEnd() - mStart, mNewText.length());
6242                if (mNewText.isEmpty()) {
6243                    mType = TYPE_DELETE;
6244                }
6245                mNewCursorPos = edit.mNewCursorPos;
6246                mIsComposition = edit.mIsComposition;
6247                return true;
6248            }
6249            if (edit.mType == TYPE_REPLACE && mStart == edit.mStart
6250                    && TextUtils.equals(mNewText, edit.mOldText)) {
6251                // Merge with the replace that replaces the same region.
6252                mNewText = edit.mNewText;
6253                mNewCursorPos = edit.mNewCursorPos;
6254                mIsComposition = edit.mIsComposition;
6255                return true;
6256            }
6257            return false;
6258        }
6259
6260        /**
6261         * Forcibly creates a single merged edit operation by simulating the entire text
6262         * contents being replaced.
6263         */
6264        public void forceMergeWith(EditOperation edit) {
6265            if (DEBUG_UNDO) Log.d(TAG, "forceMerge");
6266            if (mergeWith(edit)) {
6267                return;
6268            }
6269            Editor editor = getOwnerData();
6270
6271            // Copy the text of the current field.
6272            // NOTE: Using StringBuilder instead of SpannableStringBuilder would be somewhat faster,
6273            // but would require two parallel implementations of modifyText() because Editable and
6274            // StringBuilder do not share an interface for replace/delete/insert.
6275            Editable editable = (Editable) editor.mTextView.getText();
6276            Editable originalText = new SpannableStringBuilder(editable.toString());
6277
6278            // Roll back the last operation.
6279            modifyText(originalText, mStart, getNewTextEnd(), mOldText, mStart, mOldCursorPos);
6280
6281            // Clone the text again and apply the new operation.
6282            Editable finalText = new SpannableStringBuilder(editable.toString());
6283            modifyText(finalText, edit.mStart, edit.getOldTextEnd(),
6284                    edit.mNewText, edit.mStart, edit.mNewCursorPos);
6285
6286            // Convert this operation into a replace operation.
6287            mType = TYPE_REPLACE;
6288            mNewText = finalText.toString();
6289            mOldText = originalText.toString();
6290            mStart = 0;
6291            mNewCursorPos = edit.mNewCursorPos;
6292            mIsComposition = edit.mIsComposition;
6293            // mOldCursorPos is unchanged.
6294        }
6295
6296        private static void modifyText(Editable text, int deleteFrom, int deleteTo,
6297                CharSequence newText, int newTextInsertAt, int newCursorPos) {
6298            // Apply the edit if it is still valid.
6299            if (isValidRange(text, deleteFrom, deleteTo)
6300                    && newTextInsertAt <= text.length() - (deleteTo - deleteFrom)) {
6301                if (deleteFrom != deleteTo) {
6302                    text.delete(deleteFrom, deleteTo);
6303                }
6304                if (newText.length() != 0) {
6305                    text.insert(newTextInsertAt, newText);
6306                }
6307            }
6308            // Restore the cursor position. If there wasn't an old cursor (newCursorPos == -1) then
6309            // don't explicitly set it and rely on SpannableStringBuilder to position it.
6310            // TODO: Select all the text that was undone.
6311            if (0 <= newCursorPos && newCursorPos <= text.length()) {
6312                Selection.setSelection(text, newCursorPos);
6313            }
6314        }
6315
6316        private String getTypeString() {
6317            switch (mType) {
6318                case TYPE_INSERT:
6319                    return "insert";
6320                case TYPE_DELETE:
6321                    return "delete";
6322                case TYPE_REPLACE:
6323                    return "replace";
6324                default:
6325                    return "";
6326            }
6327        }
6328
6329        @Override
6330        public String toString() {
6331            return "[mType=" + getTypeString() + ", "
6332                    + "mOldText=" + mOldText + ", "
6333                    + "mNewText=" + mNewText + ", "
6334                    + "mStart=" + mStart + ", "
6335                    + "mOldCursorPos=" + mOldCursorPos + ", "
6336                    + "mNewCursorPos=" + mNewCursorPos + ", "
6337                    + "mFrozen=" + mFrozen + ", "
6338                    + "mIsComposition=" + mIsComposition + "]";
6339        }
6340
6341        public static final Parcelable.ClassLoaderCreator<EditOperation> CREATOR =
6342                new Parcelable.ClassLoaderCreator<EditOperation>() {
6343            @Override
6344            public EditOperation createFromParcel(Parcel in) {
6345                return new EditOperation(in, null);
6346            }
6347
6348            @Override
6349            public EditOperation createFromParcel(Parcel in, ClassLoader loader) {
6350                return new EditOperation(in, loader);
6351            }
6352
6353            @Override
6354            public EditOperation[] newArray(int size) {
6355                return new EditOperation[size];
6356            }
6357        };
6358    }
6359
6360    /**
6361     * A helper for enabling and handling "PROCESS_TEXT" menu actions.
6362     * These allow external applications to plug into currently selected text.
6363     */
6364    static final class ProcessTextIntentActionsHandler {
6365
6366        private final Editor mEditor;
6367        private final TextView mTextView;
6368        private final Context mContext;
6369        private final PackageManager mPackageManager;
6370        private final String mPackageName;
6371        private final SparseArray<Intent> mAccessibilityIntents = new SparseArray<>();
6372        private final SparseArray<AccessibilityNodeInfo.AccessibilityAction> mAccessibilityActions =
6373                new SparseArray<>();
6374        private final List<ResolveInfo> mSupportedActivities = new ArrayList<>();
6375
6376        private ProcessTextIntentActionsHandler(Editor editor) {
6377            mEditor = Preconditions.checkNotNull(editor);
6378            mTextView = Preconditions.checkNotNull(mEditor.mTextView);
6379            mContext = Preconditions.checkNotNull(mTextView.getContext());
6380            mPackageManager = Preconditions.checkNotNull(mContext.getPackageManager());
6381            mPackageName = Preconditions.checkNotNull(mContext.getPackageName());
6382        }
6383
6384        /**
6385         * Adds "PROCESS_TEXT" menu items to the specified menu.
6386         */
6387        public void onInitializeMenu(Menu menu) {
6388            final int size = mSupportedActivities.size();
6389            loadSupportedActivities();
6390            for (int i = 0; i < size; i++) {
6391                final ResolveInfo resolveInfo = mSupportedActivities.get(i);
6392                menu.add(Menu.NONE, Menu.NONE,
6393                        Editor.MENU_ITEM_ORDER_PROCESS_TEXT_INTENT_ACTIONS_START + i++,
6394                        getLabel(resolveInfo))
6395                        .setIntent(createProcessTextIntentForResolveInfo(resolveInfo))
6396                        .setShowAsAction(MenuItem.SHOW_AS_ACTION_IF_ROOM);
6397            }
6398        }
6399
6400        /**
6401         * Performs a "PROCESS_TEXT" action if there is one associated with the specified
6402         * menu item.
6403         *
6404         * @return True if the action was performed, false otherwise.
6405         */
6406        public boolean performMenuItemAction(MenuItem item) {
6407            return fireIntent(item.getIntent());
6408        }
6409
6410        /**
6411         * Initializes and caches "PROCESS_TEXT" accessibility actions.
6412         */
6413        public void initializeAccessibilityActions() {
6414            mAccessibilityIntents.clear();
6415            mAccessibilityActions.clear();
6416            int i = 0;
6417            loadSupportedActivities();
6418            for (ResolveInfo resolveInfo : mSupportedActivities) {
6419                int actionId = TextView.ACCESSIBILITY_ACTION_PROCESS_TEXT_START_ID + i++;
6420                mAccessibilityActions.put(
6421                        actionId,
6422                        new AccessibilityNodeInfo.AccessibilityAction(
6423                                actionId, getLabel(resolveInfo)));
6424                mAccessibilityIntents.put(
6425                        actionId, createProcessTextIntentForResolveInfo(resolveInfo));
6426            }
6427        }
6428
6429        /**
6430         * Adds "PROCESS_TEXT" accessibility actions to the specified accessibility node info.
6431         * NOTE: This needs a prior call to {@link #initializeAccessibilityActions()} to make the
6432         * latest accessibility actions available for this call.
6433         */
6434        public void onInitializeAccessibilityNodeInfo(AccessibilityNodeInfo nodeInfo) {
6435            for (int i = 0; i < mAccessibilityActions.size(); i++) {
6436                nodeInfo.addAction(mAccessibilityActions.valueAt(i));
6437            }
6438        }
6439
6440        /**
6441         * Performs a "PROCESS_TEXT" action if there is one associated with the specified
6442         * accessibility action id.
6443         *
6444         * @return True if the action was performed, false otherwise.
6445         */
6446        public boolean performAccessibilityAction(int actionId) {
6447            return fireIntent(mAccessibilityIntents.get(actionId));
6448        }
6449
6450        private boolean fireIntent(Intent intent) {
6451            if (intent != null && Intent.ACTION_PROCESS_TEXT.equals(intent.getAction())) {
6452                intent.putExtra(Intent.EXTRA_PROCESS_TEXT, mTextView.getSelectedText());
6453                mEditor.mPreserveSelection = true;
6454                mTextView.startActivityForResult(intent, TextView.PROCESS_TEXT_REQUEST_CODE);
6455                return true;
6456            }
6457            return false;
6458        }
6459
6460        private void loadSupportedActivities() {
6461            mSupportedActivities.clear();
6462            PackageManager packageManager = mTextView.getContext().getPackageManager();
6463            List<ResolveInfo> unfiltered =
6464                    packageManager.queryIntentActivities(createProcessTextIntent(), 0);
6465            for (ResolveInfo info : unfiltered) {
6466                if (isSupportedActivity(info)) {
6467                    mSupportedActivities.add(info);
6468                }
6469            }
6470        }
6471
6472        private boolean isSupportedActivity(ResolveInfo info) {
6473            return mPackageName.equals(info.activityInfo.packageName)
6474                    || info.activityInfo.exported
6475                            && (info.activityInfo.permission == null
6476                                    || mContext.checkSelfPermission(info.activityInfo.permission)
6477                                            == PackageManager.PERMISSION_GRANTED);
6478        }
6479
6480        private Intent createProcessTextIntentForResolveInfo(ResolveInfo info) {
6481            return createProcessTextIntent()
6482                    .putExtra(Intent.EXTRA_PROCESS_TEXT_READONLY, !mTextView.isTextEditable())
6483                    .setClassName(info.activityInfo.packageName, info.activityInfo.name);
6484        }
6485
6486        private Intent createProcessTextIntent() {
6487            return new Intent()
6488                    .setAction(Intent.ACTION_PROCESS_TEXT)
6489                    .setType("text/plain");
6490        }
6491
6492        private CharSequence getLabel(ResolveInfo resolveInfo) {
6493            return resolveInfo.loadLabel(mPackageManager);
6494        }
6495    }
6496}
6497