Android Layout：getLineBaseline、getLineDescent、getLineAscent、getLineBottom、getLineTop的含义

Question

出于以下几个方法的文档Layout（包括StaticLayout，DynamicLayout，和BoringLayout）非常sparce。

• getLineBaseline(int line)
• getLineDescent(int line)
• getLineAscent(int line)
• getLineBottom(int line)
• getLineTop(int line)

这些方法返回的数字究竟是多少？它们是正常的字体度量值还是布局上的位置？

我做了一个测试项目来找出答案，所以我在问答风格下面发布了我的答案。

Answer 1

之前我已经在Android的FontMetrics中描述了top、ascent、baseline、descent、bottom和leading的含义。

因为Layout方法getLineBaseline、getLineDescent、getLineAscent、getLineBottom和getLineTop听起来与FontMetrics名称非常相似，所以很容易将它们混淆。但是，他们报告了两种不同类型的事情：

这些方法返回它们在 layout 上的垂直位置，每行都不同。

• getLineBaseline
• getLineBottom
• getLineTop

但是，以下两种方法返回它们所在的特定行的值，而不管该行在布局中的位置。因此，除非有影响大小的特殊跨度，否则它们对于每一行都是相同的。

• getLineAscent
• getLineDescent

演示

我做了一个简单的项目来演示上面的信息。有六行文本EditText。单击该按钮会记录每行的信息。

结果

这是记录的结果：

line 0 baseline: 67
line 1 baseline: 140
line 2 baseline: 213
line 3 baseline: 286
line 4 baseline: 359
line 5 baseline: 432

line 0 descent: 15
line 1 descent: 15
line 2 descent: 15
line 3 descent: 15
line 4 descent: 15
line 5 descent: 18

line 0 ascent: -67
line 1 ascent: -58
line 2 ascent: -58
line 3 ascent: -58
line 4 ascent: -58
line 5 ascent: -58

line 0 top: 0
line 1 top: 82
line 2 top: 155
line 3 top: 228
line 4 top: 301
line 5 top: 374

line 0 bottom: 82
line 1 bottom: 155
line 2 bottom: 228
line 3 bottom: 301
line 4 bottom: 374
line 5 bottom: 450

FontMetrics top: -67
FontMetrics bottom: 18
FontMetrics ascent: -58
FontMetrics descent: 15

如您所见，顶部、底部和基线是基于线累积的。每条线路的上升和下降主要保持不变。FontMetrics.ascent对于除第一行以外的所有行，上升等于，其中它等于FontMetrics.top。FontMetrics.descent除了最后一行之外的所有行的下降都等于FontMetrics.bottom。

因此，一条线的顶部、底部、基线、上升和下降不应被视为等于FontMetrics相同名称的值。在线上升是从基线到其上方线底部的距离。下降是从基线到下一行顶部的距离。

在源代码中，每行只保存top和descent。其他值是从它们计算出来的：

• 底部 = 下一行的顶部
• 基线 = 底部 - 下降
• 上升 = 顶部 - （底部 - 下降）

项目代码：

public class MainActivity extends AppCompatActivity {

    EditText editText;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        editText = (EditText) findViewById(R.id.editText);
    }

    public void buttonClick(View view) {

        Layout layout = editText.getLayout();
        for (int i = 0; i < layout.getLineCount(); i++) {
            int baseline = layout.getLineBaseline(i);
            Log.i("TAG", "line " + i + " baseline: " + baseline);
        }
        for (int i = 0; i < layout.getLineCount(); i++) {
            int descent = layout.getLineDescent(i);
            Log.i("TAG", "line " + i + " descent: " + descent);
        }
        for (int i = 0; i < layout.getLineCount(); i++) {
            int ascent = layout.getLineAscent(i);
            Log.i("TAG", "line " + i + " ascent: " + ascent);
        }
        for (int i = 0; i < layout.getLineCount(); i++) {
            int top = layout.getLineTop(i);
            Log.i("TAG", "line " + i + " top: " + top);
        }
        for (int i = 0; i < layout.getLineCount(); i++) {
            int bottom = layout.getLineBottom(i);
            Log.i("TAG", "line " + i + " bottom: " + bottom);
        }

        Paint.FontMetricsInt fm = editText.getLayout().getPaint().getFontMetricsInt();
        Log.i("TAG", "fm top: " + fm.top);
        Log.i("TAG", "fm bottom: " + fm.bottom);
        Log.i("TAG", "fm ascent: " + fm.ascent);
        Log.i("TAG", "fm descent: " + fm.descent);
    }
}

也可以看看

• Layout 文件
• Layout.java 源代码
• StaticLayout.java 源代码