android源码追踪学习 RecipientsEditor

RecipientsEditor 新建短信时输入收接者的editor，

1. public class RecipientsEditor extends MultiAutoCompleteTextView {
2. private int mLongPressedPosition = -1;
3. private final RecipientsEditorTokenizer mTokenizer;
4. private char mLastSeparator = ',';
5. public RecipientsEditor(Context context, AttributeSet attrs) {
6. super(context, attrs, android.R.attr.autoCompleteTextViewStyle);
7. mTokenizer = new RecipientsEditorTokenizer(context, this);
8. setTokenizer(mTokenizer);
9. // For the focus to move to the message body when soft Next is pressed
10. setImeOptions(EditorInfo.IME_ACTION_NEXT);
11. // Set threshold as 1 CharSequence.
12. setThreshold(1);
13. addTextChangedListener(new TextWatcher() {
14. private Annotation[] mAffected;
15. public void beforeTextChanged(CharSequence s, int start,
16. int count, int after) {
17. mAffected = ((Spanned) s).getSpans(start, start + count,
18. Annotation.class);
19. }
20. public void onTextChanged(CharSequence s, int start,
21. int before, int after) {
22. if (before == 0 && after == 1) {    // inserting a character
23. char c = s.charAt(start);
24. if (c == ',' || c == ';') {
25. // Remember the delimiter the user typed to end this recipient. We'll
26. // need it shortly in terminateToken().
27. mLastSeparator = c;
28. }
29. }
30. }
31. public void afterTextChanged(Editable s) {
32. if (mAffected != null) {
33. for (Annotation a : mAffected) {
34. s.removeSpan(a);
35. }
36. }
37. mAffected = null;
38. }
39. });
40. }

RecipientsEditor 继承于 MultiAutoCompleteTextView

可支持输入多个手机号码，每个手机号码用用分隔符分开，有自动完成功能，预置匹配的数据为联系人；

其中RecipientsEditorTokenizer为了找出输入字符串中的分隔符","和“，”

1. private class RecipientsEditorTokenizer
2. implements MultiAutoCompleteTextView.Tokenizer {
3. private final MultiAutoCompleteTextView mList;
4. private final Context mContext;
5. RecipientsEditorTokenizer(Context context, MultiAutoCompleteTextView list) {
6. mList = list;
7. mContext = context;
8. }
9. public int findTokenStart(CharSequence text, int cursor) {
10. int i = cursor;
11. char c;
12. while (i > 0 && (c = text.charAt(i - 1)) != ',' && c != ';') {
13. i--;
14. }
15. while (i < cursor && text.charAt(i) == ' ') {
16. i++;
17. }
18. return i;
19. }
20. public int findTokenEnd(CharSequence text, int cursor) {
21. int i = cursor;
22. int len = text.length();
23. char c;
24. while (i < len) {
25. if ((c = text.charAt(i)) == ',' || c == ';') {
26. return i;
27. } else {
28. i++;
29. }
30. }
31. return len;
32. }
33. public CharSequence terminateToken(CharSequence text) {
34. int i = text.length();
35. while (i > 0 && text.charAt(i - 1) == ' ') {
36. i--;
37. }
38. char c;
39. if (i > 0 && ((c = text.charAt(i - 1)) == ',' || c == ';')) {
40. return text;
41. } else {
42. // Use the same delimiter the user just typed.
43. // This lets them have a mixture of commas and semicolons in their list.
44. String separator = mLastSeparator + " ";
45. if (text instanceof Spanned) {
46. SpannableString sp = new SpannableString(text + separator);
47. TextUtils.copySpansFrom((Spanned) text, 0, text.length(),
48. Object.class, sp, 0);
49. return sp;
50. } else {
51. return text + separator;
52. }
53. }
54. }

setImeOptions(EditorInfo.IME_ACTION_NEXT);//设置软键盘右下角的button的功能为下一个，即切换到下一个输入框，如果设置成EditorInfo.IME_ACTION_DONE，则表示输入完成，关掉软键盘，还有很多其他的选项可供设置的

setThreshold(1);// Threshold门槛的意思，此处设置只要输入一个字符就开始匹配，若设置为“2”则表示要输入两个字符才是匹配。

addTextChangedListener(TextWatcher);//添加一个TextView监听器

TextWatcher里有三个回调方法，当有输入框里的字符有变化时会自动依次调用以下三个方法：

beforeTextChanged(CharSequence s, int start,int count, int after) ；

//此处已输入为例解释上面各变量的意思，s 是输入以前的字符串，start光标所在的位置， count为要改变的字符个数，即选中的个数，after为要插入的个数

onTextChanged(CharSequence s, int start, int before, int after)

//s为改变后的字符串，start和上面的start一样， before和上面的count一样，after与上面的after一样

afterTextChanged(Editable s)// s为改变后的字符串

预制匹配数据为联系人的方法是通过设置适配器：

1. mRecipientsEditor.setAdapter(new RecipientsAdapter(this));

RecipientsAdapter 是extends ResourceCursorAdapter的

在适配器里面通过Phone.CONTENT_FILTER_URI，获取电话本里的信息。