1/*
2
3 * Copyright (C) 2011 The Android Open Source Project
4 *
5 * Licensed under the Apache License, Version 2.0 (the "License");
6 * you may not use this file except in compliance with the License.
7 * You may obtain a copy of the License at
8 *
9 *      http://www.apache.org/licenses/LICENSE-2.0
10 *
11 * Unless required by applicable law or agreed to in writing, software
12 * distributed under the License is distributed on an "AS IS" BASIS,
13 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 * See the License for the specific language governing permissions and
15 * limitations under the License.
16 */
17
18package com.android.ex.chips;
19
20import android.annotation.TargetApi;
21import android.app.Activity;
22import android.app.AlertDialog;
23import android.app.DialogFragment;
24import android.content.ClipData;
25import android.content.ClipDescription;
26import android.content.ClipboardManager;
27import android.content.Context;
28import android.content.DialogInterface;
29import android.content.res.Resources;
30import android.content.res.TypedArray;
31import android.graphics.Bitmap;
32import android.graphics.BitmapFactory;
33import android.graphics.BitmapShader;
34import android.graphics.Canvas;
35import android.graphics.Color;
36import android.graphics.Matrix;
37import android.graphics.Paint;
38import android.graphics.Paint.Style;
39import android.graphics.Point;
40import android.graphics.Rect;
41import android.graphics.RectF;
42import android.graphics.Shader.TileMode;
43import android.graphics.drawable.BitmapDrawable;
44import android.graphics.drawable.Drawable;
45import android.graphics.drawable.StateListDrawable;
46import android.os.AsyncTask;
47import android.os.Build;
48import android.os.Bundle;
49import android.os.Handler;
50import android.os.Looper;
51import android.os.Message;
52import android.os.Parcelable;
53import android.support.annotation.NonNull;
54import android.text.Editable;
55import android.text.InputType;
56import android.text.Layout;
57import android.text.Spannable;
58import android.text.SpannableString;
59import android.text.SpannableStringBuilder;
60import android.text.Spanned;
61import android.text.TextPaint;
62import android.text.TextUtils;
63import android.text.TextWatcher;
64import android.text.method.QwertyKeyListener;
65import android.text.util.Rfc822Token;
66import android.text.util.Rfc822Tokenizer;
67import android.util.AttributeSet;
68import android.util.Log;
69import android.view.ActionMode;
70import android.view.ActionMode.Callback;
71import android.view.DragEvent;
72import android.view.GestureDetector;
73import android.view.KeyEvent;
74import android.view.LayoutInflater;
75import android.view.Menu;
76import android.view.MenuItem;
77import android.view.MotionEvent;
78import android.view.View;
79import android.view.ViewParent;
80import android.view.accessibility.AccessibilityEvent;
81import android.view.accessibility.AccessibilityManager;
82import android.view.inputmethod.EditorInfo;
83import android.view.inputmethod.InputConnection;
84import android.widget.AdapterView;
85import android.widget.AdapterView.OnItemClickListener;
86import android.widget.Filterable;
87import android.widget.ListAdapter;
88import android.widget.ListPopupWindow;
89import android.widget.ListView;
90import android.widget.MultiAutoCompleteTextView;
91import android.widget.PopupWindow;
92import android.widget.ScrollView;
93import android.widget.TextView;
94
95import com.android.ex.chips.DropdownChipLayouter.PermissionRequestDismissedListener;
96import com.android.ex.chips.RecipientAlternatesAdapter.RecipientMatchCallback;
97import com.android.ex.chips.recipientchip.DrawableRecipientChip;
98import com.android.ex.chips.recipientchip.InvisibleRecipientChip;
99import com.android.ex.chips.recipientchip.ReplacementDrawableSpan;
100import com.android.ex.chips.recipientchip.VisibleRecipientChip;
101
102import java.util.ArrayList;
103import java.util.Arrays;
104import java.util.Collections;
105import java.util.Comparator;
106import java.util.HashSet;
107import java.util.List;
108import java.util.Map;
109import java.util.Set;
110
111/**
112 * RecipientEditTextView is an auto complete text view for use with applications
113 * that use the new Chips UI for addressing a message to recipients.
114 */
115public class RecipientEditTextView extends MultiAutoCompleteTextView implements
116        OnItemClickListener, Callback, RecipientAlternatesAdapter.OnCheckedItemChangedListener,
117        GestureDetector.OnGestureListener, TextView.OnEditorActionListener,
118        DropdownChipLayouter.ChipDeleteListener, PermissionRequestDismissedListener {
119    private static final String TAG = "RecipientEditTextView";
120
121    private static final char COMMIT_CHAR_COMMA = ',';
122    private static final char COMMIT_CHAR_SEMICOLON = ';';
123    private static final char COMMIT_CHAR_SPACE = ' ';
124    private static final String SEPARATOR = String.valueOf(COMMIT_CHAR_COMMA)
125            + String.valueOf(COMMIT_CHAR_SPACE);
126
127    private static final int DISMISS = "dismiss".hashCode();
128    private static final long DISMISS_DELAY = 300;
129
130    // TODO: get correct number/ algorithm from with UX.
131    // Visible for testing.
132    /*package*/ static final int CHIP_LIMIT = 2;
133
134    private static final int MAX_CHIPS_PARSED = 50;
135    public static final String STATE_TEXT_VIEW = "savedTextView";
136    public static final String STATE_CURRENT_WARNING_TEXT = "savedCurrentWarningText";
137
138    private int mUnselectedChipTextColor;
139    private int mUnselectedChipBackgroundColor;
140
141    // Work variables to avoid re-allocation on every typed character.
142    private final Rect mRect = new Rect();
143    private final int[] mCoords = new int[2];
144
145    // Resources for displaying chips.
146    private Drawable mChipBackground = null;
147    private Drawable mChipDelete = null;
148    private Drawable mInvalidChipBackground;
149
150    // Possible attr overrides
151    private float mChipHeight;
152    private float mChipFontSize;
153    private float mLineSpacingExtra;
154    private int mChipTextStartPadding;
155    private int mChipTextEndPadding;
156    private final int mTextHeight;
157    private boolean mDisableDelete;
158    private int mMaxLines;
159    private int mWarningIconHeight;
160
161    /**
162     * Enumerator for avatar position. See attr.xml for more details.
163     * 0 for end, 1 for start.
164     */
165    private int mAvatarPosition;
166    private static final int AVATAR_POSITION_END = 0;
167    private static final int AVATAR_POSITION_START = 1;
168
169    private Paint mWorkPaint = new Paint();
170
171    private Tokenizer mTokenizer;
172    private Validator mValidator;
173    private Handler mHandler;
174    private TextWatcher mTextWatcher;
175    protected DropdownChipLayouter mDropdownChipLayouter;
176
177    private View mDropdownAnchor = this;
178    private ListPopupWindow mAlternatesPopup;
179    private ListPopupWindow mAddressPopup;
180    private View mAlternatePopupAnchor;
181    private OnItemClickListener mAlternatesListener;
182
183    private DrawableRecipientChip mSelectedChip;
184    private Bitmap mDefaultContactPhoto;
185    private Bitmap mWarningIcon;
186    private ReplacementDrawableSpan mMoreChip;
187    private TextView mMoreItem;
188
189    private int mCurrentSuggestionCount;
190
191    // VisibleForTesting
192    final ArrayList<String> mPendingChips = new ArrayList<String>();
193
194    private int mPendingChipsCount = 0;
195    private int mCheckedItem;
196    private boolean mNoChipMode = false;
197    private boolean mShouldShrink = true;
198    private boolean mRequiresShrinkWhenNotGone = false;
199
200    // VisibleForTesting
201    ArrayList<DrawableRecipientChip> mTemporaryRecipients;
202
203    private ArrayList<DrawableRecipientChip> mHiddenSpans;
204
205    // Chip copy fields.
206    private GestureDetector mGestureDetector;
207
208    // Obtain the enclosing scroll view, if it exists, so that the view can be
209    // scrolled to show the last line of chips content.
210    private ScrollView mScrollView;
211    private boolean mTriedGettingScrollView;
212    private boolean mDragEnabled = false;
213
214    private boolean mAttachedToWindow;
215
216    private final Runnable mAddTextWatcher = new Runnable() {
217        @Override
218        public void run() {
219            if (mTextWatcher == null) {
220                mTextWatcher = new RecipientTextWatcher();
221                addTextChangedListener(mTextWatcher);
222            }
223        }
224    };
225
226    private IndividualReplacementTask mIndividualReplacements;
227
228    private Runnable mHandlePendingChips = new Runnable() {
229
230        @Override
231        public void run() {
232            handlePendingChips();
233        }
234
235    };
236
237    private Runnable mDelayedShrink = new Runnable() {
238
239        @Override
240        public void run() {
241            shrink();
242        }
243
244    };
245
246    private RecipientEntryItemClickedListener mRecipientEntryItemClickedListener;
247
248    private RecipientChipAddedListener mRecipientChipAddedListener;
249    private RecipientChipDeletedListener mRecipientChipDeletedListener;
250
251    // A set of recipient addresses that are untrusted because they are outside of the user's
252    // domain. We will show a warning for these addresses in the recipient chips.
253    private Set<String> mUntrustedAddresses = new HashSet<>();
254
255    private String mWarningTextTemplate = "";
256    private String mWarningTitle = "";
257    // Text of the warning dialog currently being displayed. Empty if no dialog currently displayed.
258    private String mCurrentWarningText = "";
259
260    /**
261     * Sets this recipient edit text view to display warning icons in chips for the given addresses.
262     *
263     * @param untrustedAddresses The addresses to display warning icons for.
264     * @param warningIcon The icon to show for each address.
265     * @param warningIconHeight Height of the warning icon in
266     * @param warningTextTemplate Text to display when warning icon is clicked.
267     * @param warningTitle Title to display for text when warning icon is clicked.
268     */
269    public void setUntrustedAddressWarning(
270            Set<String> untrustedAddresses,
271            Bitmap warningIcon,
272            int warningIconHeight,
273            String warningTextTemplate,
274            String warningTitle) {
275        mUntrustedAddresses = untrustedAddresses;
276        mWarningIcon = warningIcon;
277        mWarningIconHeight = warningIconHeight;
278        mWarningTextTemplate = warningTextTemplate;
279        mWarningTitle = warningTitle;
280    }
281
282    public interface RecipientEntryItemClickedListener {
283        /**
284         * Callback that occurs whenever an auto-complete suggestion is clicked.
285         * @param charactersTyped the number of characters typed by the user to provide the
286         *                        auto-complete suggestions.
287         * @param position the position in the dropdown list that the user clicked
288         */
289        void onRecipientEntryItemClicked(int charactersTyped, int position);
290    }
291
292    private PermissionsRequestItemClickedListener mPermissionsRequestItemClickedListener;
293
294    /**
295     * Listener for handling clicks on the {@link RecipientEntry} that have
296     * {@link RecipientEntry#ENTRY_TYPE_PERMISSION_REQUEST} type.
297     */
298    public interface PermissionsRequestItemClickedListener {
299
300        /**
301         * Callback that occurs when user clicks the item that asks user to grant permissions to
302         * the app.
303         *
304         * @param view View that asks for permission.
305         */
306        void onPermissionsRequestItemClicked(RecipientEditTextView view, String[] permissions);
307
308        /**
309         * Callback that occurs when user dismisses the item that asks user to grant permissions to
310         * the app.
311         */
312        void onPermissionRequestDismissed();
313    }
314
315    /**
316     * Listener for handling deletion of chips in the recipient edit text.
317     */
318    public interface RecipientChipDeletedListener {
319        /**
320         * Callback that occurs when a chip is deleted.
321         * @param entry RecipientEntry that contains information about the chip.
322         */
323        void onRecipientChipDeleted(RecipientEntry entry);
324    }
325
326    /**
327     * Listener for handling addition of chips in the recipient edit text.
328     */
329    public interface RecipientChipAddedListener {
330        /**
331         * Callback that occurs when a chip is added.
332         *
333         * @param entry RecipientEntry that contains information about the chip.
334         */
335        void onRecipientChipAdded(RecipientEntry entry);
336    }
337
338    public RecipientEditTextView(Context context, AttributeSet attrs) {
339        super(context, attrs);
340        setChipDimensions(context, attrs);
341        mTextHeight = calculateTextHeight();
342        mAlternatesPopup = new ListPopupWindow(context);
343        setupPopupWindow(mAlternatesPopup);
344        mAddressPopup = new ListPopupWindow(context);
345        setupPopupWindow(mAddressPopup);
346        mAlternatesListener = new OnItemClickListener() {
347            @Override
348            public void onItemClick(AdapterView<?> adapterView,View view, int position,
349                    long rowId) {
350                mAlternatesPopup.setOnItemClickListener(null);
351                replaceChip(mSelectedChip, ((RecipientAlternatesAdapter) adapterView.getAdapter())
352                        .getRecipientEntry(position));
353                Message delayed = Message.obtain(mHandler, DISMISS);
354                delayed.obj = mAlternatesPopup;
355                mHandler.sendMessageDelayed(delayed, DISMISS_DELAY);
356                clearComposingText();
357            }
358        };
359        setInputType(getInputType() | InputType.TYPE_TEXT_FLAG_NO_SUGGESTIONS);
360        setOnItemClickListener(this);
361        setCustomSelectionActionModeCallback(this);
362        mHandler = new Handler() {
363            @Override
364            public void handleMessage(Message msg) {
365                if (msg.what == DISMISS) {
366                    ((ListPopupWindow) msg.obj).dismiss();
367                    return;
368                }
369                super.handleMessage(msg);
370            }
371        };
372        mTextWatcher = new RecipientTextWatcher();
373        addTextChangedListener(mTextWatcher);
374        mGestureDetector = new GestureDetector(context, this);
375        setOnEditorActionListener(this);
376
377        setDropdownChipLayouter(new DropdownChipLayouter(LayoutInflater.from(context), context));
378    }
379
380    private void setupPopupWindow(ListPopupWindow popup) {
381        popup.setOnDismissListener(new PopupWindow.OnDismissListener() {
382            @Override
383            public void onDismiss() {
384                clearSelectedChip();
385            }
386        });
387    }
388
389    private int calculateTextHeight() {
390        final TextPaint paint = getPaint();
391
392        mRect.setEmpty();
393        // First measure the bounds of a sample text.
394        final String textHeightSample = "a";
395        paint.getTextBounds(textHeightSample, 0, textHeightSample.length(), mRect);
396
397        mRect.left = 0;
398        mRect.right = 0;
399
400        return mRect.height();
401    }
402
403    public void setDropdownChipLayouter(DropdownChipLayouter dropdownChipLayouter) {
404        mDropdownChipLayouter = dropdownChipLayouter;
405        mDropdownChipLayouter.setDeleteListener(this);
406        mDropdownChipLayouter.setPermissionRequestDismissedListener(this);
407    }
408
409    public void setRecipientEntryItemClickedListener(RecipientEntryItemClickedListener listener) {
410        mRecipientEntryItemClickedListener = listener;
411    }
412
413    public void setPermissionsRequestItemClickedListener(
414            PermissionsRequestItemClickedListener listener) {
415        mPermissionsRequestItemClickedListener = listener;
416    }
417
418    public void setRecipientChipAddedListener(RecipientChipAddedListener listener) {
419        mRecipientChipAddedListener = listener;
420    }
421
422    public void setRecipientChipDeletedListener(RecipientChipDeletedListener listener) {
423        mRecipientChipDeletedListener = listener;
424    }
425
426    @Override
427    protected void onDetachedFromWindow() {
428        super.onDetachedFromWindow();
429        mAttachedToWindow = false;
430    }
431
432    @Override
433    protected void onAttachedToWindow() {
434        super.onAttachedToWindow();
435        mAttachedToWindow = true;
436
437        final int anchorId = getDropDownAnchor();
438        if (anchorId != View.NO_ID) {
439            mDropdownAnchor = getRootView().findViewById(anchorId);
440        }
441    }
442
443    @Override
444    public void setDropDownAnchor(int anchorId) {
445        super.setDropDownAnchor(anchorId);
446        if (anchorId != View.NO_ID) {
447          mDropdownAnchor = getRootView().findViewById(anchorId);
448        }
449    }
450
451    @Override
452    public boolean onEditorAction(TextView view, int action, KeyEvent keyEvent) {
453        if (action == EditorInfo.IME_ACTION_DONE) {
454            if (commitDefault()) {
455                return true;
456            }
457            if (mSelectedChip != null) {
458                clearSelectedChip();
459                return true;
460            } else if (hasFocus()) {
461                if (focusNext()) {
462                    return true;
463                }
464            }
465        }
466        return false;
467    }
468
469    @Override
470    public InputConnection onCreateInputConnection(@NonNull EditorInfo outAttrs) {
471        InputConnection connection = super.onCreateInputConnection(outAttrs);
472        int imeActions = outAttrs.imeOptions&EditorInfo.IME_MASK_ACTION;
473        if ((imeActions&EditorInfo.IME_ACTION_DONE) != 0) {
474            // clear the existing action
475            outAttrs.imeOptions ^= imeActions;
476            // set the DONE action
477            outAttrs.imeOptions |= EditorInfo.IME_ACTION_DONE;
478        }
479        if ((outAttrs.imeOptions&EditorInfo.IME_FLAG_NO_ENTER_ACTION) != 0) {
480            outAttrs.imeOptions &= ~EditorInfo.IME_FLAG_NO_ENTER_ACTION;
481        }
482
483        outAttrs.actionId = EditorInfo.IME_ACTION_DONE;
484
485        // Custom action labels are discouraged in L; a checkmark icon is shown in place of the
486        // custom text in this case.
487        outAttrs.actionLabel = Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP ? null :
488            getContext().getString(R.string.action_label);
489        return connection;
490    }
491
492    /*package*/ DrawableRecipientChip getLastChip() {
493        DrawableRecipientChip last = null;
494        DrawableRecipientChip[] chips = getSortedRecipients();
495        if (chips != null && chips.length > 0) {
496            last = chips[chips.length - 1];
497        }
498        return last;
499    }
500
501    /**
502     * @return The list of {@link RecipientEntry}s that have been selected by the user.
503     */
504    public List<RecipientEntry> getSelectedRecipients() {
505        DrawableRecipientChip[] chips =
506                getText().getSpans(0, getText().length(), DrawableRecipientChip.class);
507        List<RecipientEntry> results = new ArrayList<RecipientEntry>();
508        if (chips == null) {
509            return results;
510        }
511
512        for (DrawableRecipientChip c : chips) {
513            results.add(c.getEntry());
514        }
515
516        return results;
517    }
518
519    /**
520     * @return The list of {@link RecipientEntry}s that have been selected by the user and also
521     *         hidden due to {@link #mMoreChip} span.
522     */
523    public List<RecipientEntry> getAllRecipients() {
524        List<RecipientEntry> results = getSelectedRecipients();
525
526        if (mHiddenSpans != null) {
527            for (DrawableRecipientChip chip : mHiddenSpans) {
528                results.add(chip.getEntry());
529            }
530        }
531
532        return results;
533    }
534
535    @Override
536    public void onSelectionChanged(int start, int end) {
537        // When selection changes, see if it is inside the chips area.
538        // If so, move the cursor back after the chips again.
539        // Only exception is when we change the selection due to a selected chip.
540        DrawableRecipientChip last = getLastChip();
541        if (mSelectedChip == null && last != null && start < getSpannable().getSpanEnd(last)) {
542            // Grab the last chip and set the cursor to after it.
543            setSelection(Math.min(getSpannable().getSpanEnd(last) + 1, getText().length()));
544        }
545        super.onSelectionChanged(start, end);
546    }
547
548    @Override
549    public void onRestoreInstanceState(Parcelable state) {
550        Bundle savedInstanceState = (Bundle) state;
551        if (!TextUtils.isEmpty(getText())) {
552            super.onRestoreInstanceState(null);
553        } else {
554            super.onRestoreInstanceState(
555                    savedInstanceState.getParcelable(STATE_TEXT_VIEW));
556        }
557        String savedWarningText = savedInstanceState.getString(
558            STATE_CURRENT_WARNING_TEXT);
559        if (!savedWarningText.isEmpty()) {
560            showWarningDialog(savedWarningText);
561        }
562    }
563
564    @Override
565    public Parcelable onSaveInstanceState() {
566        // If the user changes orientation while they are editing, just roll back the selection.
567        clearSelectedChip();
568        Bundle savedInstanceState = new Bundle();
569        savedInstanceState.putParcelable(STATE_TEXT_VIEW, super.onSaveInstanceState());
570        savedInstanceState.putString(STATE_CURRENT_WARNING_TEXT, mCurrentWarningText);
571        return savedInstanceState;
572    }
573
574    /**
575     * Convenience method: Append the specified text slice to the TextView's
576     * display buffer, upgrading it to BufferType.EDITABLE if it was
577     * not already editable. Commas are excluded as they are added automatically
578     * by the view.
579     */
580    @Override
581    public void append(CharSequence text, int start, int end) {
582        // We don't care about watching text changes while appending.
583        if (mTextWatcher != null) {
584            removeTextChangedListener(mTextWatcher);
585        }
586        super.append(text, start, end);
587        if (!TextUtils.isEmpty(text) && TextUtils.getTrimmedLength(text) > 0) {
588            String displayString = text.toString();
589
590            if (!displayString.trim().endsWith(String.valueOf(COMMIT_CHAR_COMMA))) {
591                // We have no separator, so we should add it
592                super.append(SEPARATOR, 0, SEPARATOR.length());
593                displayString += SEPARATOR;
594            }
595
596            if (!TextUtils.isEmpty(displayString)
597                    && TextUtils.getTrimmedLength(displayString) > 0) {
598                mPendingChipsCount++;
599                mPendingChips.add(displayString);
600            }
601        }
602        // Put a message on the queue to make sure we ALWAYS handle pending
603        // chips.
604        if (mPendingChipsCount > 0) {
605            postHandlePendingChips();
606        }
607        mHandler.post(mAddTextWatcher);
608    }
609
610    @Override
611    public void onFocusChanged(boolean hasFocus, int direction, Rect previous) {
612        super.onFocusChanged(hasFocus, direction, previous);
613        if (!hasFocus) {
614            shrink();
615        } else {
616            expand();
617        }
618    }
619
620    @Override
621    public <T extends ListAdapter & Filterable> void setAdapter(@NonNull T adapter) {
622        super.setAdapter(adapter);
623        BaseRecipientAdapter baseAdapter = (BaseRecipientAdapter) adapter;
624        baseAdapter.registerUpdateObserver(new BaseRecipientAdapter.EntriesUpdatedObserver() {
625            @Override
626            public void onChanged(List<RecipientEntry> entries) {
627                int suggestionCount = entries == null ? 0 : entries.size();
628
629                // Scroll the chips field to the top of the screen so
630                // that the user can see as many results as possible.
631                if (entries != null && entries.size() > 0) {
632                    scrollBottomIntoView();
633                    // Here the current suggestion count is still the old one since we update
634                    // the count at the bottom of this function.
635                    if (mCurrentSuggestionCount == 0) {
636                        // Announce the new number of possible choices for accessibility.
637                        announceForAccessibilityCompat(
638                                getSuggestionDropdownOpenedVerbalization(suggestionCount));
639                    }
640                }
641
642                // Is the dropdown closing?
643                if ((entries == null || entries.size() == 0)
644                        // Here the current suggestion count is still the old one since we update
645                        // the count at the bottom of this function.
646                        && mCurrentSuggestionCount != 0
647                        // If there is no text, there's no need to know if no suggestions are
648                        // available.
649                        && getText().length() > 0) {
650                    announceForAccessibilityCompat(getResources().getString(
651                            R.string.accessbility_suggestion_dropdown_closed));
652                }
653
654                if ((entries != null)
655                        && (entries.size() == 1)
656                        && (entries.get(0).getEntryType() ==
657                                RecipientEntry.ENTRY_TYPE_PERMISSION_REQUEST)) {
658                    // Do nothing; showing a single permissions entry. Resizing not required.
659                } else {
660                    // Set the dropdown height to be the remaining height from the anchor to the
661                    // bottom.
662                    mDropdownAnchor.getLocationOnScreen(mCoords);
663                    getWindowVisibleDisplayFrame(mRect);
664                    setDropDownHeight(mRect.bottom - mCoords[1] - mDropdownAnchor.getHeight() -
665                            getDropDownVerticalOffset());
666                }
667
668                mCurrentSuggestionCount = suggestionCount;
669            }
670        });
671        baseAdapter.setDropdownChipLayouter(mDropdownChipLayouter);
672    }
673
674    /**
675     * Return the accessibility verbalization when the suggestion dropdown is opened.
676     */
677    public String getSuggestionDropdownOpenedVerbalization(int suggestionCount) {
678        return getResources().getString(R.string.accessbility_suggestion_dropdown_opened);
679    }
680
681    @TargetApi(Build.VERSION_CODES.JELLY_BEAN)
682    private void announceForAccessibilityCompat(String text) {
683        final AccessibilityManager accessibilityManager =
684                (AccessibilityManager) getContext().getSystemService(Context.ACCESSIBILITY_SERVICE);
685        final boolean isAccessibilityOn = accessibilityManager.isEnabled();
686
687        if (isAccessibilityOn && Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN) {
688            final ViewParent parent = getParent();
689            if (parent != null) {
690                AccessibilityEvent event = AccessibilityEvent.obtain(
691                        AccessibilityEvent.TYPE_ANNOUNCEMENT);
692                onInitializeAccessibilityEvent(event);
693                event.getText().add(text);
694                event.setContentDescription(null);
695                parent.requestSendAccessibilityEvent(this, event);
696            }
697        }
698    }
699
700    protected void scrollBottomIntoView() {
701        if (mScrollView != null && mShouldShrink) {
702            getLocationInWindow(mCoords);
703            // Desired position shows at least 1 line of chips below the action
704            // bar. We add excess padding to make sure this is always below other
705            // content.
706            final int height = getHeight();
707            final int currentPos = mCoords[1] + height;
708            mScrollView.getLocationInWindow(mCoords);
709            final int desiredPos = mCoords[1] + height / getLineCount();
710            if (currentPos > desiredPos) {
711                mScrollView.scrollBy(0, currentPos - desiredPos);
712            }
713        }
714    }
715
716    protected ScrollView getScrollView() {
717        return mScrollView;
718    }
719
720    @Override
721    public void performValidation() {
722        // Do nothing. Chips handles its own validation.
723    }
724
725    private void shrink() {
726        if (mTokenizer == null) {
727            return;
728        }
729        long contactId = mSelectedChip != null ? mSelectedChip.getEntry().getContactId() : -1;
730        if (mSelectedChip != null && contactId != RecipientEntry.INVALID_CONTACT
731                && (!isPhoneQuery() && contactId != RecipientEntry.GENERATED_CONTACT)) {
732            clearSelectedChip();
733        } else {
734            if (getWidth() <= 0) {
735                mHandler.removeCallbacks(mDelayedShrink);
736
737                if (getVisibility() == GONE) {
738                    // We aren't going to have a width any time soon, so defer
739                    // this until we're not GONE.
740                    mRequiresShrinkWhenNotGone = true;
741                } else {
742                    // We don't have the width yet which means the view hasn't been drawn yet
743                    // and there is no reason to attempt to commit chips yet.
744                    // This focus lost must be the result of an orientation change
745                    // or an initial rendering.
746                    // Re-post the shrink for later.
747                    mHandler.post(mDelayedShrink);
748                }
749                return;
750            }
751            // Reset any pending chips as they would have been handled
752            // when the field lost focus.
753            if (mPendingChipsCount > 0) {
754                postHandlePendingChips();
755            } else {
756                Editable editable = getText();
757                int end = getSelectionEnd();
758                int start = mTokenizer.findTokenStart(editable, end);
759                DrawableRecipientChip[] chips =
760                        getSpannable().getSpans(start, end, DrawableRecipientChip.class);
761                if ((chips == null || chips.length == 0)) {
762                    Editable text = getText();
763                    int whatEnd = mTokenizer.findTokenEnd(text, start);
764                    // This token was already tokenized, so skip past the ending token.
765                    if (whatEnd < text.length() && text.charAt(whatEnd) == ',') {
766                        whatEnd = movePastTerminators(whatEnd);
767                    }
768                    // In the middle of chip; treat this as an edit
769                    // and commit the whole token.
770                    int selEnd = getSelectionEnd();
771                    if (whatEnd != selEnd) {
772                        handleEdit(start, whatEnd);
773                    } else {
774                        commitChip(start, end, editable);
775                    }
776                }
777            }
778            mHandler.post(mAddTextWatcher);
779        }
780        createMoreChip();
781    }
782
783    private void expand() {
784        if (mShouldShrink) {
785            setMaxLines(Integer.MAX_VALUE);
786        }
787        removeMoreChip();
788        setCursorVisible(true);
789        Editable text = getText();
790        setSelection(text != null && text.length() > 0 ? text.length() : 0);
791        // If there are any temporary chips, try replacing them now that the user
792        // has expanded the field.
793        if (mTemporaryRecipients != null && mTemporaryRecipients.size() > 0) {
794            new RecipientReplacementTask().execute();
795            mTemporaryRecipients = null;
796        }
797    }
798
799    private CharSequence ellipsizeText(CharSequence text, TextPaint paint, float maxWidth) {
800        paint.setTextSize(mChipFontSize);
801        if (maxWidth <= 0 && Log.isLoggable(TAG, Log.DEBUG)) {
802            Log.d(TAG, "Max width is negative: " + maxWidth);
803        }
804        return TextUtils.ellipsize(text, paint, maxWidth,
805                TextUtils.TruncateAt.END);
806    }
807
808    /**
809     * Creates a bitmap of the given contact on a selected chip.
810     *
811     * @param contact The recipient entry to pull data from.
812     * @param paint The paint to use to draw the bitmap.
813     */
814    private ChipBitmapContainer createChipBitmap(RecipientEntry contact, TextPaint paint) {
815        paint.setColor(getDefaultChipTextColor(contact));
816        ChipBitmapContainer bitmapContainer = createChipBitmap(contact, paint,
817                getChipBackground(contact), getDefaultChipBackgroundColor(contact));
818
819        if (bitmapContainer.loadIcon) {
820            loadAvatarIcon(contact, bitmapContainer);
821        }
822        return bitmapContainer;
823    }
824
825    private ChipBitmapContainer createChipBitmap(RecipientEntry contact, TextPaint paint,
826            Drawable overrideBackgroundDrawable, int backgroundColor) {
827        final ChipBitmapContainer result = new ChipBitmapContainer();
828
829        Drawable indicatorIcon = null;
830        int indicatorPadding = 0;
831        if (contact.getIndicatorIconId() != 0) {
832            indicatorIcon = getContext().getDrawable(contact.getIndicatorIconId());
833            indicatorIcon.setBounds(0, 0,
834                    indicatorIcon.getIntrinsicWidth(), indicatorIcon.getIntrinsicHeight());
835            indicatorPadding = indicatorIcon.getBounds().width() + mChipTextEndPadding;
836        }
837
838        Rect backgroundPadding = new Rect();
839        if (overrideBackgroundDrawable != null) {
840            overrideBackgroundDrawable.getPadding(backgroundPadding);
841        }
842
843        // Ellipsize the text so that it takes AT MOST the entire width of the
844        // autocomplete text entry area. Make sure to leave space for padding
845        // on the sides.
846        int height = (int) mChipHeight;
847        // Since the icon is a square, it's width is equal to the maximum height it can be inside
848        // the chip. Don't include iconWidth for invalid contacts and when not displaying photos.
849        boolean displayIcon = contact.isValid() && contact.shouldDisplayIcon();
850        int iconWidth = displayIcon ?
851                height - backgroundPadding.top - backgroundPadding.bottom : 0;
852
853        final boolean shouldDisplayWarningIcon = mUntrustedAddresses.contains(
854                contact.getDestination());
855        final float warningIconWidth = shouldDisplayWarningIcon ? mWarningIconHeight : 0;
856        final float warningIconTopMargin = (mChipHeight - mWarningIconHeight) / 2f;
857        final float warningIconEndMargin = shouldDisplayWarningIcon ? mChipTextEndPadding : 0;
858
859        float[] widths = new float[1];
860        paint.getTextWidths(" ", widths);
861        CharSequence ellipsizedText = ellipsizeText(createChipDisplayText(contact), paint,
862                calculateAvailableWidth()
863                    - iconWidth
864                    - warningIconWidth
865                    - warningIconEndMargin
866                    - widths[0]
867                    - backgroundPadding.left
868                    - backgroundPadding.right
869                    - indicatorPadding);
870        int textWidth = (int) paint.measureText(ellipsizedText, 0, ellipsizedText.length());
871
872        // Chip start padding is the same as the end padding if there is no contact image.
873        final int startPadding = displayIcon ? mChipTextStartPadding : mChipTextEndPadding;
874        // Make sure there is a minimum chip width so the user can ALWAYS
875        // tap a chip without difficulty.
876        int width = Math.max(iconWidth * 2,
877                textWidth
878                    + startPadding
879                    + mChipTextEndPadding
880                    + iconWidth
881                    + (int) warningIconWidth
882                    + (int) warningIconEndMargin
883                    + backgroundPadding.left
884                    + backgroundPadding.right
885                    + indicatorPadding);
886
887        // Create the background of the chip.
888        result.bitmap = Bitmap.createBitmap(width, height, Bitmap.Config.ARGB_8888);
889        final Canvas canvas = new Canvas(result.bitmap);
890
891        // Check if the background drawable is set via attr
892        if (overrideBackgroundDrawable != null) {
893            overrideBackgroundDrawable.setBounds(0, 0, width, height);
894            overrideBackgroundDrawable.draw(canvas);
895        } else {
896            // Draw the default chip background
897            mWorkPaint.reset();
898            mWorkPaint.setColor(backgroundColor);
899            final float radius = height / 2;
900            canvas.drawRoundRect(new RectF(0, 0, width, height), radius, radius,
901                    mWorkPaint);
902        }
903
904        // Draw the text vertically aligned
905        int textX = shouldPositionAvatarOnRight() ?
906                mChipTextEndPadding
907                    + backgroundPadding.left
908                    + indicatorPadding
909                    + (int) warningIconWidth
910                    + (int) warningIconEndMargin :
911                width
912                    - backgroundPadding.right
913                    - mChipTextEndPadding
914                    - textWidth
915                    - indicatorPadding
916                    - (int) warningIconWidth
917                    - (int) warningIconEndMargin;
918        canvas.drawText(ellipsizedText, 0, ellipsizedText.length(),
919                textX, getTextYOffset(height), paint);
920
921        if (indicatorIcon != null) {
922            int indicatorX = shouldPositionAvatarOnRight()
923                ? backgroundPadding.left + mChipTextEndPadding
924                : width - backgroundPadding.right - indicatorIcon.getBounds().width()
925                        - mChipTextEndPadding;
926            int indicatorY = height / 2 - indicatorIcon.getBounds().height() / 2;
927            indicatorIcon.getBounds().offsetTo(indicatorX, indicatorY);
928            indicatorIcon.draw(canvas);
929        }
930
931        // Set the variables that are needed to draw the icon bitmap once it's loaded
932        final int iconX = shouldPositionAvatarOnRight() ?
933                width - backgroundPadding.right - iconWidth :
934                backgroundPadding.left;
935        result.left = iconX;
936        result.top = backgroundPadding.top;
937        result.right = iconX + iconWidth;
938        result.bottom = height - backgroundPadding.bottom;
939        result.loadIcon = displayIcon;
940
941        // Set the variables needed to draw the warning icon bitmap once it's loaded.
942        final float warningIconX = shouldPositionAvatarOnRight() ?
943                backgroundPadding.left + warningIconEndMargin :
944                width - backgroundPadding.right - warningIconWidth - warningIconEndMargin;
945        final float warningIconY = warningIconTopMargin;
946        result.warningIconLeft = warningIconX;
947        result.warningIconTop = warningIconY;
948        result.warningIconRight = warningIconX + warningIconWidth;
949        result.warningIconBottom = warningIconY + mWarningIconHeight;
950
951        return result;
952    }
953
954    /**
955     * Helper function that draws the loaded icon bitmap into the chips bitmap
956     */
957    private void drawIcon(ChipBitmapContainer bitMapResult, Bitmap icon) {
958        if (icon == null) {
959            return;
960        }
961        final Canvas canvas = new Canvas(bitMapResult.bitmap);
962        final RectF src = new RectF(0, 0, icon.getWidth(), icon.getHeight());
963        final RectF dst = new RectF(bitMapResult.left, bitMapResult.top, bitMapResult.right,
964                bitMapResult.bottom);
965        drawCircularIconOnCanvas(icon, canvas, src, dst);
966    }
967
968    /**
969     * Draws the warning icon onto the chip's bitmap and returns the rectangle it drew on.
970     */
971    private RectF drawWarningIcon(ChipBitmapContainer bitMapResult) {
972        if (mWarningIcon == null) {
973            return new RectF(0, 0, 0, 0);
974        }
975        final Canvas canvas = new Canvas(bitMapResult.bitmap);
976        final RectF src = new RectF(0, 0, mWarningIcon.getWidth(), mWarningIcon.getHeight());
977        final RectF dst = new RectF(bitMapResult.warningIconLeft, bitMapResult.warningIconTop,
978                bitMapResult.warningIconRight, bitMapResult.warningIconBottom);
979        drawRectanglularIconOnCanvas(mWarningIcon, canvas, src, dst);
980        return dst;
981    }
982
983    /**
984     * Returns true if the avatar should be positioned at the right edge of the chip.
985     * Takes into account both the set avatar position (start or end) as well as whether
986     * the layout direction is LTR or RTL.
987     */
988    private boolean shouldPositionAvatarOnRight() {
989        final boolean isRtl = Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN_MR1 &&
990                getLayoutDirection() == LAYOUT_DIRECTION_RTL;
991        final boolean assignedPosition = mAvatarPosition == AVATAR_POSITION_END;
992        // If in Rtl mode, the position should be flipped.
993        return isRtl ? !assignedPosition : assignedPosition;
994    }
995
996    /**
997     * Returns the avatar icon to use for this recipient entry. Returns null if we don't want to
998     * draw an icon for this recipient.
999     */
1000    private void loadAvatarIcon(final RecipientEntry contact,
1001            final ChipBitmapContainer bitmapContainer) {
1002        // Don't draw photos for recipients that have been typed in OR generated on the fly.
1003        long contactId = contact.getContactId();
1004        boolean drawPhotos = isPhoneQuery() ?
1005                contactId != RecipientEntry.INVALID_CONTACT
1006                : (contactId != RecipientEntry.INVALID_CONTACT
1007                        && contactId != RecipientEntry.GENERATED_CONTACT);
1008
1009        if (drawPhotos) {
1010            final byte[] origPhotoBytes = contact.getPhotoBytes();
1011            // There may not be a photo yet if anything but the first contact address
1012            // was selected.
1013            if (origPhotoBytes == null) {
1014                // TODO: cache this in the recipient entry?
1015                getAdapter().fetchPhoto(contact, new PhotoManager.PhotoManagerCallback() {
1016                    @Override
1017                    public void onPhotoBytesPopulated() {
1018                        // Call through to the async version which will ensure
1019                        // proper threading.
1020                        onPhotoBytesAsynchronouslyPopulated();
1021                    }
1022
1023                    @Override
1024                    public void onPhotoBytesAsynchronouslyPopulated() {
1025                        final byte[] loadedPhotoBytes = contact.getPhotoBytes();
1026                        final Bitmap icon = BitmapFactory.decodeByteArray(loadedPhotoBytes, 0,
1027                                loadedPhotoBytes.length);
1028                        tryDrawAndInvalidate(icon);
1029                    }
1030
1031                    @Override
1032                    public void onPhotoBytesAsyncLoadFailed() {
1033                        // TODO: can the scaled down default photo be cached?
1034                        tryDrawAndInvalidate(mDefaultContactPhoto);
1035                    }
1036
1037                    private void tryDrawAndInvalidate(Bitmap icon) {
1038                        drawIcon(bitmapContainer, icon);
1039                        // The caller might originated from a background task. However, if the
1040                        // background task has already completed, the view might be already drawn
1041                        // on the UI but the callback would happen on the background thread.
1042                        // So if we are on a background thread, post an invalidate call to the UI.
1043                        if (Looper.myLooper() == Looper.getMainLooper()) {
1044                            // The view might not redraw itself since it's loaded asynchronously
1045                            invalidate();
1046                        } else {
1047                            post(new Runnable() {
1048                                @Override
1049                                public void run() {
1050                                    invalidate();
1051                                }
1052                            });
1053                        }
1054                    }
1055                });
1056            } else {
1057                final Bitmap icon = BitmapFactory.decodeByteArray(origPhotoBytes, 0,
1058                        origPhotoBytes.length);
1059                drawIcon(bitmapContainer, icon);
1060            }
1061        }
1062    }
1063
1064    /**
1065     * Get the background drawable for a RecipientChip.
1066     */
1067    // Visible for testing.
1068    /* package */Drawable getChipBackground(RecipientEntry contact) {
1069        return contact.isValid() ? mChipBackground : mInvalidChipBackground;
1070    }
1071
1072    private int getDefaultChipTextColor(RecipientEntry contact) {
1073        return contact.isValid() ? mUnselectedChipTextColor :
1074                getResources().getColor(android.R.color.black);
1075    }
1076
1077    private int getDefaultChipBackgroundColor(RecipientEntry contact) {
1078        return contact.isValid() ? mUnselectedChipBackgroundColor :
1079                getResources().getColor(R.color.chip_background_invalid);
1080    }
1081
1082    /**
1083     * Given a height, returns a Y offset that will draw the text in the middle of the height.
1084     */
1085    protected float getTextYOffset(int height) {
1086        return height - ((height - mTextHeight) / 2);
1087    }
1088
1089    /**
1090     * Draws the icon onto the canvas given the source rectangle of the bitmap and the destination
1091     * rectangle of the canvas.
1092     *
1093     * <p>The icon is drawn as a circle.
1094     */
1095    protected void drawCircularIconOnCanvas(Bitmap icon, Canvas canvas, RectF src, RectF dst) {
1096        setWorkPaintForIcon(icon, src, dst);
1097        canvas.drawCircle(dst.centerX(), dst.centerY(), dst.width() / 2f, mWorkPaint);
1098
1099        final float borderWidth = 1f;
1100        setWorkPaintForBorder(borderWidth);
1101        canvas.drawCircle(dst.centerX(), dst.centerY(), dst.width() / 2f - borderWidth / 2,
1102                mWorkPaint);
1103
1104        mWorkPaint.reset();
1105    }
1106
1107    /**
1108     * Draws the icon onto the canvas given the source rectangle of the bitmap and the destination
1109     * rectangle of the canvas.
1110     *
1111     * <p>The icon is drawn as a rectangle.
1112     */
1113    private void drawRectanglularIconOnCanvas(Bitmap icon, Canvas canvas, RectF src, RectF dst) {
1114        setWorkPaintForIcon(icon, src, dst);
1115        canvas.drawRect(dst, mWorkPaint);
1116
1117        final float borderWidth = 1f;
1118        setWorkPaintForBorder(borderWidth);
1119        canvas.drawRect(dst, mWorkPaint);
1120
1121        mWorkPaint.reset();
1122    }
1123
1124    /**
1125     * Sets WorkPaint for drawing the icon from src onto dst.
1126     */
1127    private void setWorkPaintForIcon(Bitmap icon, RectF src, RectF dst) {
1128        final Matrix matrix = new Matrix();
1129
1130        // Draw bitmap through shader first.
1131        final BitmapShader shader = new BitmapShader(icon, TileMode.CLAMP, TileMode.CLAMP);
1132        matrix.reset();
1133
1134        // Fit bitmap to bounds.
1135        matrix.setRectToRect(src, dst, Matrix.ScaleToFit.FILL);
1136
1137        shader.setLocalMatrix(matrix);
1138        mWorkPaint.reset();
1139        mWorkPaint.setShader(shader);
1140        mWorkPaint.setAntiAlias(true);
1141        mWorkPaint.setFilterBitmap(true);
1142        mWorkPaint.setDither(true);
1143    }
1144
1145    /**
1146     * Sets WorkPaint for drawing the icon border with the given width.
1147     */
1148    private void setWorkPaintForBorder(float borderWidth) {
1149        mWorkPaint.reset();
1150        mWorkPaint.setColor(Color.TRANSPARENT);
1151        mWorkPaint.setStyle(Style.STROKE);
1152        mWorkPaint.setStrokeWidth(borderWidth);
1153        mWorkPaint.setAntiAlias(true);
1154    }
1155
1156    private DrawableRecipientChip constructChipSpan(RecipientEntry contact) {
1157        TextPaint paint = getPaint();
1158        float defaultSize = paint.getTextSize();
1159        int defaultColor = paint.getColor();
1160
1161        ChipBitmapContainer bitmapContainer = createChipBitmap(contact, paint);
1162        final Rect warningIconBounds = new Rect(0, 0, 0, 0);
1163        if (mUntrustedAddresses.contains(contact.getDestination())) {
1164            drawWarningIcon(bitmapContainer).round(warningIconBounds);
1165        }
1166        final Bitmap tmpBitmap = bitmapContainer.bitmap;
1167
1168        // Pass the full text, un-ellipsized, to the chip.
1169        final int iconWidth = tmpBitmap != null ? tmpBitmap.getWidth() : 0;
1170        final int iconHeight = tmpBitmap != null ? tmpBitmap.getHeight() : 0;
1171        Drawable result = new BitmapDrawable(getResources(), tmpBitmap);
1172        result.setBounds(0, 0, iconWidth, iconHeight);
1173        VisibleRecipientChip recipientChip =
1174                new VisibleRecipientChip(result, contact);
1175        recipientChip.setExtraMargin(mLineSpacingExtra);
1176        // Return text to the original size.
1177        paint.setTextSize(defaultSize);
1178        paint.setColor(defaultColor);
1179        // Put warning icon dimensions info in the chip
1180        recipientChip.setWarningIconBounds(warningIconBounds);
1181        return recipientChip;
1182    }
1183
1184    /**
1185     * Calculate the offset from bottom of the EditText to top of the provided line.
1186     */
1187    private int calculateOffsetFromBottomToTop(int line) {
1188        return -(int) ((mChipHeight + (2 * mLineSpacingExtra)) * (Math
1189                .abs(getLineCount() - line)) + getPaddingBottom());
1190    }
1191
1192    /**
1193     * Get the max amount of space a chip can take up. The formula takes into
1194     * account the width of the EditTextView, any view padding, and padding
1195     * that will be added to the chip.
1196     */
1197    private float calculateAvailableWidth() {
1198        return getWidth() - getPaddingLeft() - getPaddingRight() - mChipTextStartPadding
1199                - mChipTextEndPadding;
1200    }
1201
1202
1203    private void setChipDimensions(Context context, AttributeSet attrs) {
1204        TypedArray a = context.obtainStyledAttributes(attrs, R.styleable.RecipientEditTextView, 0,
1205                0);
1206        Resources r = getContext().getResources();
1207
1208        mChipBackground = a.getDrawable(R.styleable.RecipientEditTextView_chipBackground);
1209        mInvalidChipBackground = a
1210                .getDrawable(R.styleable.RecipientEditTextView_invalidChipBackground);
1211        mChipDelete = a.getDrawable(R.styleable.RecipientEditTextView_chipDelete);
1212        if (mChipDelete == null) {
1213            mChipDelete = r.getDrawable(R.drawable.ic_cancel_wht_24dp);
1214        }
1215        mChipTextStartPadding = mChipTextEndPadding
1216                = a.getDimensionPixelSize(R.styleable.RecipientEditTextView_chipPadding, -1);
1217        if (mChipTextStartPadding == -1) {
1218            mChipTextStartPadding = mChipTextEndPadding =
1219                    (int) r.getDimension(R.dimen.chip_padding);
1220        }
1221        // xml-overrides for each individual padding
1222        // TODO: add these to attr?
1223        int overridePadding = (int) r.getDimension(R.dimen.chip_padding_start);
1224        if (overridePadding >= 0) {
1225            mChipTextStartPadding = overridePadding;
1226        }
1227        overridePadding = (int) r.getDimension(R.dimen.chip_padding_end);
1228        if (overridePadding >= 0) {
1229            mChipTextEndPadding = overridePadding;
1230        }
1231
1232        mDefaultContactPhoto = BitmapFactory.decodeResource(r, R.drawable.ic_contact_picture);
1233
1234        mMoreItem = (TextView) LayoutInflater.from(getContext()).inflate(R.layout.more_item, null);
1235
1236        mChipHeight = a.getDimensionPixelSize(R.styleable.RecipientEditTextView_chipHeight, -1);
1237        if (mChipHeight == -1) {
1238            mChipHeight = r.getDimension(R.dimen.chip_height);
1239        }
1240        mChipFontSize = a.getDimensionPixelSize(R.styleable.RecipientEditTextView_chipFontSize, -1);
1241        if (mChipFontSize == -1) {
1242            mChipFontSize = r.getDimension(R.dimen.chip_text_size);
1243        }
1244        mAvatarPosition =
1245                a.getInt(R.styleable.RecipientEditTextView_avatarPosition, AVATAR_POSITION_START);
1246        mDisableDelete = a.getBoolean(R.styleable.RecipientEditTextView_disableDelete, false);
1247
1248        mMaxLines = r.getInteger(R.integer.chips_max_lines);
1249        mLineSpacingExtra = r.getDimensionPixelOffset(R.dimen.line_spacing_extra);
1250
1251        mUnselectedChipTextColor = a.getColor(
1252                R.styleable.RecipientEditTextView_unselectedChipTextColor,
1253                r.getColor(android.R.color.black));
1254
1255        mUnselectedChipBackgroundColor = a.getColor(
1256                R.styleable.RecipientEditTextView_unselectedChipBackgroundColor,
1257                r.getColor(R.color.chip_background));
1258
1259        a.recycle();
1260    }
1261
1262    // Visible for testing.
1263    /* package */ void setMoreItem(TextView moreItem) {
1264        mMoreItem = moreItem;
1265    }
1266
1267
1268    // Visible for testing.
1269    /* package */ void setChipBackground(Drawable chipBackground) {
1270        mChipBackground = chipBackground;
1271    }
1272
1273    // Visible for testing.
1274    /* package */ void setChipHeight(int height) {
1275        mChipHeight = height;
1276    }
1277
1278    public float getChipHeight() {
1279        return mChipHeight;
1280    }
1281
1282    /** Returns whether view is in no-chip or chip mode. */
1283    public boolean isNoChipMode() {
1284        return mNoChipMode;
1285    }
1286
1287    /**
1288     * Set whether to shrink the recipients field such that at most
1289     * one line of recipients chips are shown when the field loses
1290     * focus. By default, the number of displayed recipients will be
1291     * limited and a "more" chip will be shown when focus is lost.
1292     * @param shrink
1293     */
1294    public void setOnFocusListShrinkRecipients(boolean shrink) {
1295        mShouldShrink = shrink;
1296    }
1297
1298    @Override
1299    public void onSizeChanged(int width, int height, int oldw, int oldh) {
1300        super.onSizeChanged(width, height, oldw, oldh);
1301        if (width != 0 && height != 0) {
1302            if (mPendingChipsCount > 0) {
1303                postHandlePendingChips();
1304            } else {
1305                checkChipWidths();
1306            }
1307        }
1308        // Try to find the scroll view parent, if it exists.
1309        if (mScrollView == null && !mTriedGettingScrollView) {
1310            ViewParent parent = getParent();
1311            while (parent != null && !(parent instanceof ScrollView)) {
1312                parent = parent.getParent();
1313            }
1314            if (parent != null) {
1315                mScrollView = (ScrollView) parent;
1316            }
1317            mTriedGettingScrollView = true;
1318        }
1319    }
1320
1321    private void postHandlePendingChips() {
1322        mHandler.removeCallbacks(mHandlePendingChips);
1323        mHandler.post(mHandlePendingChips);
1324    }
1325
1326    private void checkChipWidths() {
1327        // Check the widths of the associated chips.
1328        DrawableRecipientChip[] chips = getSortedRecipients();
1329        if (chips != null) {
1330            Rect bounds;
1331            for (DrawableRecipientChip chip : chips) {
1332                bounds = chip.getBounds();
1333                if (getWidth() > 0 && bounds.right - bounds.left >
1334                        getWidth() - getPaddingLeft() - getPaddingRight()) {
1335                    // Need to redraw that chip.
1336                    replaceChip(chip, chip.getEntry());
1337                }
1338            }
1339        }
1340    }
1341
1342    // Visible for testing.
1343    /*package*/ void handlePendingChips() {
1344        if (getViewWidth() <= 0) {
1345            // The widget has not been sized yet.
1346            // This will be called as a result of onSizeChanged
1347            // at a later point.
1348            return;
1349        }
1350        if (mPendingChipsCount <= 0) {
1351            return;
1352        }
1353
1354        synchronized (mPendingChips) {
1355            Editable editable = getText();
1356            // Tokenize!
1357            if (mPendingChipsCount <= MAX_CHIPS_PARSED) {
1358                for (int i = 0; i < mPendingChips.size(); i++) {
1359                    String current = mPendingChips.get(i);
1360                    int tokenStart = editable.toString().indexOf(current);
1361                    // Always leave a space at the end between tokens.
1362                    int tokenEnd = tokenStart + current.length() - 1;
1363                    if (tokenStart >= 0) {
1364                        // When we have a valid token, include it with the token
1365                        // to the left.
1366                        if (tokenEnd < editable.length() - 2
1367                                && editable.charAt(tokenEnd) == COMMIT_CHAR_COMMA) {
1368                            tokenEnd++;
1369                        }
1370                        createReplacementChip(tokenStart, tokenEnd, editable, i < CHIP_LIMIT
1371                                || !mShouldShrink);
1372                    }
1373                    mPendingChipsCount--;
1374                }
1375                sanitizeEnd();
1376            } else {
1377                mNoChipMode = true;
1378            }
1379
1380            if (mTemporaryRecipients != null && mTemporaryRecipients.size() > 0
1381                    && mTemporaryRecipients.size() <= RecipientAlternatesAdapter.MAX_LOOKUPS) {
1382                if (hasFocus() || mTemporaryRecipients.size() < CHIP_LIMIT) {
1383                    new RecipientReplacementTask().execute();
1384                    mTemporaryRecipients = null;
1385                } else {
1386                    // Create the "more" chip
1387                    mIndividualReplacements = new IndividualReplacementTask();
1388                    mIndividualReplacements.execute(new ArrayList<DrawableRecipientChip>(
1389                            mTemporaryRecipients.subList(0, CHIP_LIMIT)));
1390                    if (mTemporaryRecipients.size() > CHIP_LIMIT) {
1391                        mTemporaryRecipients = new ArrayList<DrawableRecipientChip>(
1392                                mTemporaryRecipients.subList(CHIP_LIMIT,
1393                                        mTemporaryRecipients.size()));
1394                    } else {
1395                        mTemporaryRecipients = null;
1396                    }
1397                    createMoreChip();
1398                }
1399            } else {
1400                // There are too many recipients to look up, so just fall back
1401                // to showing addresses for all of them.
1402                mTemporaryRecipients = null;
1403                createMoreChip();
1404            }
1405            mPendingChipsCount = 0;
1406            mPendingChips.clear();
1407        }
1408    }
1409
1410    // Visible for testing.
1411    /*package*/ int getViewWidth() {
1412        return getWidth();
1413    }
1414
1415    /**
1416     * Remove any characters after the last valid chip.
1417     */
1418    // Visible for testing.
1419    /*package*/ void sanitizeEnd() {
1420        // Don't sanitize while we are waiting for pending chips to complete.
1421        if (mPendingChipsCount > 0) {
1422            return;
1423        }
1424        // Find the last chip; eliminate any commit characters after it.
1425        DrawableRecipientChip[] chips = getSortedRecipients();
1426        Spannable spannable = getSpannable();
1427        if (chips != null && chips.length > 0) {
1428            int end;
1429            mMoreChip = getMoreChip();
1430            if (mMoreChip != null) {
1431                end = spannable.getSpanEnd(mMoreChip);
1432            } else {
1433                end = getSpannable().getSpanEnd(getLastChip());
1434            }
1435            Editable editable = getText();
1436            int length = editable.length();
1437            if (length > end) {
1438                // See what characters occur after that and eliminate them.
1439                if (Log.isLoggable(TAG, Log.DEBUG)) {
1440                    Log.d(TAG, "There were extra characters after the last tokenizable entry."
1441                            + editable);
1442                }
1443                editable.delete(end + 1, length);
1444            }
1445        }
1446    }
1447
1448    /**
1449     * Create a chip that represents just the email address of a recipient. At some later
1450     * point, this chip will be attached to a real contact entry, if one exists.
1451     */
1452    // VisibleForTesting
1453    void createReplacementChip(int tokenStart, int tokenEnd, Editable editable,
1454            boolean visible) {
1455        if (alreadyHasChip(tokenStart, tokenEnd)) {
1456            // There is already a chip present at this location.
1457            // Don't recreate it.
1458            return;
1459        }
1460        String token = editable.toString().substring(tokenStart, tokenEnd);
1461        final String trimmedToken = token.trim();
1462        int commitCharIndex = trimmedToken.lastIndexOf(COMMIT_CHAR_COMMA);
1463        if (commitCharIndex != -1 && commitCharIndex == trimmedToken.length() - 1) {
1464            token = trimmedToken.substring(0, trimmedToken.length() - 1);
1465        }
1466        RecipientEntry entry = createTokenizedEntry(token);
1467        if (entry != null) {
1468            DrawableRecipientChip chip = null;
1469            try {
1470                if (!mNoChipMode) {
1471                    chip = visible ? constructChipSpan(entry) : new InvisibleRecipientChip(entry);
1472                }
1473            } catch (NullPointerException e) {
1474                Log.e(TAG, e.getMessage(), e);
1475            }
1476            editable.setSpan(chip, tokenStart, tokenEnd, Spannable.SPAN_EXCLUSIVE_EXCLUSIVE);
1477            // Add this chip to the list of entries "to replace"
1478            if (chip != null) {
1479                if (mTemporaryRecipients == null) {
1480                    mTemporaryRecipients = new ArrayList<DrawableRecipientChip>();
1481                }
1482                chip.setOriginalText(token);
1483                mTemporaryRecipients.add(chip);
1484            }
1485        }
1486    }
1487
1488    // VisibleForTesting
1489    RecipientEntry createTokenizedEntry(final String token) {
1490        if (TextUtils.isEmpty(token)) {
1491            return null;
1492        }
1493        if (isPhoneQuery() && PhoneUtil.isPhoneNumber(token)) {
1494            return RecipientEntry.constructFakePhoneEntry(token, true);
1495        }
1496        Rfc822Token[] tokens = Rfc822Tokenizer.tokenize(token);
1497        boolean isValid = isValid(token);
1498        if (isValid && tokens != null && tokens.length > 0) {
1499            // If we can get a name from tokenizing, then generate an entry from
1500            // this.
1501            String display = tokens[0].getName();
1502            if (!TextUtils.isEmpty(display)) {
1503                return RecipientEntry.constructGeneratedEntry(display, tokens[0].getAddress(),
1504                        isValid);
1505            } else {
1506                display = tokens[0].getAddress();
1507                if (!TextUtils.isEmpty(display)) {
1508                    return RecipientEntry.constructFakeEntry(display, isValid);
1509                }
1510            }
1511        }
1512        // Unable to validate the token or to create a valid token from it.
1513        // Just create a chip the user can edit.
1514        String validatedToken = null;
1515        if (mValidator != null && !isValid) {
1516            // Try fixing up the entry using the validator.
1517            validatedToken = mValidator.fixText(token).toString();
1518            if (!TextUtils.isEmpty(validatedToken)) {
1519                if (validatedToken.contains(token)) {
1520                    // protect against the case of a validator with a null
1521                    // domain,
1522                    // which doesn't add a domain to the token
1523                    Rfc822Token[] tokenized = Rfc822Tokenizer.tokenize(validatedToken);
1524                    if (tokenized.length > 0) {
1525                        validatedToken = tokenized[0].getAddress();
1526                        isValid = true;
1527                    }
1528                } else {
1529                    // We ran into a case where the token was invalid and
1530                    // removed
1531                    // by the validator. In this case, just use the original
1532                    // token
1533                    // and let the user sort out the error chip.
1534                    validatedToken = null;
1535                    isValid = false;
1536                }
1537            }
1538        }
1539        // Otherwise, fallback to just creating an editable email address chip.
1540        return RecipientEntry.constructFakeEntry(
1541                !TextUtils.isEmpty(validatedToken) ? validatedToken : token, isValid);
1542    }
1543
1544    private boolean isValid(String text) {
1545        return mValidator == null ? true : mValidator.isValid(text);
1546    }
1547
1548    private static String tokenizeAddress(String destination) {
1549        Rfc822Token[] tokens = Rfc822Tokenizer.tokenize(destination);
1550        if (tokens != null && tokens.length > 0) {
1551            return tokens[0].getAddress();
1552        }
1553        return destination;
1554    }
1555
1556    @Override
1557    public void setTokenizer(Tokenizer tokenizer) {
1558        mTokenizer = tokenizer;
1559        super.setTokenizer(mTokenizer);
1560    }
1561
1562    @Override
1563    public void setValidator(Validator validator) {
1564        mValidator = validator;
1565        super.setValidator(validator);
1566    }
1567
1568    /**
1569     * We cannot use the default mechanism for replaceText. Instead,
1570     * we override onItemClickListener so we can get all the associated
1571     * contact information including display text, address, and id.
1572     */
1573    @Override
1574    protected void replaceText(CharSequence text) {
1575        return;
1576    }
1577
1578    /**
1579     * Dismiss any selected chips when the back key is pressed.
1580     */
1581    @Override
1582    public boolean onKeyPreIme(int keyCode, @NonNull KeyEvent event) {
1583        if (keyCode == KeyEvent.KEYCODE_BACK && mSelectedChip != null) {
1584            clearSelectedChip();
1585            return true;
1586        }
1587        return super.onKeyPreIme(keyCode, event);
1588    }
1589
1590    /**
1591     * Monitor key presses in this view to see if the user types
1592     * any commit keys, which consist of ENTER, TAB, or DPAD_CENTER.
1593     * If the user has entered text that has contact matches and types
1594     * a commit key, create a chip from the topmost matching contact.
1595     * If the user has entered text that has no contact matches and types
1596     * a commit key, then create a chip from the text they have entered.
1597     */
1598    @Override
1599    public boolean onKeyUp(int keyCode, @NonNull KeyEvent event) {
1600        switch (keyCode) {
1601            case KeyEvent.KEYCODE_TAB:
1602                if (event.hasNoModifiers()) {
1603                    if (mSelectedChip != null) {
1604                        clearSelectedChip();
1605                    } else {
1606                        commitDefault();
1607                    }
1608                }
1609                break;
1610        }
1611        return super.onKeyUp(keyCode, event);
1612    }
1613
1614    private boolean focusNext() {
1615        View next = focusSearch(View.FOCUS_DOWN);
1616        if (next != null) {
1617            next.requestFocus();
1618            return true;
1619        }
1620        return false;
1621    }
1622
1623    /**
1624     * Create a chip from the default selection. If the popup is showing, the
1625     * default is the selected item (if one is selected), or the first item, in the popup
1626     * suggestions list. Otherwise, it is whatever the user had typed in. End represents where the
1627     * tokenizer should search for a token to turn into a chip.
1628     * @return If a chip was created from a real contact.
1629     */
1630    private boolean commitDefault() {
1631        // If there is no tokenizer, don't try to commit.
1632        if (mTokenizer == null) {
1633            return false;
1634        }
1635        Editable editable = getText();
1636        int end = getSelectionEnd();
1637        int start = mTokenizer.findTokenStart(editable, end);
1638
1639        if (shouldCreateChip(start, end)) {
1640            int whatEnd = mTokenizer.findTokenEnd(getText(), start);
1641            // In the middle of chip; treat this as an edit
1642            // and commit the whole token.
1643            whatEnd = movePastTerminators(whatEnd);
1644            if (whatEnd != getSelectionEnd()) {
1645                handleEdit(start, whatEnd);
1646                return true;
1647            }
1648            return commitChip(start, end , editable);
1649        }
1650        return false;
1651    }
1652
1653    private void commitByCharacter() {
1654        // We can't possibly commit by character if we can't tokenize.
1655        if (mTokenizer == null) {
1656            return;
1657        }
1658        Editable editable = getText();
1659        int end = getSelectionEnd();
1660        int start = mTokenizer.findTokenStart(editable, end);
1661        if (shouldCreateChip(start, end)) {
1662            commitChip(start, end, editable);
1663        }
1664        setSelection(getText().length());
1665    }
1666
1667    private boolean commitChip(int start, int end, Editable editable) {
1668        int position = positionOfFirstEntryWithTypePerson();
1669        if (position != -1 && enoughToFilter()
1670                && end == getSelectionEnd() && !isPhoneQuery()
1671                && !isValidEmailAddress(editable.toString().substring(start, end).trim())) {
1672            // let's choose the selected or first entry if only the input text is NOT an email
1673            // address so we won't try to replace the user's potentially correct but
1674            // new/unencountered email input
1675            final int selectedPosition = getListSelection();
1676            if (selectedPosition == -1 || !isEntryAtPositionTypePerson(selectedPosition)) {
1677                // Nothing is selected or selected item is not type person; use the first item
1678                submitItemAtPosition(position);
1679            } else {
1680                submitItemAtPosition(selectedPosition);
1681            }
1682            dismissDropDown();
1683            return true;
1684        } else {
1685            int tokenEnd = mTokenizer.findTokenEnd(editable, start);
1686            if (editable.length() > tokenEnd + 1) {
1687                char charAt = editable.charAt(tokenEnd + 1);
1688                if (charAt == COMMIT_CHAR_COMMA || charAt == COMMIT_CHAR_SEMICOLON) {
1689                    tokenEnd++;
1690                }
1691            }
1692            String text = editable.toString().substring(start, tokenEnd).trim();
1693            clearComposingText();
1694            if (text.length() > 0 && !text.equals(" ")) {
1695                RecipientEntry entry = createTokenizedEntry(text);
1696                if (entry != null) {
1697                    QwertyKeyListener.markAsReplaced(editable, start, end, "");
1698                    CharSequence chipText = createChip(entry);
1699                    if (chipText != null && start > -1 && end > -1) {
1700                        editable.replace(start, end, chipText);
1701                    }
1702                }
1703                // Only dismiss the dropdown if it is related to the text we
1704                // just committed.
1705                // For paste, it may not be as there are possibly multiple
1706                // tokens being added.
1707                if (end == getSelectionEnd()) {
1708                    dismissDropDown();
1709                }
1710                sanitizeBetween();
1711                return true;
1712            }
1713        }
1714        return false;
1715    }
1716
1717    private int positionOfFirstEntryWithTypePerson() {
1718        ListAdapter adapter = getAdapter();
1719        int itemCount = adapter != null ? adapter.getCount() : 0;
1720        for (int i = 0; i < itemCount; i++) {
1721            if (isEntryAtPositionTypePerson(i)) {
1722                return i;
1723            }
1724        }
1725        return -1;
1726    }
1727
1728    private boolean isEntryAtPositionTypePerson(int position) {
1729        return getAdapter().getItem(position).getEntryType() == RecipientEntry.ENTRY_TYPE_PERSON;
1730    }
1731
1732    // Visible for testing.
1733    /* package */ void sanitizeBetween() {
1734        // Don't sanitize while we are waiting for content to chipify.
1735        if (mPendingChipsCount > 0) {
1736            return;
1737        }
1738        // Find the last chip.
1739        DrawableRecipientChip[] recips = getSortedRecipients();
1740        if (recips != null && recips.length > 0) {
1741            DrawableRecipientChip last = recips[recips.length - 1];
1742            DrawableRecipientChip beforeLast = null;
1743            if (recips.length > 1) {
1744                beforeLast = recips[recips.length - 2];
1745            }
1746            int startLooking = 0;
1747            int end = getSpannable().getSpanStart(last);
1748            if (beforeLast != null) {
1749                startLooking = getSpannable().getSpanEnd(beforeLast);
1750                Editable text = getText();
1751                if (startLooking == -1 || startLooking > text.length() - 1) {
1752                    // There is nothing after this chip.
1753                    return;
1754                }
1755                if (text.charAt(startLooking) == ' ') {
1756                    startLooking++;
1757                }
1758            }
1759            if (startLooking >= 0 && end >= 0 && startLooking < end) {
1760                getText().delete(startLooking, end);
1761            }
1762        }
1763    }
1764
1765    private boolean shouldCreateChip(int start, int end) {
1766        return !mNoChipMode && hasFocus() && enoughToFilter() && !alreadyHasChip(start, end);
1767    }
1768
1769    private boolean alreadyHasChip(int start, int end) {
1770        if (mNoChipMode) {
1771            return true;
1772        }
1773        DrawableRecipientChip[] chips =
1774                getSpannable().getSpans(start, end, DrawableRecipientChip.class);
1775        return chips != null && chips.length > 0;
1776    }
1777
1778    private void handleEdit(int start, int end) {
1779        if (start == -1 || end == -1) {
1780            // This chip no longer exists in the field.
1781            dismissDropDown();
1782            return;
1783        }
1784        // This is in the middle of a chip, so select out the whole chip
1785        // and commit it.
1786        Editable editable = getText();
1787        setSelection(end);
1788        String text = getText().toString().substring(start, end);
1789        if (!TextUtils.isEmpty(text)) {
1790            RecipientEntry entry = RecipientEntry.constructFakeEntry(text, isValid(text));
1791            QwertyKeyListener.markAsReplaced(editable, start, end, "");
1792            CharSequence chipText = createChip(entry);
1793            int selEnd = getSelectionEnd();
1794            if (chipText != null && start > -1 && selEnd > -1) {
1795                editable.replace(start, selEnd, chipText);
1796            }
1797        }
1798        dismissDropDown();
1799    }
1800
1801    /**
1802     * If there is a selected chip, delegate the key events
1803     * to the selected chip.
1804     */
1805    @Override
1806    public boolean onKeyDown(int keyCode, @NonNull KeyEvent event) {
1807        if (mSelectedChip != null && keyCode == KeyEvent.KEYCODE_DEL) {
1808            if (mAlternatesPopup != null && mAlternatesPopup.isShowing()) {
1809                mAlternatesPopup.dismiss();
1810            }
1811            removeChip(mSelectedChip);
1812        }
1813
1814        switch (keyCode) {
1815            case KeyEvent.KEYCODE_ENTER:
1816            case KeyEvent.KEYCODE_DPAD_CENTER:
1817                if (event.hasNoModifiers()) {
1818                    if (commitDefault()) {
1819                        return true;
1820                    }
1821                    if (mSelectedChip != null) {
1822                        clearSelectedChip();
1823                        return true;
1824                    } else if (focusNext()) {
1825                        return true;
1826                    }
1827                }
1828                break;
1829        }
1830
1831        final DrawableRecipientChip lastRecipientChip = getLastChip();
1832        boolean isHandled = super.onKeyDown(keyCode, event);
1833
1834        /*
1835         * Hacky way to report a deleted chip:
1836         * In some devices/configurations, {@link KeyEvent#KEYCODE_DEL} character is causing
1837         * onKeyDown() to be called, which in turns handles the chip deletion instead of
1838         * {@link RecipientTextWatcher#onTextChanged}. We want to call
1839         * {@link RecipientChipDeletedListener#onRecipientChipDeleted} callback for these cases.
1840         */
1841        if (keyCode == KeyEvent.KEYCODE_DEL && isHandled && lastRecipientChip != null) {
1842            final RecipientEntry entry = lastRecipientChip.getEntry();
1843            if (!mNoChipMode && mRecipientChipDeletedListener != null && entry != null) {
1844                mRecipientChipDeletedListener.onRecipientChipDeleted(entry);
1845            }
1846        }
1847
1848        return isHandled;
1849    }
1850
1851    // Visible for testing.
1852    /* package */ Spannable getSpannable() {
1853        return getText();
1854    }
1855
1856    private int getChipStart(DrawableRecipientChip chip) {
1857        return getSpannable().getSpanStart(chip);
1858    }
1859
1860    private int getChipEnd(DrawableRecipientChip chip) {
1861        return getSpannable().getSpanEnd(chip);
1862    }
1863
1864    /**
1865     * Instead of filtering on the entire contents of the edit box,
1866     * this subclass method filters on the range from
1867     * {@link Tokenizer#findTokenStart} to {@link #getSelectionEnd}
1868     * if the length of that range meets or exceeds {@link #getThreshold}
1869     * and makes sure that the range is not already a Chip.
1870     */
1871    @Override
1872    public void performFiltering(@NonNull CharSequence text, int keyCode) {
1873        boolean isCompletedToken = isCompletedToken(text);
1874        if (enoughToFilter() && !isCompletedToken) {
1875            int end = getSelectionEnd();
1876            int start = mTokenizer.findTokenStart(text, end);
1877            // If this is a RecipientChip, don't filter
1878            // on its contents.
1879            Spannable span = getSpannable();
1880            DrawableRecipientChip[] chips = span.getSpans(start, end, DrawableRecipientChip.class);
1881            if (chips != null && chips.length > 0) {
1882                dismissDropDown();
1883                return;
1884            }
1885        } else if (isCompletedToken) {
1886            dismissDropDown();
1887            return;
1888        }
1889        super.performFiltering(text, keyCode);
1890    }
1891
1892    // Visible for testing.
1893    /*package*/ boolean isCompletedToken(CharSequence text) {
1894        if (TextUtils.isEmpty(text)) {
1895            return false;
1896        }
1897        // Check to see if this is a completed token before filtering.
1898        int end = text.length();
1899        int start = mTokenizer.findTokenStart(text, end);
1900        String token = text.toString().substring(start, end).trim();
1901        if (!TextUtils.isEmpty(token)) {
1902            char atEnd = token.charAt(token.length() - 1);
1903            return atEnd == COMMIT_CHAR_COMMA || atEnd == COMMIT_CHAR_SEMICOLON;
1904        }
1905        return false;
1906    }
1907
1908    /**
1909     * Clears the selected chip if there is one (and dismissing any popups related to the selected
1910     * chip in the process).
1911     */
1912    public void clearSelectedChip() {
1913        if (mSelectedChip != null) {
1914            unselectChip(mSelectedChip);
1915            mSelectedChip = null;
1916        }
1917        setCursorVisible(true);
1918        setSelection(getText().length());
1919    }
1920
1921    /**
1922     * Monitor touch events in the RecipientEditTextView.
1923     * If the view does not have focus, any tap on the view
1924     * will just focus the view. If the view has focus, determine
1925     * if the touch target is a recipient chip. If it is and the chip
1926     * is not selected, select it and clear any other selected chips.
1927     * If it isn't, then select that chip.
1928     */
1929    @Override
1930    public boolean onTouchEvent(@NonNull MotionEvent event) {
1931        boolean handled;
1932        int action = event.getAction();
1933        final float x = event.getX();
1934        final float y = event.getY();
1935        final int offset = putOffsetInRange(x, y);
1936        final DrawableRecipientChip currentChip = findChip(offset);
1937        if (action == MotionEvent.ACTION_UP) {
1938            boolean touchedWarningIcon = touchedWarningIcon(x, y, currentChip);
1939            if (touchedWarningIcon) {
1940                String warningText = String.format(mWarningTextTemplate,
1941                    currentChip.getEntry().getDestination());
1942                showWarningDialog(warningText);
1943                return true;
1944            }
1945            if (!isFocused()) {
1946                // Ignore further chip taps until this view is focused.
1947                return touchedWarningIcon || super.onTouchEvent(event);
1948            }
1949            handled = super.onTouchEvent(event);
1950            if (mSelectedChip == null) {
1951                mGestureDetector.onTouchEvent(event);
1952            }
1953            boolean chipWasSelected = false;
1954            if (currentChip != null) {
1955                if (mSelectedChip != null && mSelectedChip != currentChip) {
1956                    clearSelectedChip();
1957                    selectChip(currentChip);
1958                } else if (mSelectedChip == null) {
1959                    commitDefault();
1960                    selectChip(currentChip);
1961                } else {
1962                    onClick(mSelectedChip);
1963                }
1964                chipWasSelected = true;
1965                handled = true;
1966            } else if (mSelectedChip != null && shouldShowEditableText(mSelectedChip)) {
1967                chipWasSelected = true;
1968            }
1969            if (!chipWasSelected) {
1970                clearSelectedChip();
1971            }
1972        } else {
1973            boolean touchedWarningIcon = touchedWarningIcon(x, y, currentChip);
1974            if (touchedWarningIcon) {
1975                return true;
1976            }
1977            handled = super.onTouchEvent(event);
1978            if (!isFocused()) {
1979                return handled;
1980            }
1981            if (mSelectedChip == null) {
1982                mGestureDetector.onTouchEvent(event);
1983            }
1984        }
1985        return handled;
1986    }
1987
1988    private boolean touchedWarningIcon(float x, float y, DrawableRecipientChip currentChip) {
1989        boolean touchedWarningIcon = false;
1990        if (currentChip != null) {
1991            Rect outOfDomainWarningBounds = currentChip.getWarningIconBounds();
1992            if (outOfDomainWarningBounds != null) {
1993                int chipLeftOffset = shouldPositionAvatarOnRight()
1994                        ? getChipEnd(currentChip) : getChipStart(currentChip);
1995                float chipLeftPosition = this.getLayout().getPrimaryHorizontal(chipLeftOffset);
1996                float chipTopPosition = this.getLayout().getLineTop(
1997                        this.getLayout().getLineForOffset(chipLeftOffset)) + getTotalPaddingTop();
1998                final RectF touchOutOfDomainWarning = new RectF(
1999                        chipLeftPosition + outOfDomainWarningBounds.left,
2000                        chipTopPosition + outOfDomainWarningBounds.top,
2001                        chipLeftPosition + outOfDomainWarningBounds.right,
2002                        chipTopPosition + outOfDomainWarningBounds.bottom);
2003                touchedWarningIcon = touchOutOfDomainWarning.contains(x, y);
2004            }
2005        }
2006        return touchedWarningIcon;
2007    }
2008
2009    private void showWarningDialog(String warningText) {
2010        mCurrentWarningText = warningText;
2011        new AlertDialog.Builder(RecipientEditTextView.this.getContext())
2012                .setTitle(mWarningTitle)
2013                .setOnDismissListener(new DialogInterface.OnDismissListener() {
2014                    @Override
2015                    public void onDismiss(DialogInterface dialog) {
2016                        mCurrentWarningText = "";
2017                    }
2018                })
2019                .setMessage(mCurrentWarningText)
2020                .show();
2021    }
2022
2023    private void showAlternates(final DrawableRecipientChip currentChip,
2024            final ListPopupWindow alternatesPopup) {
2025        new AsyncTask<Void, Void, ListAdapter>() {
2026            @Override
2027            protected ListAdapter doInBackground(final Void... params) {
2028                return createAlternatesAdapter(currentChip);
2029            }
2030
2031            @Override
2032            protected void onPostExecute(final ListAdapter result) {
2033                if (!mAttachedToWindow) {
2034                    return;
2035                }
2036                int line = getLayout().getLineForOffset(getChipStart(currentChip));
2037                int bottomOffset = calculateOffsetFromBottomToTop(line);
2038
2039                // Align the alternates popup with the left side of the View,
2040                // regardless of the position of the chip tapped.
2041                alternatesPopup.setAnchorView((mAlternatePopupAnchor != null) ?
2042                        mAlternatePopupAnchor : RecipientEditTextView.this);
2043                alternatesPopup.setVerticalOffset(bottomOffset);
2044                alternatesPopup.setAdapter(result);
2045                alternatesPopup.setOnItemClickListener(mAlternatesListener);
2046                // Clear the checked item.
2047                mCheckedItem = -1;
2048                alternatesPopup.show();
2049                ListView listView = alternatesPopup.getListView();
2050                listView.setChoiceMode(ListView.CHOICE_MODE_SINGLE);
2051                // Checked item would be -1 if the adapter has not
2052                // loaded the view that should be checked yet. The
2053                // variable will be set correctly when onCheckedItemChanged
2054                // is called in a separate thread.
2055                if (mCheckedItem != -1) {
2056                    listView.setItemChecked(mCheckedItem, true);
2057                    mCheckedItem = -1;
2058                }
2059            }
2060        }.execute((Void[]) null);
2061    }
2062
2063    protected ListAdapter createAlternatesAdapter(DrawableRecipientChip chip) {
2064        return new RecipientAlternatesAdapter(getContext(), chip.getContactId(),
2065                chip.getDirectoryId(), chip.getLookupKey(), chip.getDataId(),
2066                getAdapter().getQueryType(), this, mDropdownChipLayouter,
2067                constructStateListDeleteDrawable(), getAdapter().getPermissionsCheckListener());
2068    }
2069
2070    private ListAdapter createSingleAddressAdapter(DrawableRecipientChip currentChip) {
2071        return new SingleRecipientArrayAdapter(getContext(), currentChip.getEntry(),
2072                mDropdownChipLayouter, constructStateListDeleteDrawable());
2073    }
2074
2075    private StateListDrawable constructStateListDeleteDrawable() {
2076        // Construct the StateListDrawable from deleteDrawable
2077        StateListDrawable deleteDrawable = new StateListDrawable();
2078        if (!mDisableDelete) {
2079            deleteDrawable.addState(new int[]{android.R.attr.state_activated}, mChipDelete);
2080        }
2081        deleteDrawable.addState(new int[0], null);
2082        return deleteDrawable;
2083    }
2084
2085    @Override
2086    public void onCheckedItemChanged(int position) {
2087        ListView listView = mAlternatesPopup.getListView();
2088        if (listView != null && listView.getCheckedItemCount() == 0) {
2089            listView.setItemChecked(position, true);
2090        }
2091        mCheckedItem = position;
2092    }
2093
2094    private int putOffsetInRange(final float x, final float y) {
2095        final int offset;
2096
2097        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.ICE_CREAM_SANDWICH) {
2098            offset = getOffsetForPosition(x, y);
2099        } else {
2100            offset = supportGetOffsetForPosition(x, y);
2101        }
2102
2103        return putOffsetInRange(offset);
2104    }
2105
2106    // TODO: This algorithm will need a lot of tweaking after more people have used
2107    // the chips ui. This attempts to be "forgiving" to fat finger touches by favoring
2108    // what comes before the finger.
2109    private int putOffsetInRange(int o) {
2110        int offset = o;
2111        Editable text = getText();
2112        int length = text.length();
2113        // Remove whitespace from end to find "real end"
2114        int realLength = length;
2115        for (int i = length - 1; i >= 0; i--) {
2116            if (text.charAt(i) == ' ') {
2117                realLength--;
2118            } else {
2119                break;
2120            }
2121        }
2122
2123        // If the offset is beyond or at the end of the text,
2124        // leave it alone.
2125        if (offset >= realLength) {
2126            return offset;
2127        }
2128        Editable editable = getText();
2129        while (offset >= 0 && findText(editable, offset) == -1 && findChip(offset) == null) {
2130            // Keep walking backward!
2131            offset--;
2132        }
2133        return offset;
2134    }
2135
2136    private static int findText(Editable text, int offset) {
2137        if (text.charAt(offset) != ' ') {
2138            return offset;
2139        }
2140        return -1;
2141    }
2142
2143    private DrawableRecipientChip findChip(int offset) {
2144        final Spannable span = getSpannable();
2145        final DrawableRecipientChip[] chips =
2146                span.getSpans(0, span.length(), DrawableRecipientChip.class);
2147        // Find the chip that contains this offset.
2148        for (DrawableRecipientChip chip : chips) {
2149            int start = getChipStart(chip);
2150            int end = getChipEnd(chip);
2151            if (offset >= start && offset <= end) {
2152                return chip;
2153            }
2154        }
2155        return null;
2156    }
2157
2158    // Visible for testing.
2159    // Use this method to generate text to add to the list of addresses.
2160    /* package */String createAddressText(RecipientEntry entry) {
2161        String display = entry.getDisplayName();
2162        String address = entry.getDestination();
2163        if (TextUtils.isEmpty(display) || TextUtils.equals(display, address)) {
2164            display = null;
2165        }
2166        String trimmedDisplayText;
2167        if (isPhoneQuery() && PhoneUtil.isPhoneNumber(address)) {
2168            trimmedDisplayText = address.trim();
2169        } else {
2170            if (address != null) {
2171                // Tokenize out the address in case the address already
2172                // contained the username as well.
2173                Rfc822Token[] tokenized = Rfc822Tokenizer.tokenize(address);
2174                if (tokenized != null && tokenized.length > 0) {
2175                    address = tokenized[0].getAddress();
2176                }
2177            }
2178            Rfc822Token token = new Rfc822Token(display, address, null);
2179            trimmedDisplayText = token.toString().trim();
2180        }
2181        int index = trimmedDisplayText.indexOf(",");
2182        return mTokenizer != null && !TextUtils.isEmpty(trimmedDisplayText)
2183                && index < trimmedDisplayText.length() - 1 ? (String) mTokenizer
2184                .terminateToken(trimmedDisplayText) : trimmedDisplayText;
2185    }
2186
2187    // Visible for testing.
2188    // Use this method to generate text to display in a chip.
2189    /*package*/ String createChipDisplayText(RecipientEntry entry) {
2190        String display = entry.getDisplayName();
2191        String address = entry.getDestination();
2192        if (TextUtils.isEmpty(display) || TextUtils.equals(display, address)) {
2193            display = null;
2194        }
2195        if (!TextUtils.isEmpty(display)) {
2196            return display;
2197        } else if (!TextUtils.isEmpty(address)){
2198            return address;
2199        } else {
2200            return new Rfc822Token(display, address, null).toString();
2201        }
2202    }
2203
2204    private CharSequence createChip(RecipientEntry entry) {
2205        final String displayText = createAddressText(entry);
2206        if (TextUtils.isEmpty(displayText)) {
2207            return null;
2208        }
2209        // Always leave a blank space at the end of a chip.
2210        final int textLength = displayText.length() - 1;
2211        final SpannableString  chipText = new SpannableString(displayText);
2212        if (!mNoChipMode) {
2213            try {
2214                DrawableRecipientChip chip = constructChipSpan(entry);
2215                chipText.setSpan(chip, 0, textLength,
2216                        Spanned.SPAN_EXCLUSIVE_EXCLUSIVE);
2217                chip.setOriginalText(chipText.toString());
2218            } catch (NullPointerException e) {
2219                Log.e(TAG, e.getMessage(), e);
2220                return null;
2221            }
2222        }
2223        onChipCreated(entry);
2224        return chipText;
2225    }
2226
2227    /**
2228     * A callback for subclasses to use to know when a chip was created with the
2229     * given RecipientEntry.
2230     */
2231    protected void onChipCreated(RecipientEntry entry) {
2232        if (!mNoChipMode && mRecipientChipAddedListener != null) {
2233            mRecipientChipAddedListener.onRecipientChipAdded(entry);
2234        }
2235    }
2236
2237    /**
2238     * When an item in the suggestions list has been clicked, create a chip from the
2239     * contact information of the selected item.
2240     */
2241    @Override
2242    public void onItemClick(AdapterView<?> parent, View view, int position, long id) {
2243        if (position < 0) {
2244            return;
2245        }
2246
2247        final RecipientEntry entry = getAdapter().getItem(position);
2248        if (entry.getEntryType() == RecipientEntry.ENTRY_TYPE_PERMISSION_REQUEST) {
2249            if (mPermissionsRequestItemClickedListener != null) {
2250                mPermissionsRequestItemClickedListener
2251                        .onPermissionsRequestItemClicked(this, entry.getPermissions());
2252            }
2253            return;
2254        }
2255
2256        final int charactersTyped = submitItemAtPosition(position);
2257        if (charactersTyped > -1 && mRecipientEntryItemClickedListener != null) {
2258            mRecipientEntryItemClickedListener
2259                    .onRecipientEntryItemClicked(charactersTyped, position);
2260        }
2261    }
2262
2263    private int submitItemAtPosition(int position) {
2264        RecipientEntry entry = createValidatedEntry(getAdapter().getItem(position));
2265        if (entry == null) {
2266            return -1;
2267        }
2268        clearComposingText();
2269
2270        int end = getSelectionEnd();
2271        int start = mTokenizer.findTokenStart(getText(), end);
2272
2273        Editable editable = getText();
2274        QwertyKeyListener.markAsReplaced(editable, start, end, "");
2275        CharSequence chip = createChip(entry);
2276        if (chip != null && start >= 0 && end >= 0) {
2277            editable.replace(start, end, chip);
2278        }
2279        sanitizeBetween();
2280
2281        return end - start;
2282    }
2283
2284    private RecipientEntry createValidatedEntry(RecipientEntry item) {
2285        if (item == null) {
2286            return null;
2287        }
2288        final RecipientEntry entry;
2289        // If the display name and the address are the same, or if this is a
2290        // valid contact, but the destination is invalid, then make this a fake
2291        // recipient that is editable.
2292        String destination = item.getDestination();
2293        if (!isPhoneQuery() && item.getContactId() == RecipientEntry.GENERATED_CONTACT) {
2294            entry = RecipientEntry.constructGeneratedEntry(item.getDisplayName(),
2295                    destination, item.isValid());
2296        } else if (RecipientEntry.isCreatedRecipient(item.getContactId())
2297                && (TextUtils.isEmpty(item.getDisplayName())
2298                        || TextUtils.equals(item.getDisplayName(), destination)
2299                        || (mValidator != null && !mValidator.isValid(destination)))) {
2300            entry = RecipientEntry.constructFakeEntry(destination, item.isValid());
2301        } else {
2302            entry = item;
2303        }
2304        return entry;
2305    }
2306
2307    // Visible for testing.
2308    /* package */DrawableRecipientChip[] getSortedRecipients() {
2309        DrawableRecipientChip[] recips = getSpannable()
2310                .getSpans(0, getText().length(), DrawableRecipientChip.class);
2311        ArrayList<DrawableRecipientChip> recipientsList = new ArrayList<DrawableRecipientChip>(
2312                Arrays.asList(recips));
2313        final Spannable spannable = getSpannable();
2314        Collections.sort(recipientsList, new Comparator<DrawableRecipientChip>() {
2315
2316            @Override
2317            public int compare(DrawableRecipientChip first, DrawableRecipientChip second) {
2318                int firstStart = spannable.getSpanStart(first);
2319                int secondStart = spannable.getSpanStart(second);
2320                if (firstStart < secondStart) {
2321                    return -1;
2322                } else if (firstStart > secondStart) {
2323                    return 1;
2324                } else {
2325                    return 0;
2326                }
2327            }
2328        });
2329        return recipientsList.toArray(new DrawableRecipientChip[recipientsList.size()]);
2330    }
2331
2332    @Override
2333    public boolean onActionItemClicked(ActionMode mode, MenuItem item) {
2334        return false;
2335    }
2336
2337    @Override
2338    public void onDestroyActionMode(ActionMode mode) {
2339    }
2340
2341    @Override
2342    public boolean onPrepareActionMode(ActionMode mode, Menu menu) {
2343        return false;
2344    }
2345
2346    /**
2347     * No chips are selectable.
2348     */
2349    @Override
2350    public boolean onCreateActionMode(ActionMode mode, Menu menu) {
2351        return false;
2352    }
2353
2354    // Visible for testing.
2355    /* package */ReplacementDrawableSpan getMoreChip() {
2356        MoreImageSpan[] moreSpans = getSpannable().getSpans(0, getText().length(),
2357                MoreImageSpan.class);
2358        return moreSpans != null && moreSpans.length > 0 ? moreSpans[0] : null;
2359    }
2360
2361    private MoreImageSpan createMoreSpan(int count) {
2362        String moreText = String.format(mMoreItem.getText().toString(), count);
2363        mWorkPaint.set(getPaint());
2364        mWorkPaint.setTextSize(mMoreItem.getTextSize());
2365        mWorkPaint.setColor(mMoreItem.getCurrentTextColor());
2366        final int width = (int) mWorkPaint.measureText(moreText) + mMoreItem.getPaddingLeft()
2367                + mMoreItem.getPaddingRight();
2368        final int height = (int) mChipHeight;
2369        Bitmap drawable = Bitmap.createBitmap(width, height, Bitmap.Config.ARGB_8888);
2370        Canvas canvas = new Canvas(drawable);
2371        int adjustedHeight = height;
2372        Layout layout = getLayout();
2373        if (layout != null) {
2374            adjustedHeight -= layout.getLineDescent(0);
2375        }
2376        canvas.drawText(moreText, 0, moreText.length(), 0, adjustedHeight, mWorkPaint);
2377
2378        Drawable result = new BitmapDrawable(getResources(), drawable);
2379        result.setBounds(0, 0, width, height);
2380        return new MoreImageSpan(result);
2381    }
2382
2383    // Visible for testing.
2384    /*package*/ void createMoreChipPlainText() {
2385        // Take the first <= CHIP_LIMIT addresses and get to the end of the second one.
2386        Editable text = getText();
2387        int start = 0;
2388        int end = start;
2389        for (int i = 0; i < CHIP_LIMIT; i++) {
2390            end = movePastTerminators(mTokenizer.findTokenEnd(text, start));
2391            start = end; // move to the next token and get its end.
2392        }
2393        // Now, count total addresses.
2394        int tokenCount = countTokens(text);
2395        MoreImageSpan moreSpan = createMoreSpan(tokenCount - CHIP_LIMIT);
2396        SpannableString chipText = new SpannableString(text.subSequence(end, text.length()));
2397        chipText.setSpan(moreSpan, 0, chipText.length(), Spanned.SPAN_EXCLUSIVE_EXCLUSIVE);
2398        text.replace(end, text.length(), chipText);
2399        mMoreChip = moreSpan;
2400    }
2401
2402    // Visible for testing.
2403    /* package */int countTokens(Editable text) {
2404        int tokenCount = 0;
2405        int start = 0;
2406        while (start < text.length()) {
2407            start = movePastTerminators(mTokenizer.findTokenEnd(text, start));
2408            tokenCount++;
2409            if (start >= text.length()) {
2410                break;
2411            }
2412        }
2413        return tokenCount;
2414    }
2415
2416    /**
2417     * Create the more chip. The more chip is text that replaces any chips that
2418     * do not fit in the pre-defined available space when the
2419     * RecipientEditTextView loses focus.
2420     */
2421    // Visible for testing.
2422    /* package */ void createMoreChip() {
2423        if (mNoChipMode) {
2424            createMoreChipPlainText();
2425            return;
2426        }
2427
2428        if (!mShouldShrink) {
2429            return;
2430        }
2431        ReplacementDrawableSpan[] tempMore = getSpannable().getSpans(0, getText().length(),
2432                MoreImageSpan.class);
2433        if (tempMore.length > 0) {
2434            getSpannable().removeSpan(tempMore[0]);
2435        }
2436        DrawableRecipientChip[] recipients = getSortedRecipients();
2437
2438        if (recipients == null || recipients.length <= CHIP_LIMIT) {
2439            mMoreChip = null;
2440            return;
2441        }
2442        Spannable spannable = getSpannable();
2443        int numRecipients = recipients.length;
2444        int overage = numRecipients - CHIP_LIMIT;
2445        MoreImageSpan moreSpan = createMoreSpan(overage);
2446        mHiddenSpans = new ArrayList<DrawableRecipientChip>();
2447        int totalReplaceStart = 0;
2448        int totalReplaceEnd = 0;
2449        Editable text = getText();
2450        for (int i = numRecipients - overage; i < recipients.length; i++) {
2451            mHiddenSpans.add(recipients[i]);
2452            if (i == numRecipients - overage) {
2453                totalReplaceStart = spannable.getSpanStart(recipients[i]);
2454            }
2455            if (i == recipients.length - 1) {
2456                totalReplaceEnd = spannable.getSpanEnd(recipients[i]);
2457            }
2458            if (mTemporaryRecipients == null || !mTemporaryRecipients.contains(recipients[i])) {
2459                int spanStart = spannable.getSpanStart(recipients[i]);
2460                int spanEnd = spannable.getSpanEnd(recipients[i]);
2461                recipients[i].setOriginalText(text.toString().substring(spanStart, spanEnd));
2462            }
2463            spannable.removeSpan(recipients[i]);
2464        }
2465        if (totalReplaceEnd < text.length()) {
2466            totalReplaceEnd = text.length();
2467        }
2468        int end = Math.max(totalReplaceStart, totalReplaceEnd);
2469        int start = Math.min(totalReplaceStart, totalReplaceEnd);
2470        SpannableString chipText = new SpannableString(text.subSequence(start, end));
2471        chipText.setSpan(moreSpan, 0, chipText.length(), Spanned.SPAN_EXCLUSIVE_EXCLUSIVE);
2472        text.replace(start, end, chipText);
2473        mMoreChip = moreSpan;
2474        // If adding the +more chip goes over the limit, resize accordingly.
2475        if (!isPhoneQuery() && getLineCount() > mMaxLines) {
2476            setMaxLines(getLineCount());
2477        }
2478    }
2479
2480    /**
2481     * Replace the more chip, if it exists, with all of the recipient chips it had
2482     * replaced when the RecipientEditTextView gains focus.
2483     */
2484    // Visible for testing.
2485    /*package*/ void removeMoreChip() {
2486        if (mMoreChip != null) {
2487            Spannable span = getSpannable();
2488            span.removeSpan(mMoreChip);
2489            mMoreChip = null;
2490            // Re-add the spans that were hidden.
2491            if (mHiddenSpans != null && mHiddenSpans.size() > 0) {
2492                // Recreate each hidden span.
2493                DrawableRecipientChip[] recipients = getSortedRecipients();
2494                // Start the search for tokens after the last currently visible
2495                // chip.
2496                if (recipients == null || recipients.length == 0) {
2497                    return;
2498                }
2499                int end = span.getSpanEnd(recipients[recipients.length - 1]);
2500                Editable editable = getText();
2501                for (DrawableRecipientChip chip : mHiddenSpans) {
2502                    int chipStart;
2503                    int chipEnd;
2504                    String token;
2505                    // Need to find the location of the chip, again.
2506                    token = (String) chip.getOriginalText();
2507                    // As we find the matching recipient for the hidden spans,
2508                    // reduce the size of the string we need to search.
2509                    // That way, if there are duplicates, we always find the correct
2510                    // recipient.
2511                    chipStart = editable.toString().indexOf(token, end);
2512                    end = chipEnd = Math.min(editable.length(), chipStart + token.length());
2513                    // Only set the span if we found a matching token.
2514                    if (chipStart != -1) {
2515                        editable.setSpan(chip, chipStart, chipEnd,
2516                                Spannable.SPAN_EXCLUSIVE_EXCLUSIVE);
2517                    }
2518                }
2519                mHiddenSpans.clear();
2520            }
2521        }
2522    }
2523
2524    /**
2525     * Show specified chip as selected. If the RecipientChip is just an email address,
2526     * selecting the chip will take the contents of the chip and place it at
2527     * the end of the RecipientEditTextView for inline editing. If the
2528     * RecipientChip is a complete contact, then selecting the chip
2529     * will show a popup window with the address in use highlighted and any other
2530     * alternate addresses for the contact.
2531     * @param currentChip Chip to select.
2532     */
2533    private void selectChip(DrawableRecipientChip currentChip) {
2534        if (shouldShowEditableText(currentChip)) {
2535            CharSequence text = currentChip.getValue();
2536            Editable editable = getText();
2537            Spannable spannable = getSpannable();
2538            int spanStart = spannable.getSpanStart(currentChip);
2539            int spanEnd = spannable.getSpanEnd(currentChip);
2540            spannable.removeSpan(currentChip);
2541            // Don't need leading space if it's the only chip
2542            if (spanEnd - spanStart == editable.length() - 1) {
2543                spanEnd++;
2544            }
2545            editable.delete(spanStart, spanEnd);
2546            setCursorVisible(true);
2547            setSelection(editable.length());
2548            editable.append(text);
2549            mSelectedChip = constructChipSpan(
2550                    RecipientEntry.constructFakeEntry((String) text, isValid(text.toString())));
2551
2552            /*
2553             * Because chip is destroyed and converted into an editable text, we call
2554             * {@link RecipientChipDeletedListener#onRecipientChipDeleted}. For the cases where
2555             * editable text is not shown (i.e. chip is in user's contact list), chip is focused
2556             * and below callback is not called.
2557             */
2558            if (!mNoChipMode && mRecipientChipDeletedListener != null) {
2559                mRecipientChipDeletedListener.onRecipientChipDeleted(currentChip.getEntry());
2560            }
2561        } else {
2562            final boolean showAddress =
2563                    currentChip.getContactId() == RecipientEntry.GENERATED_CONTACT ||
2564                    getAdapter().forceShowAddress();
2565            if (showAddress && mNoChipMode) {
2566                return;
2567            }
2568
2569            if (isTouchExplorationEnabled()) {
2570                // The chips cannot be touch-explored. However, doing a double-tap results in
2571                // the popup being shown for the last chip, which is of no value.
2572                return;
2573            }
2574
2575            mSelectedChip = currentChip;
2576            setSelection(getText().getSpanEnd(mSelectedChip));
2577            setCursorVisible(false);
2578
2579            if (showAddress) {
2580                showAddress(currentChip, mAddressPopup);
2581            } else {
2582                showAlternates(currentChip, mAlternatesPopup);
2583            }
2584        }
2585    }
2586
2587    private boolean isTouchExplorationEnabled() {
2588        if (Build.VERSION.SDK_INT < Build.VERSION_CODES.ICE_CREAM_SANDWICH) {
2589            return false;
2590        }
2591
2592        final AccessibilityManager accessibilityManager = (AccessibilityManager)
2593                getContext().getSystemService(Context.ACCESSIBILITY_SERVICE);
2594        return accessibilityManager.isTouchExplorationEnabled();
2595    }
2596
2597    private boolean shouldShowEditableText(DrawableRecipientChip currentChip) {
2598        long contactId = currentChip.getContactId();
2599        return contactId == RecipientEntry.INVALID_CONTACT
2600                || (!isPhoneQuery() && contactId == RecipientEntry.GENERATED_CONTACT);
2601    }
2602
2603    private void showAddress(final DrawableRecipientChip currentChip, final ListPopupWindow popup) {
2604        if (!mAttachedToWindow) {
2605            return;
2606        }
2607        int line = getLayout().getLineForOffset(getChipStart(currentChip));
2608        int bottomOffset = calculateOffsetFromBottomToTop(line);
2609        // Align the alternates popup with the left side of the View,
2610        // regardless of the position of the chip tapped.
2611        popup.setAnchorView((mAlternatePopupAnchor != null) ? mAlternatePopupAnchor : this);
2612        popup.setVerticalOffset(bottomOffset);
2613        popup.setAdapter(createSingleAddressAdapter(currentChip));
2614        popup.setOnItemClickListener(new OnItemClickListener() {
2615            @Override
2616            public void onItemClick(AdapterView<?> parent, View view, int position, long id) {
2617                unselectChip(currentChip);
2618                popup.dismiss();
2619            }
2620        });
2621        popup.show();
2622        ListView listView = popup.getListView();
2623        listView.setChoiceMode(ListView.CHOICE_MODE_SINGLE);
2624        listView.setItemChecked(0, true);
2625    }
2626
2627    /**
2628     * Remove selection from this chip. Unselecting a RecipientChip will render
2629     * the chip without a delete icon and with an unfocused background. This is
2630     * called when the RecipientChip no longer has focus.
2631     */
2632    private void unselectChip(DrawableRecipientChip chip) {
2633        int start = getChipStart(chip);
2634        int end = getChipEnd(chip);
2635        Editable editable = getText();
2636        mSelectedChip = null;
2637        if (start == -1 || end == -1) {
2638            Log.w(TAG, "The chip doesn't exist or may be a chip a user was editing");
2639            setSelection(editable.length());
2640            commitDefault();
2641        } else {
2642            getSpannable().removeSpan(chip);
2643            QwertyKeyListener.markAsReplaced(editable, start, end, "");
2644            editable.removeSpan(chip);
2645            try {
2646                if (!mNoChipMode) {
2647                    editable.setSpan(constructChipSpan(chip.getEntry()),
2648                            start, end, Spanned.SPAN_EXCLUSIVE_EXCLUSIVE);
2649                }
2650            } catch (NullPointerException e) {
2651                Log.e(TAG, e.getMessage(), e);
2652            }
2653        }
2654        setCursorVisible(true);
2655        setSelection(editable.length());
2656        if (mAlternatesPopup != null && mAlternatesPopup.isShowing()) {
2657            mAlternatesPopup.dismiss();
2658        }
2659    }
2660
2661    @Override
2662    public void onChipDelete() {
2663        if (mSelectedChip != null) {
2664            if (!mNoChipMode && mRecipientChipDeletedListener != null) {
2665                mRecipientChipDeletedListener.onRecipientChipDeleted(mSelectedChip.getEntry());
2666            }
2667            removeChip(mSelectedChip);
2668        }
2669        dismissPopups();
2670    }
2671
2672    @Override
2673    public void onPermissionRequestDismissed() {
2674        if (mPermissionsRequestItemClickedListener != null) {
2675            mPermissionsRequestItemClickedListener.onPermissionRequestDismissed();
2676        }
2677        dismissDropDown();
2678    }
2679
2680    private void dismissPopups() {
2681        if (mAlternatesPopup != null && mAlternatesPopup.isShowing()) {
2682            mAlternatesPopup.dismiss();
2683        }
2684        if (mAddressPopup != null && mAddressPopup.isShowing()) {
2685            mAddressPopup.dismiss();
2686        }
2687        setSelection(getText().length());
2688    }
2689
2690    /**
2691     * Remove the chip and any text associated with it from the RecipientEditTextView.
2692     */
2693    // Visible for testing.
2694    /* package */void removeChip(DrawableRecipientChip chip) {
2695        Spannable spannable = getSpannable();
2696        int spanStart = spannable.getSpanStart(chip);
2697        int spanEnd = spannable.getSpanEnd(chip);
2698        Editable text = getText();
2699        int toDelete = spanEnd;
2700        boolean wasSelected = chip == mSelectedChip;
2701        // Clear that there is a selected chip before updating any text.
2702        if (wasSelected) {
2703            mSelectedChip = null;
2704        }
2705        // Always remove trailing spaces when removing a chip.
2706        while (toDelete >= 0 && toDelete < text.length() && text.charAt(toDelete) == ' ') {
2707            toDelete++;
2708        }
2709        spannable.removeSpan(chip);
2710        if (spanStart >= 0 && toDelete > 0) {
2711            text.delete(spanStart, toDelete);
2712        }
2713        if (wasSelected) {
2714            clearSelectedChip();
2715        }
2716    }
2717
2718    /**
2719     * Replace this currently selected chip with a new chip
2720     * that uses the contact data provided.
2721     */
2722    // Visible for testing.
2723    /*package*/ void replaceChip(DrawableRecipientChip chip, RecipientEntry entry) {
2724        boolean wasSelected = chip == mSelectedChip;
2725        if (wasSelected) {
2726            mSelectedChip = null;
2727        }
2728        int start = getChipStart(chip);
2729        int end = getChipEnd(chip);
2730        getSpannable().removeSpan(chip);
2731        Editable editable = getText();
2732        entry.setInReplacedChip(true);
2733        CharSequence chipText = createChip(entry);
2734        if (chipText != null) {
2735            if (start == -1 || end == -1) {
2736                Log.e(TAG, "The chip to replace does not exist but should.");
2737                editable.insert(0, chipText);
2738            } else {
2739                if (!TextUtils.isEmpty(chipText)) {
2740                    // There may be a space to replace with this chip's new
2741                    // associated space. Check for it
2742                    int toReplace = end;
2743                    while (toReplace >= 0 && toReplace < editable.length()
2744                            && editable.charAt(toReplace) == ' ') {
2745                        toReplace++;
2746                    }
2747                    editable.replace(start, toReplace, chipText);
2748                }
2749            }
2750        }
2751        setCursorVisible(true);
2752        if (wasSelected) {
2753            clearSelectedChip();
2754        }
2755    }
2756
2757    /**
2758     * Handle click events for a chip. When a selected chip receives a click
2759     * event, see if that event was in the delete icon. If so, delete it.
2760     * Otherwise, unselect the chip.
2761     */
2762    public void onClick(DrawableRecipientChip chip) {
2763        if (chip.isSelected()) {
2764            clearSelectedChip();
2765        }
2766    }
2767
2768    private boolean chipsPending() {
2769        return mPendingChipsCount > 0 || (mHiddenSpans != null && mHiddenSpans.size() > 0);
2770    }
2771
2772    @Override
2773    public void removeTextChangedListener(TextWatcher watcher) {
2774        mTextWatcher = null;
2775        super.removeTextChangedListener(watcher);
2776    }
2777
2778    private boolean isValidEmailAddress(String input) {
2779        return !TextUtils.isEmpty(input) && mValidator != null &&
2780                mValidator.isValid(input);
2781    }
2782
2783    private class RecipientTextWatcher implements TextWatcher {
2784
2785        @Override
2786        public void afterTextChanged(Editable s) {
2787            // If the text has been set to null or empty, make sure we remove
2788            // all the spans we applied.
2789            if (TextUtils.isEmpty(s)) {
2790                // Remove all the chips spans.
2791                Spannable spannable = getSpannable();
2792                DrawableRecipientChip[] chips = spannable.getSpans(0, getText().length(),
2793                        DrawableRecipientChip.class);
2794                for (DrawableRecipientChip chip : chips) {
2795                    spannable.removeSpan(chip);
2796                }
2797                if (mMoreChip != null) {
2798                    spannable.removeSpan(mMoreChip);
2799                }
2800                clearSelectedChip();
2801                return;
2802            }
2803            // Get whether there are any recipients pending addition to the
2804            // view. If there are, don't do anything in the text watcher.
2805            if (chipsPending()) {
2806                return;
2807            }
2808            // If the user is editing a chip, don't clear it.
2809            if (mSelectedChip != null) {
2810                if (!isGeneratedContact(mSelectedChip)) {
2811                    setCursorVisible(true);
2812                    setSelection(getText().length());
2813                    clearSelectedChip();
2814                } else {
2815                    return;
2816                }
2817            }
2818            int length = s.length();
2819            // Make sure there is content there to parse and that it is
2820            // not just the commit character.
2821            if (length > 1) {
2822                if (lastCharacterIsCommitCharacter(s)) {
2823                    commitByCharacter();
2824                    return;
2825                }
2826                char last;
2827                int end = getSelectionEnd() == 0 ? 0 : getSelectionEnd() - 1;
2828                int len = length() - 1;
2829                if (end != len) {
2830                    last = s.charAt(end);
2831                } else {
2832                    last = s.charAt(len);
2833                }
2834                if (last == COMMIT_CHAR_SPACE) {
2835                    if (!isPhoneQuery()) {
2836                        // Check if this is a valid email address. If it is,
2837                        // commit it.
2838                        String text = getText().toString();
2839                        int tokenStart = mTokenizer.findTokenStart(text, getSelectionEnd());
2840                        String sub = text.substring(tokenStart, mTokenizer.findTokenEnd(text,
2841                                tokenStart));
2842                        if (isValidEmailAddress(sub)) {
2843                            commitByCharacter();
2844                        }
2845                    }
2846                }
2847            }
2848        }
2849
2850        @Override
2851        public void onTextChanged(CharSequence s, int start, int before, int count) {
2852            // The user deleted some text OR some text was replaced; check to
2853            // see if the insertion point is on a space
2854            // following a chip.
2855            if (before - count == 1) {
2856                // If the item deleted is a space, and the thing before the
2857                // space is a chip, delete the entire span.
2858                int selStart = getSelectionStart();
2859                DrawableRecipientChip[] repl = getSpannable().getSpans(selStart, selStart,
2860                        DrawableRecipientChip.class);
2861                if (repl.length > 0) {
2862                    // There is a chip there! Just remove it.
2863                    DrawableRecipientChip toDelete = repl[0];
2864                    Editable editable = getText();
2865                    // Add the separator token.
2866                    int deleteStart = editable.getSpanStart(toDelete);
2867                    int deleteEnd = editable.getSpanEnd(toDelete) + 1;
2868                    if (deleteEnd > editable.length()) {
2869                        deleteEnd = editable.length();
2870                    }
2871                    if (!mNoChipMode && mRecipientChipDeletedListener != null) {
2872                        mRecipientChipDeletedListener.onRecipientChipDeleted(toDelete.getEntry());
2873                    }
2874                    editable.removeSpan(toDelete);
2875                    editable.delete(deleteStart, deleteEnd);
2876                }
2877            } else if (count > before) {
2878                if (mSelectedChip != null
2879                    && isGeneratedContact(mSelectedChip)) {
2880                    if (lastCharacterIsCommitCharacter(s)) {
2881                        commitByCharacter();
2882                        return;
2883                    }
2884                }
2885            }
2886        }
2887
2888        @Override
2889        public void beforeTextChanged(CharSequence s, int start, int count, int after) {
2890            // Do nothing.
2891        }
2892    }
2893
2894    public boolean lastCharacterIsCommitCharacter(CharSequence s) {
2895        char last;
2896        int end = getSelectionEnd() == 0 ? 0 : getSelectionEnd() - 1;
2897        int len = length() - 1;
2898        if (end != len) {
2899            last = s.charAt(end);
2900        } else {
2901            last = s.charAt(len);
2902        }
2903        return last == COMMIT_CHAR_COMMA || last == COMMIT_CHAR_SEMICOLON;
2904    }
2905
2906    public boolean isGeneratedContact(DrawableRecipientChip chip) {
2907        long contactId = chip.getContactId();
2908        return contactId == RecipientEntry.INVALID_CONTACT
2909                || (!isPhoneQuery() && contactId == RecipientEntry.GENERATED_CONTACT);
2910    }
2911
2912    /**
2913     * Handles pasting a {@link ClipData} to this {@link RecipientEditTextView}.
2914     */
2915    // Visible for testing.
2916    void handlePasteClip(ClipData clip) {
2917        if (clip == null) {
2918            // Do nothing.
2919            return;
2920        }
2921
2922        final ClipDescription clipDesc = clip.getDescription();
2923        boolean containsSupportedType = clipDesc.hasMimeType(ClipDescription.MIMETYPE_TEXT_PLAIN)
2924                || clipDesc.hasMimeType(ClipDescription.MIMETYPE_TEXT_HTML);
2925        if (!containsSupportedType) {
2926            return;
2927        }
2928
2929        removeTextChangedListener(mTextWatcher);
2930
2931        final ClipDescription clipDescription = clip.getDescription();
2932        for (int i = 0; i < clip.getItemCount(); i++) {
2933            final String mimeType = clipDescription.getMimeType(i);
2934            final boolean supportedType = ClipDescription.MIMETYPE_TEXT_PLAIN.equals(mimeType)
2935                    || ClipDescription.MIMETYPE_TEXT_HTML.equals(mimeType);
2936            if (!supportedType) {
2937                // Only plain text and html can be pasted.
2938                continue;
2939            }
2940
2941            final CharSequence pastedItem = clip.getItemAt(i).getText();
2942            if (!TextUtils.isEmpty(pastedItem)) {
2943                final Editable editable = getText();
2944                final int start = getSelectionStart();
2945                final int end = getSelectionEnd();
2946                if (start < 0 || end < 1) {
2947                    // No selection.
2948                    editable.append(pastedItem);
2949                } else if (start == end) {
2950                    // Insert at position.
2951                    editable.insert(start, pastedItem);
2952                } else {
2953                    editable.append(pastedItem, start, end);
2954                }
2955                handlePasteAndReplace();
2956            }
2957        }
2958
2959        mHandler.post(mAddTextWatcher);
2960    }
2961
2962    @Override
2963    public boolean onTextContextMenuItem(int id) {
2964        if (id == android.R.id.paste) {
2965            ClipboardManager clipboard = (ClipboardManager) getContext().getSystemService(
2966                    Context.CLIPBOARD_SERVICE);
2967            handlePasteClip(clipboard.getPrimaryClip());
2968            return true;
2969        }
2970        return super.onTextContextMenuItem(id);
2971    }
2972
2973    private void handlePasteAndReplace() {
2974        ArrayList<DrawableRecipientChip> created = handlePaste();
2975        if (created != null && created.size() > 0) {
2976            // Perform reverse lookups on the pasted contacts.
2977            IndividualReplacementTask replace = new IndividualReplacementTask();
2978            replace.execute(created);
2979        }
2980    }
2981
2982    // Visible for testing.
2983    /* package */ArrayList<DrawableRecipientChip> handlePaste() {
2984        String text = getText().toString();
2985        int originalTokenStart = mTokenizer.findTokenStart(text, getSelectionEnd());
2986        String lastAddress = text.substring(originalTokenStart);
2987        int tokenStart = originalTokenStart;
2988        int prevTokenStart = 0;
2989        DrawableRecipientChip findChip = null;
2990        ArrayList<DrawableRecipientChip> created = new ArrayList<DrawableRecipientChip>();
2991        if (tokenStart != 0) {
2992            // There are things before this!
2993            while (tokenStart != 0 && findChip == null && tokenStart != prevTokenStart) {
2994                prevTokenStart = tokenStart;
2995                tokenStart = mTokenizer.findTokenStart(text, tokenStart);
2996                findChip = findChip(tokenStart);
2997                if (tokenStart == originalTokenStart && findChip == null) {
2998                    break;
2999                }
3000            }
3001            if (tokenStart != originalTokenStart) {
3002                if (findChip != null) {
3003                    tokenStart = prevTokenStart;
3004                }
3005                int tokenEnd;
3006                DrawableRecipientChip createdChip;
3007                while (tokenStart < originalTokenStart) {
3008                    tokenEnd = movePastTerminators(mTokenizer.findTokenEnd(getText().toString(),
3009                            tokenStart));
3010                    commitChip(tokenStart, tokenEnd, getText());
3011                    createdChip = findChip(tokenStart);
3012                    if (createdChip == null) {
3013                        break;
3014                    }
3015                    // +1 for the space at the end.
3016                    tokenStart = getSpannable().getSpanEnd(createdChip) + 1;
3017                    created.add(createdChip);
3018                }
3019            }
3020        }
3021        // Take a look at the last token. If the token has been completed with a
3022        // commit character, create a chip.
3023        if (isCompletedToken(lastAddress)) {
3024            Editable editable = getText();
3025            tokenStart = editable.toString().indexOf(lastAddress, originalTokenStart);
3026            commitChip(tokenStart, editable.length(), editable);
3027            created.add(findChip(tokenStart));
3028        }
3029        return created;
3030    }
3031
3032    // Visible for testing.
3033    /* package */int movePastTerminators(int tokenEnd) {
3034        if (tokenEnd >= length()) {
3035            return tokenEnd;
3036        }
3037        char atEnd = getText().toString().charAt(tokenEnd);
3038        if (atEnd == COMMIT_CHAR_COMMA || atEnd == COMMIT_CHAR_SEMICOLON) {
3039            tokenEnd++;
3040        }
3041        // This token had not only an end token character, but also a space
3042        // separating it from the next token.
3043        if (tokenEnd < length() && getText().toString().charAt(tokenEnd) == ' ') {
3044            tokenEnd++;
3045        }
3046        return tokenEnd;
3047    }
3048
3049    private class RecipientReplacementTask extends AsyncTask<Void, Void, Void> {
3050        private DrawableRecipientChip createFreeChip(RecipientEntry entry) {
3051            try {
3052                if (mNoChipMode) {
3053                    return null;
3054                }
3055                return constructChipSpan(entry);
3056            } catch (NullPointerException e) {
3057                Log.e(TAG, e.getMessage(), e);
3058                return null;
3059            }
3060        }
3061
3062        @Override
3063        protected void onPreExecute() {
3064            // Ensure everything is in chip-form already, so we don't have text that slowly gets
3065            // replaced
3066            final List<DrawableRecipientChip> originalRecipients =
3067                    new ArrayList<DrawableRecipientChip>();
3068            final DrawableRecipientChip[] existingChips = getSortedRecipients();
3069            Collections.addAll(originalRecipients, existingChips);
3070            if (mHiddenSpans != null) {
3071                originalRecipients.addAll(mHiddenSpans);
3072            }
3073
3074            final List<DrawableRecipientChip> replacements =
3075                    new ArrayList<DrawableRecipientChip>(originalRecipients.size());
3076
3077            for (final DrawableRecipientChip chip : originalRecipients) {
3078                if (RecipientEntry.isCreatedRecipient(chip.getEntry().getContactId())
3079                        && getSpannable().getSpanStart(chip) != -1) {
3080                    replacements.add(createFreeChip(chip.getEntry()));
3081                } else {
3082                    replacements.add(null);
3083                }
3084            }
3085
3086            processReplacements(originalRecipients, replacements);
3087        }
3088
3089        @Override
3090        protected Void doInBackground(Void... params) {
3091            if (mIndividualReplacements != null) {
3092                mIndividualReplacements.cancel(true);
3093            }
3094            // For each chip in the list, look up the matching contact.
3095            // If there is a match, replace that chip with the matching
3096            // chip.
3097            final ArrayList<DrawableRecipientChip> recipients =
3098                    new ArrayList<DrawableRecipientChip>();
3099            DrawableRecipientChip[] existingChips = getSortedRecipients();
3100            Collections.addAll(recipients, existingChips);
3101            if (mHiddenSpans != null) {
3102                recipients.addAll(mHiddenSpans);
3103            }
3104            ArrayList<String> addresses = new ArrayList<String>();
3105            for (DrawableRecipientChip chip : recipients) {
3106                if (chip != null) {
3107                    addresses.add(createAddressText(chip.getEntry()));
3108                }
3109            }
3110            final BaseRecipientAdapter adapter = getAdapter();
3111            adapter.getMatchingRecipients(addresses, new RecipientMatchCallback() {
3112                        @Override
3113                        public void matchesFound(Map<String, RecipientEntry> entries) {
3114                            final ArrayList<DrawableRecipientChip> replacements =
3115                                    new ArrayList<DrawableRecipientChip>();
3116                            for (final DrawableRecipientChip temp : recipients) {
3117                                RecipientEntry entry = null;
3118                                if (temp != null && RecipientEntry.isCreatedRecipient(
3119                                        temp.getEntry().getContactId())
3120                                        && getSpannable().getSpanStart(temp) != -1) {
3121                                    // Replace this.
3122                                    entry = createValidatedEntry(
3123                                            entries.get(tokenizeAddress(temp.getEntry()
3124                                                    .getDestination())));
3125                                }
3126                                if (entry != null) {
3127                                    replacements.add(createFreeChip(entry));
3128                                } else {
3129                                    replacements.add(null);
3130                                }
3131                            }
3132                            processReplacements(recipients, replacements);
3133                        }
3134
3135                        @Override
3136                        public void matchesNotFound(final Set<String> unfoundAddresses) {
3137                            final List<DrawableRecipientChip> replacements =
3138                                    new ArrayList<DrawableRecipientChip>(unfoundAddresses.size());
3139
3140                            for (final DrawableRecipientChip temp : recipients) {
3141                                if (temp != null && RecipientEntry.isCreatedRecipient(
3142                                        temp.getEntry().getContactId())
3143                                        && getSpannable().getSpanStart(temp) != -1) {
3144                                    if (unfoundAddresses.contains(
3145                                            temp.getEntry().getDestination())) {
3146                                        replacements.add(createFreeChip(temp.getEntry()));
3147                                    } else {
3148                                        replacements.add(null);
3149                                    }
3150                                } else {
3151                                    replacements.add(null);
3152                                }
3153                            }
3154
3155                            processReplacements(recipients, replacements);
3156                        }
3157                    });
3158            return null;
3159        }
3160
3161        private void processReplacements(final List<DrawableRecipientChip> recipients,
3162                final List<DrawableRecipientChip> replacements) {
3163            if (replacements != null && replacements.size() > 0) {
3164                final Runnable runnable = new Runnable() {
3165                    @Override
3166                    public void run() {
3167                        final Editable text = new SpannableStringBuilder(getText());
3168                        int i = 0;
3169                        for (final DrawableRecipientChip chip : recipients) {
3170                            final DrawableRecipientChip replacement = replacements.get(i);
3171                            if (replacement != null) {
3172                                final RecipientEntry oldEntry = chip.getEntry();
3173                                final RecipientEntry newEntry = replacement.getEntry();
3174                                final boolean isBetter =
3175                                        RecipientAlternatesAdapter.getBetterRecipient(
3176                                                oldEntry, newEntry) == newEntry;
3177
3178                                if (isBetter) {
3179                                    // Find the location of the chip in the text currently shown.
3180                                    final int start = text.getSpanStart(chip);
3181                                    if (start != -1) {
3182                                        // Replacing the entirety of what the chip represented,
3183                                        // including the extra space dividing it from other chips.
3184                                        final int end =
3185                                                Math.min(text.getSpanEnd(chip) + 1, text.length());
3186                                        text.removeSpan(chip);
3187                                        // Make sure we always have just 1 space at the end to
3188                                        // separate this chip from the next chip.
3189                                        final SpannableString displayText =
3190                                                new SpannableString(createAddressText(
3191                                                        replacement.getEntry()).trim() + " ");
3192                                        displayText.setSpan(replacement, 0,
3193                                                displayText.length() - 1,
3194                                                Spanned.SPAN_EXCLUSIVE_EXCLUSIVE);
3195                                        // Replace the old text we found with with the new display
3196                                        // text, which now may also contain the display name of the
3197                                        // recipient.
3198                                        text.replace(start, end, displayText);
3199                                        replacement.setOriginalText(displayText.toString());
3200                                        replacements.set(i, null);
3201
3202                                        recipients.set(i, replacement);
3203                                    }
3204                                }
3205                            }
3206                            i++;
3207                        }
3208                        setText(text);
3209                    }
3210                };
3211
3212                if (Looper.myLooper() == Looper.getMainLooper()) {
3213                    runnable.run();
3214                } else {
3215                    mHandler.post(runnable);
3216                }
3217            }
3218        }
3219    }
3220
3221    private class IndividualReplacementTask
3222            extends AsyncTask<ArrayList<DrawableRecipientChip>, Void, Void> {
3223        @Override
3224        protected Void doInBackground(ArrayList<DrawableRecipientChip>... params) {
3225            // For each chip in the list, look up the matching contact.
3226            // If there is a match, replace that chip with the matching
3227            // chip.
3228            final ArrayList<DrawableRecipientChip> originalRecipients = params[0];
3229            ArrayList<String> addresses = new ArrayList<String>();
3230            for (DrawableRecipientChip chip : originalRecipients) {
3231                if (chip != null) {
3232                    addresses.add(createAddressText(chip.getEntry()));
3233                }
3234            }
3235            final BaseRecipientAdapter adapter = getAdapter();
3236            adapter.getMatchingRecipients(addresses, new RecipientMatchCallback() {
3237
3238                        @Override
3239                        public void matchesFound(Map<String, RecipientEntry> entries) {
3240                            for (final DrawableRecipientChip temp : originalRecipients) {
3241                                if (RecipientEntry.isCreatedRecipient(temp.getEntry()
3242                                        .getContactId())
3243                                        && getSpannable().getSpanStart(temp) != -1) {
3244                                    // Replace this.
3245                                    final RecipientEntry entry = createValidatedEntry(entries
3246                                            .get(tokenizeAddress(temp.getEntry().getDestination())
3247                                                    .toLowerCase()));
3248                                    if (entry != null) {
3249                                        mHandler.post(new Runnable() {
3250                                            @Override
3251                                            public void run() {
3252                                                replaceChip(temp, entry);
3253                                            }
3254                                        });
3255                                    }
3256                                }
3257                            }
3258                        }
3259
3260                        @Override
3261                        public void matchesNotFound(final Set<String> unfoundAddresses) {
3262                            // No action required
3263                        }
3264                    });
3265            return null;
3266        }
3267    }
3268
3269
3270    /**
3271     * MoreImageSpan is a simple class created for tracking the existence of a
3272     * more chip across activity restarts/
3273     */
3274    private class MoreImageSpan extends ReplacementDrawableSpan {
3275        public MoreImageSpan(Drawable b) {
3276            super(b);
3277            setExtraMargin(mLineSpacingExtra);
3278        }
3279    }
3280
3281    @Override
3282    public boolean onDown(MotionEvent e) {
3283        return false;
3284    }
3285
3286    @Override
3287    public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX, float velocityY) {
3288        // Do nothing.
3289        return false;
3290    }
3291
3292    @Override
3293    public void onLongPress(MotionEvent event) {
3294        if (mSelectedChip != null) {
3295            return;
3296        }
3297        float x = event.getX();
3298        float y = event.getY();
3299        final int offset = putOffsetInRange(x, y);
3300        DrawableRecipientChip currentChip = findChip(offset);
3301        if (currentChip != null) {
3302            if (mDragEnabled) {
3303                // Start drag-and-drop for the selected chip.
3304                startDrag(currentChip);
3305            } else {
3306                // Copy the selected chip email address.
3307                showCopyDialog(currentChip.getEntry().getDestination());
3308            }
3309        }
3310    }
3311
3312    // The following methods are used to provide some functionality on older versions of Android
3313    // These methods were copied out of JB MR2's TextView
3314    /////////////////////////////////////////////////
3315    private int supportGetOffsetForPosition(float x, float y) {
3316        if (getLayout() == null) return -1;
3317        final int line = supportGetLineAtCoordinate(y);
3318        return supportGetOffsetAtCoordinate(line, x);
3319    }
3320
3321    private float supportConvertToLocalHorizontalCoordinate(float x) {
3322        x -= getTotalPaddingLeft();
3323        // Clamp the position to inside of the view.
3324        x = Math.max(0.0f, x);
3325        x = Math.min(getWidth() - getTotalPaddingRight() - 1, x);
3326        x += getScrollX();
3327        return x;
3328    }
3329
3330    private int supportGetLineAtCoordinate(float y) {
3331        y -= getTotalPaddingLeft();
3332        // Clamp the position to inside of the view.
3333        y = Math.max(0.0f, y);
3334        y = Math.min(getHeight() - getTotalPaddingBottom() - 1, y);
3335        y += getScrollY();
3336        return getLayout().getLineForVertical((int) y);
3337    }
3338
3339    private int supportGetOffsetAtCoordinate(int line, float x) {
3340        x = supportConvertToLocalHorizontalCoordinate(x);
3341        return getLayout().getOffsetForHorizontal(line, x);
3342    }
3343    /////////////////////////////////////////////////
3344
3345    /**
3346     * Enables drag-and-drop for chips.
3347     */
3348    public void enableDrag() {
3349        mDragEnabled = true;
3350    }
3351
3352    /**
3353     * Starts drag-and-drop for the selected chip.
3354     */
3355    private void startDrag(DrawableRecipientChip currentChip) {
3356        String address = currentChip.getEntry().getDestination();
3357        ClipData data = ClipData.newPlainText(address, address + COMMIT_CHAR_COMMA);
3358
3359        // Start drag mode.
3360        startDrag(data, new RecipientChipShadow(currentChip), null, 0);
3361
3362        // Remove the current chip, so drag-and-drop will result in a move.
3363        // TODO (phamm): consider readd this chip if it's dropped outside a target.
3364        removeChip(currentChip);
3365    }
3366
3367    /**
3368     * Handles drag event.
3369     */
3370    @Override
3371    public boolean onDragEvent(@NonNull DragEvent event) {
3372        switch (event.getAction()) {
3373            case DragEvent.ACTION_DRAG_STARTED:
3374                // Only handle plain text drag and drop.
3375                return event.getClipDescription().hasMimeType(ClipDescription.MIMETYPE_TEXT_PLAIN);
3376            case DragEvent.ACTION_DRAG_ENTERED:
3377                requestFocus();
3378                return true;
3379            case DragEvent.ACTION_DROP:
3380                handlePasteClip(event.getClipData());
3381                return true;
3382        }
3383        return false;
3384    }
3385
3386    /**
3387     * Drag shadow for a {@link DrawableRecipientChip}.
3388     */
3389    private final class RecipientChipShadow extends DragShadowBuilder {
3390        private final DrawableRecipientChip mChip;
3391
3392        public RecipientChipShadow(DrawableRecipientChip chip) {
3393            mChip = chip;
3394        }
3395
3396        @Override
3397        public void onProvideShadowMetrics(@NonNull Point shadowSize,
3398                @NonNull Point shadowTouchPoint) {
3399            Rect rect = mChip.getBounds();
3400            shadowSize.set(rect.width(), rect.height());
3401            shadowTouchPoint.set(rect.centerX(), rect.centerY());
3402        }
3403
3404        @Override
3405        public void onDrawShadow(@NonNull Canvas canvas) {
3406            mChip.draw(canvas);
3407        }
3408    }
3409
3410    private void showCopyDialog(final String address) {
3411        final Context context = getContext();
3412        if (!mAttachedToWindow || context == null || !(context instanceof Activity)) {
3413            return;
3414        }
3415
3416        final DialogFragment fragment = CopyDialog.newInstance(address);
3417        fragment.show(((Activity) context).getFragmentManager(), CopyDialog.TAG);
3418    }
3419
3420    @Override
3421    public boolean onScroll(MotionEvent e1, MotionEvent e2, float distanceX, float distanceY) {
3422        // Do nothing.
3423        return false;
3424    }
3425
3426    @Override
3427    public void onShowPress(MotionEvent e) {
3428        // Do nothing.
3429    }
3430
3431    @Override
3432    public boolean onSingleTapUp(MotionEvent e) {
3433        // Do nothing.
3434        return false;
3435    }
3436
3437    protected boolean isPhoneQuery() {
3438        return getAdapter() != null
3439                && getAdapter().getQueryType() == BaseRecipientAdapter.QUERY_TYPE_PHONE;
3440    }
3441
3442    @Override
3443    public BaseRecipientAdapter getAdapter() {
3444        return (BaseRecipientAdapter) super.getAdapter();
3445    }
3446
3447    /**
3448     * Append a new {@link RecipientEntry} to the end of the recipient chips, leaving any
3449     * unfinished text at the end.
3450     */
3451    public void appendRecipientEntry(final RecipientEntry entry) {
3452        clearComposingText();
3453
3454        final Editable editable = getText();
3455        int chipInsertionPoint = 0;
3456
3457        // Find the end of last chip and see if there's any unchipified text.
3458        final DrawableRecipientChip[] recips = getSortedRecipients();
3459        if (recips != null && recips.length > 0) {
3460            final DrawableRecipientChip last = recips[recips.length - 1];
3461            // The chip will be inserted at the end of last chip + 1. All the unfinished text after
3462            // the insertion point will be kept untouched.
3463            chipInsertionPoint = editable.getSpanEnd(last) + 1;
3464        }
3465
3466        final CharSequence chip = createChip(entry);
3467        if (chip != null) {
3468            editable.insert(chipInsertionPoint, chip);
3469        }
3470    }
3471
3472    /**
3473     * Remove all chips matching the given RecipientEntry.
3474     */
3475    public void removeRecipientEntry(final RecipientEntry entry) {
3476        final DrawableRecipientChip[] recips = getText()
3477                .getSpans(0, getText().length(), DrawableRecipientChip.class);
3478
3479        for (final DrawableRecipientChip recipient : recips) {
3480            final RecipientEntry existingEntry = recipient.getEntry();
3481            if (existingEntry != null && existingEntry.isValid() &&
3482                    existingEntry.isSamePerson(entry)) {
3483                removeChip(recipient);
3484            }
3485        }
3486    }
3487
3488    public void setAlternatePopupAnchor(View v) {
3489        mAlternatePopupAnchor = v;
3490    }
3491
3492    @Override
3493    public void setVisibility(int visibility) {
3494        super.setVisibility(visibility);
3495
3496        if (visibility != GONE && mRequiresShrinkWhenNotGone) {
3497            mRequiresShrinkWhenNotGone = false;
3498            mHandler.post(mDelayedShrink);
3499        }
3500    }
3501
3502    private static class ChipBitmapContainer {
3503        Bitmap bitmap;
3504        // information used for positioning the loaded icon
3505        boolean loadIcon = true;
3506        float left;
3507        float top;
3508        float right;
3509        float bottom;
3510        // information used for positioning the warning icon
3511        float warningIconLeft;
3512        float warningIconTop;
3513        float warningIconRight;
3514        float warningIconBottom;
3515    }
3516}
3517