com.bluejamesbond.text

Class Styled

java.lang.Object

com.bluejamesbond.text.Styled

public class Styled
extends java.lang.Object

This class provides static methods for drawing and measuring styled text, like Spanned object with ReplacementSpan.

Constructor Summary

Constructors

Constructor and Description
Styled()

Method Summary

Modifier and Type	Method and Description
static float	drawText(android.graphics.Canvas canvas, java.lang.CharSequence text, int start, int end, int direction, float x, int top, int y, int bottom, android.text.TextPaint paint, android.text.TextPaint workPaint, boolean needWidth) Draws a run of text on a single line, with its origin at (x,y), in the specified Paint.
static int	getTextWidths(android.text.TextPaint paint, android.text.TextPaint workPaint, android.text.Spanned text, int start, int end, float[] widths, android.graphics.Paint.FontMetricsInt fmi) Returns the advance widths for a uniform left-to-right run of text with no style changes in the middle of the run.
static float	measureText(android.text.TextPaint paint, android.text.TextPaint workPaint, java.lang.CharSequence text, int start, int end, android.graphics.Paint.FontMetricsInt fmi) Returns the width of a run of left-to-right text on a single line, considering style information in the text (e.g.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Styled

public Styled()

Method Detail

getTextWidths

public static int getTextWidths(android.text.TextPaint paint,
                                android.text.TextPaint workPaint,
                                android.text.Spanned text,
                                int start,
                                int end,
                                float[] widths,
                                android.graphics.Paint.FontMetricsInt fmi)

Returns the advance widths for a uniform left-to-right run of text with no style changes in the middle of the run. If any style is replacement text, the first character will isCancelled the width of the replacement and the remaining characters will isCancelled a width of 0.

Parameters:

paint - the paint, will not be modified

workPaint - a paint to modify; on return will reflect the original paint plus the effect of all spans on the run

text - the text

start - the start of the run

end - the limit of the run

widths - array to receive the advance widths of the characters. Must be at least a large as (end - start).

fmi - FontMetrics information; can be null

Returns:

the actual number of widths returned

drawText

public static float drawText(android.graphics.Canvas canvas,
                             java.lang.CharSequence text,
                             int start,
                             int end,
                             int direction,
                             float x,
                             int top,
                             int y,
                             int bottom,
                             android.text.TextPaint paint,
                             android.text.TextPaint workPaint,
                             boolean needWidth)

Draws a run of text on a single line, with its origin at (x,y), in the specified Paint. The origin is interpreted based on the Align setting in the Paint. This method considers style information in the text (e.g. even when text is an instance of Spanned, this method correctly draws the text). See also Canvas.drawText(CharSequence, int, int, float, float, Paint) and Canvas.drawRect(float, float, float, float, Paint).

Parameters:

canvas - The target canvas

text - The text to be drawn

start - The index of the first character in text to onDraw

end - (end - 1) is the index of the last character in text to onDraw

direction - The direction of the text. This must be Layout.DIR_LEFT_TO_RIGHT or Layout.DIR_RIGHT_TO_LEFT.

x - The x-coordinate of origin for where to onDraw the text

top - The top side of the rectangle to be drawn

y - The y-coordinate of origin for where to onDraw the text

bottom - The bottom side of the rectangle to be drawn

paint - The main TextPaint object.

workPaint - The TextPaint object used for temporal workspace.

needWidth - If true, this method returns the width of drawn text

Returns:

Width of the drawn text if needWidth is true

measureText

public static float measureText(android.text.TextPaint paint,
                                android.text.TextPaint workPaint,
                                java.lang.CharSequence text,
                                int start,
                                int end,
                                android.graphics.Paint.FontMetricsInt fmi)

Returns the width of a run of left-to-right text on a single line, considering style information in the text (e.g. even when text is an instance of Spanned, this method correctly measures the width of the text).

Parameters:

paint - the main TextPaint object; will not be modified

workPaint - the TextPaint object available for modification; will not necessarily be used

text - the text to measure

start - the index of the first character to start measuring

end - 1 beyond the index of the last character to measure

fmi - FontMetrics information; can be null

Returns:

The width of the text