从SetText()中学andorid（一）

settext()的流程

参数设置

charsequence类型的text
buffertype,这是一个枚举类型，含有三种类型 NORMAL, SPANNABLE, EDITABLE

• EDITABLE**类型类似StringBuilder，可以追加字符，例如，可以在getText后用append追加字符
• SPANNABLE**则可在给定的字符区域使用样式
• EDITABLE继承自SPANNABLE**，拥有更多的功能。

boolean类型的notifyBefore 字面上理解为通知之前，暂不表

 private void setText(CharSequence text, BufferType type, boolean notifyBefore, int oldlen){  
//判断是否为null，如为null，置为"" 
    if (text == null) { 
      text = ""; 
    }

从text中删除被屏蔽的字符

 if (!isSuggestionsEnabled()) {
    //返回是否建议对这个textview的启用 
     text = removeSuggestionSpans(text); 
 } 

removeSuggestionSpans

removeSuggestionSpans返回一个CharSequence类型的对象
CharSequence与String都能用于定义字符串，但CharSequence的值是可读可写序列，而String的值是只读序列。

span是android提出的概念。无论是textview还是edittext显示的其实是文本，而span则是附在文本上的对象，而展示的时候，展示的其实是这些附着的对象，而不是文本本身。继承结构是CharSequence->Spanned->Spannable->SpannableString，前三个都是接口类型，最后一个则是实现类。

CharSequence removeSuggestionSpans(CharSequence text) { 
//判断text是否为Spanned的实例，如 
if (text instanceof Spanned) { 
  Spannable spannable; 
 //判断传入的text是否是Spannable的实例，如果是，则向下转型到Spannable，否则利用SpannableString的构造函数来得到一个spannable的实现类 
if (text instanceof Spannable) {
   spannable = (Spannable) text;
  //向下转型 
} else {
 //传入spanned类型的参数，得到一个SpannableString 
  spannable = new SpannableString(text); 
  text = spannable; 
} 
//获得一个含有标记对象的数组（这个数组内含有所有非法字符，如，我们不希望在textview中有‘的’这个字，然后我们将它添加到SuggestionSpan中，在运行下面这个For循环的时候，就会将spannable中所有‘的’这个字移除
 SuggestionSpan[] spans = spannable.getSpans(0, text.length(), SuggestionSpan.class);
 for (int i = 0; i < spans.length; i++) {
    spannable.removeSpan(spans[i]);
 }
} 
//在最后返回charSequence类型的对象
 return text;
 }

如果用户没有自行设置文本宽度，则将其设置为1.0f，1.0f是文本水平比例因子，默认值为1.0f，当大于1.0f的时候，文本会被拉宽，反之，文本会被缩窄

if (!mUserSetTextScaleX)
  mTextPaint.setTextScaleX(1.0f);

当text是Spanned的一个实例，才能向下转型为Spanned类型，然后调用Spanned的getSpanStart方法。
getSpanStart返回的是指定的附着的对象。如果对象未附加文本的范围的开头则返回-1

if (text instanceof Spanned && ((Spanned)text).getSpanStart(TextUtils.TruncateAt.MARQUEE) >= 0) {
  //此时已经确定该text中有附着的对象
 if (ViewConfiguration.get(mContext).isFadingMarqueeEnabled()) {
    //通过ViewConfiguration的get方法来获得上下文对应的
    //isFadingMarqueeEnabled是被google隐藏的函数，是厂商编译framework产生的，用来返回是否用阴影来遮盖文字边缘
      setHorizontalFadingEdgeEnabled(true); 
    //横向使用阴影来遮盖边缘
      mMarqueeFadeMode = MARQUEE_FADE_NORMAL; 
    //遮盖模式修改为通常的遮盖
 } else {
     setHorizontalFadingEdgeEnabled(false);
 //不使用横向阴影来遮盖边缘
     mMarqueeFadeMode = MARQUEE_FADE_SWITCH_SHOW_ELLIPSIS;
 //遮盖模式为选择省略遮盖
 }
setEllipsize(TextUtils.TruncateAt.MARQUEE);  }

setEllipsize

解释一下setEllipsize

setEllipsize.png

这个方法的大致意思就是：在textview中被设置的text长度比这个textview的宽，或者设置了maxlines即最大行数，但是实际的text超出了最大行数，此时多出来的部分就会被省略，在得知这个函数是用来干什么后，我们来阅读一下代码

public void setEllipsize(TextUtils.TruncateAt where) {
 // TruncateAt is an enum. != comparison is ok between these singleton objects.
   if (mEllipsize != where) {
      mEllipsize = where; 
      if (mLayout != null) { 
          nullLayouts(); 
          requestLayout(); 
          invalidate();
      }
   }
}

首先，TruncateAt是一个枚举类型，意思是从什么地方截断，而其中一共五种：

• START 开头省略
• STARTMIDDLE 中间省略
• END 末尾省略
• MARQUEE 不省略，跑马灯效果
  在使用时这样即可
  android:ellipsize = "marquee"
  android:singleLine = "true"
  android:textIsSelectable="true"

跑马灯效果图

如果当前的类型和要被设置的类型不一致，并且layout不为null，执行三个函数

• nulllayouts();
• requestLayout();
• invalidate();

textview#nulllayouts()

这个方法是将layout都置为null，并且将之前的layout及hintLayout备份起来

private void nullLayouts() {
  if (mLayout instanceof BoringLayout && mSavedLayout == null) {
      mSavedLayout = (BoringLayout) mLayout;
  }
  if (mHintLayout instanceof BoringLayout && mSavedHintLayout == null) {
      mSavedHintLayout = (BoringLayout) mHintLayout;
  }
  mSavedMarqueeModeLayout = mLayout = mHintLayout = null;
  mBoring = mHintBoring = null;
  // Since it depends on the value of mLayout
  if (mEditor != null)
     mEditor.prepareCursorControllers();
    //下面我们介绍一下Editor
 }

Editor#prepareCursorControllers()

Editor 根据google官方的注释来看，它是一个帮助textview来掌控可编辑的text的view的隐藏类，当Editor中的文件被使用的情况才会被创建，

void prepareCursorControllers() {
    boolean windowSupportsHandles = false;//window是否支持
    ViewGroup.LayoutParams params = mTextView.getRootView().getLayoutParams();
    if (params instanceof WindowManager.LayoutParams) {
          WindowManager.LayoutParams windowParams =(WindowManager.LayoutParams) params;

这里将ViewGroup的LayoutParams强制转换成了WindowManager的LayoutParams，翻阅源码可知，WindowManager是一个接口，内部写了一个LayoutParams的内部类，继承了ViewGroup（抽象类）的LayoutParams。

WINDOWMANAGER

子窗口的开始，做过浮窗的同学应该都知道，浮窗的本质就是将View交由WindowManager来管理，LayoutParams.type类型决定了这个显示窗口的类型，不同层次的窗口的窗口层次是不同的，大致分为应用窗口(APPLICATION_WINDOW)、子窗口（SUB_WINDOW）还有系统窗口（SYSTEM_WINDOW）三种

• 应用窗口的Z轴范围：1~99
• 子窗口的Z轴范围：1001~1999
• 系统窗口的Z轴范围：2000~2999

此时，阅读下面代码可知

windowSupportsHandles = windowParams.type < WindowManager.LayoutParams.FIRST_SUB_WINDOW || windowParams.type > WindowManager.LayoutParams.LAST_SUB_WINDOW;
 //这些代码通过type的值来规避了是子窗口的可能性（可能是因为子窗口是不可管理的）
}
boolean enabled = windowSupportsHandles && mTextView.getLayout() != null;
//@link Editor#isCursorVisible()
mInsertionControllerEnabled = enabled && isCursorVisible();
//插入调度器是否启用（和光标是否显示有关）
//@link textview#textCanBeSelected(); 
//选择调度器是否启用(与长按选择有关)
mSelectionControllerEnabled = enabled && mTextView.textCanBeSelected();

关于调度器，我会在从SetText()中学andorid（二）中描述。
end