StaticLayout的使用详解

在Android开发中，Canvas.drawText不会换行，即使一个很长的字符串也只会显示一行，超出部分会隐藏在屏幕之外。
StaticLayout是android中处理文字的一个工具类，StaticLayout 处理了文字换行的问题。

在Staticlayout的中构造参数有三个：

 public StaticLayout(CharSequence source, TextPaint paint,
                        int width,
                        Alignment align, float spacingmult, float spacingadd,
                        boolean includepad) {
        this(source, 0, source.length(), paint, width, align,
             spacingmult, spacingadd, includepad);
    }

  public StaticLayout(CharSequence source, int bufstart, int bufend,
                        TextPaint paint, int outerwidth,
                        Alignment align,
                        float spacingmult, float spacingadd,
                        boolean includepad) {
        this(source, bufstart, bufend, paint, outerwidth, align,
             spacingmult, spacingadd, includepad, null, 0);
    }
  public StaticLayout(CharSequence source, int bufstart, int bufend,
            TextPaint paint, int outerwidth,
            Alignment align,
            float spacingmult, float spacingadd,
            boolean includepad,
            TextUtils.TruncateAt ellipsize, int ellipsizedWidth) {
        this(source, bufstart, bufend, paint, outerwidth, align,
                TextDirectionHeuristics.FIRSTSTRONG_LTR,
                spacingmult, spacingadd, includepad, ellipsize, ellipsizedWidth, Integer.MAX_VALUE);
    }

以下以其中一个构造函数作为说明：

	/**
	 * @param source    需要分行的字符串
	 * @param bufstart  需要分行的字符串从第几的位置开始
	 * @param bufend    需要分行的字符串到哪里结束
	 * @param paint     画笔对象
	 * @param outerwidth  layout的宽度，超出时换行
	 * @param align       layout的对其方式，有ALIGN_CENTER， ALIGN_NORMAL， ALIGN_OPPOSITE 三种
	 * @param spacingmult 相对行间距，1.5f表示行间距为1.5倍的字体高度行间距的倍数，通常情况下填 1 就好。
	 * @param spacingadd  行间距的额外增加值，通常情况下填 0 就好
	 * @param includepad  是否在文本上下添加额外的空间，来避免某些过高的字符的绘制出现越界
	 * @param ellipsize  从什么位置开始省略
	 * @param ellipsizedWidth   超过多少开始省略
	 */
	public test(CharSequence source, int bufstart, int bufend, TextPaint paint, int outerwidth, Alignment align,
			float spacingmult, float spacingadd, boolean includepad, TextUtils.TruncateAt ellipsize,
			int ellipsizedWidth) {
		this(source, bufstart, bufend, paint, outerwidth, align, TextDirectionHeuristics.FIRSTSTRONG_LTR, spacingmult,
				spacingadd, includepad, ellipsize, ellipsizedWidth, Integer.MAX_VALUE);
	}

参考如下使用实例：

public class StaticLayoutView extends View {
    StaticLayout staticLayout;
    
    public StaticLayoutView(Context context) {
        this(context, null);
    }

    public StaticLayoutView(Context context, @Nullable AttributeSet attrs) {
        this(context, attrs, 0);
    }
    public StaticLayoutView(Context context, @Nullable AttributeSet attrs, int defStyleAttr) {
        super(context, attrs, defStyleAttr);

    }


    @Override
    protected void onDraw(Canvas canvas) {
        super.onDraw(canvas);
        TextPaint textPaint=new TextPaint(Paint.ANTI_ALIAS_FLAG);
        textPaint.setColor(Color.RED);
        textPaint.setStyle(Paint.Style.FILL);
        textPaint.setTextSize(50);
        String text="在Android开发中，Canvas.drawText不会换行，即使一个很长的字符串也只会显示一行，超出部分会隐藏在屏幕之外.StaticLayout是android中处理文字的一个工具类，StaticLayout 处理了文字换行的问题";
        staticLayout=new StaticLayout(text, textPaint, canvas.getWidth(), Layout.Alignment.ALIGN_NORMAL, 1.0f,0.0f , false);
        staticLayout.draw(canvas);
    }
}

运行效果图：