Помимо рисования многострочного текста, может возникнуть проблема с получением границ многострочного текста (например, чтобы выровнять его на холсте).
По умолчанию paint.getTextBounds()
в этом случае работать не будет, так как измеряется единственная линия.
Для удобства я создал эти две функции расширения: одну для рисования многострочного текста, а другую для получения границ текста.
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
}
Теперь использовать это очень просто: Для рисования многострочного текста:
canvas.drawTextMultiLine(text, x, y, yourPaint)
Для измерения текста:
val bounds = yourPaint.getTextBoundsMultiLine (текст)
В этом случае он будет измерять весь текст от начала до конца и с использованием значения по умолчанию после выделенного (изменяемого) Rect.
Вы можете поиграть с передачей дополнительных параметров для большей гибкости.
Layout
вместоCanvas.drawText
прямого вызова . В этом разделе вопросов и ответов показано, как использовать aStaticLayout
для рисования многострочного текста.