Oltre a disegnare testo multilinea, si potrebbe avere difficoltà a ottenere i limiti del testo multilinea (ad esempio per allinearlo sulla tela).
Predefinitopaint.getTextBounds()
non funzionerà in questo caso poiché misurerà l'unica linea.
Per comodità, ho creato queste 2 funzioni di estensione: una per disegnare testo multilinea e l'altra per ottenere i limiti del testo.
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
}
Ora usarlo è così facile: Per disegnare testo multilinea:
canvas.drawTextMultiLine(text, x, y, yourPaint)
Per misurare il testo:
val bounds = yourPaint.getTextBoundsMultiLine (testo)
In questo caso, misurerà tutto il testo dall'inizio alla fine e con l'utilizzo di default una volta allocato (modificabile) Rect.
Puoi giocare con il passaggio di parametri extra per una maggiore flessibilità.
Layout
invece di chiamareCanvas.drawText
direttamente. Questa domanda e risposta mostra come utilizzare aStaticLayout
per disegnare testo multilinea.