Android自定义控件：自适应大小的文本控件

---

需求

自适应大小的文本：
效果图：

项目开发中，开发人员根据ui人员提供的一套尺寸，布局了一些带文本的页面，
往往会少考虑一些数据极限的问题，造成机型屏幕适配问题。
例如：
文本（或数值）长度可变，如经验值、金币数量等，如果页面同一高度使用了多个textview布局摆放，当textview文本长度增加时，有可能造成重叠现象。

例子还有很多，相信很多开发人员也都曾遇到过。
今天我们就写一个简单的例子，解决该问题。

我们项目中的实际需求：

1. 文本控件单行、居中显示；
2. 文本控件默认有一个固定尺寸，如果文本过多，字号自动变小，文本仍然完全显示，不折行；
3. 文本控件尺寸变小，文本不变，字号也自动变小，文本仍然完全显示，不折行；

其实2和3仔细分析一下是一个意思：
文本控件的空间不够存放当前文本时，字号自动缩小。

---

分析

一般的情况，很多开发者做法是继承textview，控制其属性以达到效果。

我们换一种做法。
textview文本说到底，就是一个view，而我们看到的文本，其实是通过画笔绘制在view空间（即：画布）上的。
那么我们也使用这种方式，画笔来实现吧。

可能有开发者会担心很难，其实一点也不难，只需要简单掌握几个基础知识（1. 画布、2. 画笔、3. 文本绘制的计算）就可以了。
我们自定义出来的控件代码，不会比直接继承textview多，而且大家还能学到更多有用的知识。

那么我们开始分析：
如何在一定的空间中自适应文本的大小，使其能完全显示？
原理很简单，就是把字号变小就行了，那么变成多小？如何计算呢？

1. 我们要实现的控件，只是一个文本显示，界面不复杂，所以我们不需要使用xml，只写一个自定义类即可；
2. 自定义类直接继承view；
3. view中可获得的或者外界传入的信息（即：已知条件）：
    3.1 文本信息text（外界传入）
    3.2 字号最大值maxsize（外界传入， 即，我们设置的默认字号，因为字号只会缩小，不会增加，所以也叫字号最大值）
    3.3 文本使用字号最大值应显示的宽度prewidth（可通过paint、text、maxsize获得）
    3.4 空间的宽度canvaswidth（即画布宽度，可在view的onsizechanged方法中获得）；
   
    那么，当空间不足以显示文本时，应通过已知条件计算canvaswidth应对应的字号大小 x，
    如何计算呢？
    经过分析，大字体显示的宽度与小字体显示的宽度比值应是一致的，所以，公式如下：
    maxsize / prewidth = x / canvaswidth;   
    x = maxsize * canvaswidth / prewidth;
    x 就是我们需要重新设置的字号。
    得到字号，我们就可以为画笔设置文字大小了，也就可以通过画笔画出合适大小的文字了。

4. 绘制文本，文本的坐标如何处理呢？
    此处我们以居中显示为例：
    我们可以通过文本宽高与画布宽高可计算出文字应被绘制的位置（x,y）
    例如：
    容器（即画布）宽10，高10，文字宽4，高4，我们把容器和文字分别想象成两个矩形，
    如何使文字矩形居中显示在容器矩形里，需要我们算出文字矩形左上角的位置（x,y），即文字绘制的位置，
    其实也很简单：
    x = （容器宽 - 文字宽）/ 2 = 1(0 - 4) / 3 = 3
    y = (容器高 - 文字高 ) / 2 = 3

    如果我们直接使用这个（x,y）直接绘制文本，得到的结果是文字位置向上偏移了，这不是我们想要的结果。
    其实，文本绘制是根据基线（baseline）来绘制的，我们还需要了解文本绘制时的结构计算。
    （文本如何绘制，下面会有介绍）

好了，基础知识点分析完了，我们先熟悉一下这些基础吧！
***

绘图基础

本章介绍的基础知识仅介绍当前需要用到的，不会特别细致，如果有需要，请自行查询资料。
1.canvas 画布、paint画笔
我们看到的控件上的内容，其实是绘制在画布上的，而绘制是使用的画笔工具。
画布有很多方法，如：画文本、圆、矩形、线、路径、图片等；

canvas（画布）提供的画文本的方法：
    public void drawtext(char[] text, int index, int count, float x, float y, paint paint) {
        throw new runtimeexception("stub!");
    }

    public void drawtext(string text, float x, float y, paint paint) {
        throw new runtimeexception("stub!");
    }

    public void drawtext(string text, int start, int end, float x, float y, paint paint) {
        throw new runtimeexception("stub!");
    }

    public void drawtext(charsequence text, int start, int end, float x, float y, paint paint) {
        throw new runtimeexception("stub!");
    }

画笔可以设置我们想要的效果，如颜色、字体、字号、线粗细等；

paint（画笔）设置文本属性的一些主要方法：
    //设置文本大小
    public void settextsize(float textsize) {
        throw new runtimeexception("stub!");
    }
    //设置颜色
    public void setcolor(int color) {
        throw new runtimeexception("stub!");
    }
    //设置文本间距
    public void setletterspacing(float letterspacing) {
        throw new runtimeexception("stub!");
    }
    //设置文本对齐方式
    public void settextalign(paint.align align) {
        throw new runtimeexception("stub!");
    }
   //设置文本文字类型：如：宋体、黑体、平方等字体
    public typeface settypeface(typeface typeface) {
        throw new runtimeexception("stub!");
    }
    //计算文本宽度（根据设置的字号大小，要绘制的文本内容，计算并返回该文本应占用的宽度）
    public float measuretext(string text) {
        throw new runtimeexception("stub!");
    }
    ...
    还有很多设置文本的方法，可以自行查找！！！

具体，可参考这篇文章：
https://www.jianshu.com/p/f69873371763
https://blog.csdn.net/ttjay000/article/details/73876973

2.文本绘制
想把文字精准的绘制到屏幕上，
需要了解字体测量类：fontmetrics，以及该类的top,ascent,descent,bottom,leading五个成员变量；

如果我们想在画布的最左上角（即（0,0）位置）开始绘制文本，绘制完成后，我们看到的是如上图所示的baseline以下的部分，而上面的部分我们是看不到的。

原因很简单，文本的绘制，是基于baseline的，如果我们直接设置绘制的位置是（0,0），即 baseline的位置是（0,0），如上图所示，baseline以上的文本肯定被绘制在控件上面去了，即y为负数，所以我们看不到baseline以上的内容。

那么，我们应该如何做才能将文字绘制在我们想要的位置呢，其实很简单，我们只需要让baseline的位置向下偏移就可以了，但是偏移多少呢？
再看上图，我们只需要拿到文本的上面的几个属性（ascent等），就可以算出来了。

具体可参考这篇文章：
https://www.cnblogs.com/tianzhijiexian/p/4297664.html

---

代码实现

自定义控件类：autotextview

package iwangzhe.customautosizetextview;
import android.content.context;
import android.graphics.canvas;
import android.graphics.paint;
import android.util.attributeset;
import android.view.view;
import android.widget.textview;

/**
 * 类：autotextview
 * 作者： qxc
 * 日期：2018/4/3.
 */
public class autotextview extends view {
    private context context;//上下文
    private int canvaswidth;//画布宽度
    private int canvasheight;//画布高度
    private paint paint;//画笔

    private int maxtextsize = 50;//外界传入的默认字号（最大字号），单位sp，如果不传入，我们默认50sp，大家可自行修改
    private string text = "";//外界传入的文本内容
    public autotextview(context context) {
        super(context);
        this.context = context;
        initpaint();//初始化画笔属性
    }

    public autotextview(context context, attributeset attrs) {
        super(context, attrs);
        this.context = context;
        initpaint();//初始化画笔属性
    }

    //初始化画笔属性
    private void initpaint(){
        //设置防锯齿
        paint = new paint(paint.anti_alias_flag);
        //设置画笔宽度
        paint.setstrokewidth(1);
    }

    /**
     * 设置文本（供外界调用）
     * @param text 文本
     */
    public autotextview settext(string text){
        this.text = text;
        return this;
    }

    /**
     * 设置支持的最大文本字号（供外界调用）
     * @param size 文本字号
     */
    public autotextview setmaxtextsize(int size){
        this.maxtextsize = size;
        return this;
    }

    @override
    protected void onsizechanged(int w, int h, int oldw, int oldh) {
        super.onsizechanged(w, h, oldw, oldh);
        //每一次外观变化，都会调用该方法
        this.canvaswidth = getwidth();//获得画布宽度
        this.canvasheight = getheight();//获得画布高度
    }

    @override
    protected void ondraw(canvas canvas) {
        //每次重绘，绘制传递进来的文本信息
        drawtext(canvas);
    }

    //绘制文本
    private void drawtext(canvas canvas){
        //根据画布宽度，获得合适的字号（即：刚好能显示满当前宽度的字号，与maxsize相比，只能小不能大）
        float textsize = getrightsize();
        //为画笔设置上合适的字号
        paint.settextsize(sp2px(textsize));

        // 计算baseline绘制的起点x轴坐标 ，计算方式：画布宽度的一半 - 文字宽度的一半
        int x = (int) (canvaswidth / 2 - paint.measuretext(text) / 2);

        //int x = 0;
        // 计算baseline绘制的y坐标 ，计算方式：画布高度的一半 - 文字总高度的一半
        int y = (int) ((canvasheight / 2) - ((paint.descent() + paint.ascent()) / 2));

        //绘制文本
        canvas.drawtext(text,x,y,paint);
    }

    //获得合适的字号
    private float getrightsize(){
        paint.settextsize(sp2px(maxtextsize));
        paint.settextalign(paint.align.left);
        //根据最大值，计算出当前文本占用的宽度
        float prewidth = paint.measuretext(text);
        //如果文本占用的宽度比画布宽度小，说明不用伸缩，直接返回当前字号
        if(prewidth<canvaswidth){
            return maxtextsize;
        }
        //已知当前文本字号、文本占用宽度、画布宽度，计算出合适的字号，并返回
        return maxtextsize*canvaswidth/prewidth;
    }
    
    //实际绘制时，需要使用像素进行绘制，此处提供sp 转 px的方法
    private int sp2px(float spvalue) {
        final float scale = context.getresources().getdisplaymetrics().density;
        return (int) (spvalue * scale + 0.5f);
    }
}

调用方类与布局文件：mainactivity
使用seekbar模拟文本控件宽度变化（即：容器大小变化）

<?xml version="1.0" encoding="utf-8"?>
<relativelayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/activity_main"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context="iwangzhe.customautosizetextview.mainactivity">

    <iwangzhe.customautosizetextview.autotextview
        android:layout_width="match_parent"
        android:background="#eeeeee"
        android:layout_height="50dp"
        android:layout_margintop="20dp"
        android:id="@+id/atv" />

    <seekbar
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_below="@+id/atv"
        android:layout_margintop="50dp"
        android:progress="100"
        android:id="@+id/sb" />
</relativelayout>

package iwangzhe.customautosizetextview;
import android.content.context;
import android.content.res.configuration;
import android.support.v7.app.appcompatactivity;
import android.os.bundle;
import android.widget.relativelayout;
import android.widget.seekbar;

public class mainactivity extends appcompatactivity {
    seekbar sb;
    autotextview atv;

    @override
    protected void oncreate(bundle savedinstancestate) {
        super.oncreate(savedinstancestate);
        setcontentview(r.layout.activity_main);

        initview();
        initevent();
    }

    void initview(){
        sb = (seekbar) findviewbyid(r.id.sb);
        sb.setprogress(100);
        atv = (autotextview) findviewbyid(r.id.atv);
        //设置测试数据
        atv.settext("一二三四五六七八九十").setmaxtextsize(50);
    }

    void initevent(){
        //使用seekbar模拟文本控件宽度变化（即：容器大小变化）
        sb.setonseekbarchangelistener(new seekbar.onseekbarchangelistener() {
            @override
            public void onprogresschanged(seekbar seekbar, int i, boolean b) {
                relativelayout.layoutparams linearparams = (relativelayout.layoutparams) atv.getlayoutparams();
                linearparams.height = dip2px(mainactivity.this, 50);
                linearparams.width = i * sb.getwidth()/100;
                atv.setlayoutparams(linearparams);
            }

            @override
            public void onstarttrackingtouch(seekbar seekbar) {

            }

            @override
            public void onstoptrackingtouch(seekbar seekbar) {

            }
        });
    }

    public static int dip2px(context context, float dpvalue) {
        final float scale = context.getresources().getdisplaymetrics().density;
        return (int) (dpvalue * scale + 0.5f);
    }
}

---

总结：
此控件使用起来，很简单，但是技术点很实用，以后做动态报表的自定义控件时，都会用到。
如果大家想要增加设置文本字体、加粗、下划线等样式，请参考该示例，自行扩展即可。
本文章，主要是为了让大家了解 使用画布画笔 自定义控件的过程，如果想在自己的项目中使用，请根据需要自行调整优化。

demo下载地址：
（为了减小demo大小，我删除了build下的文件，大家获取后rebuild一下代码，就可以了）
https://pan.baidu.com/s/1fu81a-efki_mptdkfls0ja