【Android】通过 Paint 获取文本宽度、高度及行间距信息

Android 开发中，在自定义视图或绘制文本时，通过 Paint.FontMetrics 或 Paint.FontMetricsInt 来获取文本的高度，这些类提供了文本的度量信息，包括文本的顶部、底部、基线等位置。

1、FontMetrics 类

FontMetrics 是一个用于描述字体的度量信息的类。它提供了关于字体高度、行间距等的关键信息，这些信息对于精确控制文本的绘制和布局非常有用。

• ascent：从基线到文本顶部的距离，通常是负值，表示文本顶部在基线之上，表示文本的实际顶部边界。
• descent：从基线到文本底部的距离。通常是正值，表示文本底部在基线之下，表示文本的实际底部边界。
• top：从基线到字体顶部的距离。通常是负值，表示字体顶部在基线之上，表示字体的顶部边界。
• bottom：从基线到字体底部的距离。通常是正值，表示字体底部在基线之下，表示字体的底部边界。
• leading：建议在行与行之间额外添加的空间。通常是正值，表示行间距。用于计算行间距，以避免行与行之间的文本重叠。

2、获取文本宽度

/**
     * 获取文本的宽度
     */
    fun getTextWidth(paint: Paint, text: String): Float {
        return paint.measureText(text)
    }

3、获取文本高度（不含行间距）

    /**
     * 获取文本行高
     */
    fun getTextHeight(paint: Paint): Float {
        return (paint.fontMetrics.descent - paint.fontMetrics.ascent)
    }

4、获取行高（含行间距）

    /**
     * 获取行高（包含行间距）
     * leading 为行间距
     */
    fun getLineHeight(paint: Paint): Float {
        val textHeight = paint.fontMetrics.descent - paint.fontMetrics.ascent
        return (textHeight + paint.fontMetrics.leading)
    }

5、DrawText 时 Y 坐标

/**
     * 获取 drawText 时的 y 坐标值（基于基线）
     * @param textTop 文本顶部坐标
     */
    fun getDrawTextY(paint: Paint, textTop: Float): Float {
        return (textTop + abs(paint.fontMetrics.ascent))
    }

6、字体信息工具类

package com.android.androidfunctiondemo

import android.graphics.Paint
import kotlin.math.abs

/**
 * FontMetrics 是一个用于描述字体的度量信息的类。它提供了关于字体高度、行间距等的关键信息，这些信息对于精确控制文本的绘制和布局非常有用。
 * - ascent：从基线到 文本顶部 的距离，通常是负值，表示文本顶部在基线之上，表示文本的实际顶部边界。
 * - descent：从基线到 文本底部 的距离。通常是正值，表示文本底部在基线之下，表示文本的实际底部边界。
 * - top：从基线到 字体顶部 的距离。通常是负值，表示字体顶部在基线之上，表示字体的顶部边界。
 * - bottom：从基线到 字体底部 的距离。通常是正值，表示字体底部在基线之下，表示字体的底部边界。
 * - leading：建议在 行与行之间 额外添加的空间。通常是正值，表示行间距。用于计算行间距，以避免行与行之间的文本重叠。
 */
object FontInfoUtil{

    /**
     * 获取文本的宽度
     */
    fun getTextWidth(paint: Paint, text: String): Float {
        return paint.measureText(text)
    }

    /**
     * 获取文本高度
     */
    fun getTextHeight(paint: Paint): Float {
        return (paint.fontMetrics.descent - paint.fontMetrics.ascent)
    }

    /**
     * 获取行高（包含行间距）
     * leading 为行间距
     */
    fun getLineHeight(paint: Paint): Float {
        val textHeight = paint.fontMetrics.descent - paint.fontMetrics.ascent
        return (textHeight + paint.fontMetrics.leading)
    }

    /**
     * 获取 drawText 时的 y 坐标值（基于基线）
     * @param textTop 文本顶部坐标
     */
    fun getDrawTextY(paint: Paint, textTop: Float): Float {
        return (textTop + abs(paint.fontMetrics.ascent))
    }
}