Además de dibujar texto multilínea, uno puede tener dificultades para obtener los límites del texto multilínea (por ejemplo, para alinearlo en el lienzo).
El valor predeterminado paint.getTextBounds()
no funcionará en este caso, ya que medirá la única línea.
Por conveniencia, creé estas 2 funciones de extensión: una para dibujar texto multilínea y la otra para obtener límites de texto.
private val textBoundsRect = Rect()
/**
* Draws multi-line text on the Canvas with the origin at (x,y), using the specified paint. The origin is interpreted
* based on the Align setting in the paint.
*
* @param text The text to be drawn
* @param x The x-coordinate of the origin of the text being drawn
* @param y The y-coordinate of the baseline of the text being drawn
* @param paint The paint used for the text (e.g. color, size, style)
*/
fun Canvas.drawTextMultiLine(text: String, x: Float, y: Float, paint: Paint) {
var lineY = y
for (line in text.split("\n")) {
lineY += paint.descent().toInt() - paint.ascent().toInt()
drawText(line, x, lineY, paint)
}
}
/**
* Retrieve the text boundary box, taking into account line breaks [\n] and store to [boundsRect].
*
* Return in bounds (allocated by the caller [boundsRect] or default mutable [textBoundsRect]) the smallest rectangle that
* encloses all of the characters, with an implied origin at (0,0).
*
* @param text string to measure and return its bounds
* @param start index of the first char in the string to measure. By default is 0.
* @param end 1 past the last char in the string to measure. By default is test length.
* @param boundsRect rect to save bounds. Note, you may not supply it. By default, it will apply values to the mutable [textBoundsRect] and return it.
* In this case it will be changed by each new this function call.
*/
fun Paint.getTextBoundsMultiLine(
text: String,
start: Int = 0,
end: Int = text.length,
boundsRect: Rect = textBoundsRect
): Rect {
getTextBounds(text, start, end, boundsRect)
val linesCount = text.split("\n").size
val allLinesHeight = (descent().toInt() - ascent().toInt()) * linesCount
boundsRect.bottom = boundsRect.top + allLinesHeight
return boundsRect
}
Ahora usarlo es tan fácil como eso: para dibujar texto multilínea:
canvas.drawTextMultiLine(text, x, y, yourPaint)
Para medir texto:
val límites = yourPaint.getTextBoundsMultiLine (texto)
En este caso, medirá todo el texto desde el principio hasta el final y con el uso de Rect predeterminado (mutable) una vez asignado.
Puede jugar con pasar parámetros adicionales para mayor flexibilidad.
Layout
lugar de llamarCanvas.drawText
directamente. Estas preguntas y respuestas muestran cómo usar aStaticLayout
para dibujar texto multilínea.