Além de desenhar texto de múltiplas linhas, pode-se ter dificuldade em obter os limites do texto de várias linhas (por exemplo, para alinhá-lo na tela).
O padrão paint.getTextBounds()
não funcionará neste caso, pois medirá a única linha.
Por conveniência, criei essas duas funções de extensão: uma para desenhar texto com várias linhas e a outra para obter limites 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
}
Agora, é fácil usá-lo: Para desenhar texto com várias linhas:
canvas.drawTextMultiLine(text, x, y, yourPaint)
Para medir texto:
limites de val = yourPaint.getTextBoundsMultiLine (texto)
Nesse caso, ele medirá todo o texto do início ao fim e com o uso do padrão, uma vez alocado (mutável) Rect.
Você pode brincar com a passagem de parâmetros extras para maior flexibilidade.
Layout
vez de chamarCanvas.drawText
diretamente. Esta sessão de perguntas e respostas mostra como usar aStaticLayout
para desenhar texto de várias linhas.