public class

BoringLayout

extends Layout
implements TextUtils.EllipsizeCallback

java.lang.Object
↳	android.text.Layout
	↳	android.text.BoringLayout

Class Overview

A BoringLayout is a very simple Layout implementation for text that fits on a single line and is all left-to-right characters. You will probably never want to make one of these yourself; if you do, be sure to call isBoring(CharSequence, TextPaint) first to make sure the text meets the criteria.

This class is used by widgets to control text layout. You should not need to use this class directly unless you are implementing your own widget or custom display object, in which case you are encouraged to use a Layout instead of calling Canvas.drawText() directly.

Summary

Nested Classes
public class	BoringLayout.Metrics

[Expand]

Inherited Constants

From class android.text.Layout

Public Constructors
	BoringLayout(CharSequence source, TextPaint paint, int outerwidth, Layout.Alignment align, float spacingmult, float spacingadd, BoringLayout.Metrics metrics, boolean includepad)
	BoringLayout(CharSequence source, TextPaint paint, int outerwidth, Layout.Alignment align, float spacingmult, float spacingadd, BoringLayout.Metrics metrics, boolean includepad, TextUtils.TruncateAt ellipsize, int ellipsizedWidth)

Public Methods
void	draw(Canvas c, Path highlight, Paint highlightpaint, int cursorOffset) Draw the specified rectangle from this Layout on the specified Canvas, with the specified path drawn between the background and the text.
void	ellipsized(int start, int end) Callback for the ellipsizer to report what region it ellipsized.
int	getBottomPadding() Returns the number of extra pixels of descent padding in the bottom line of the Layout.
int	getEllipsisCount(int line) Returns the number of characters to be ellipsized away, or 0 if no ellipsis is to take place.
int	getEllipsisStart(int line) Return the offset of the first character to be ellipsized away, relative to the start of the line.
int	getEllipsizedWidth() Return the width to which this Layout is ellipsizing, or getWidth() if it is not doing anything special.
int	getHeight() Return the total height of this layout.
boolean	getLineContainsTab(int line) Returns whether the specified line contains one or more characters that need to be handled specially, like tabs or emoji.
int	getLineCount() Return the number of lines of text in this layout.
int	getLineDescent(int line) Return the descent of the specified line.
final Layout.Directions	getLineDirections(int line) Returns an array of directionalities for the specified line.
float	getLineMax(int line) Gets the horizontal extent of the specified line, excluding trailing whitespace.
int	getLineStart(int line) Return the text offset of the beginning of the specified line.
int	getLineTop(int line) Return the vertical position of the top of the specified line.
int	getParagraphDirection(int line) Returns the primary directionality of the paragraph containing the specified line.
int	getTopPadding() Returns the (negative) number of extra pixels of ascent padding in the top line of the Layout.
static BoringLayout.Metrics	isBoring(CharSequence text, TextPaint paint, BoringLayout.Metrics metrics) Returns null if not boring; the width, ascent, and descent in the provided Metrics object (or a new one if the provided one was null) if boring.
static BoringLayout.Metrics	isBoring(CharSequence text, TextPaint paint) Returns null if not boring; the width, ascent, and descent if boring.
static BoringLayout	make(CharSequence source, TextPaint paint, int outerwidth, Layout.Alignment align, float spacingmult, float spacingadd, BoringLayout.Metrics metrics, boolean includepad, TextUtils.TruncateAt ellipsize, int ellipsizedWidth)
static BoringLayout	make(CharSequence source, TextPaint paint, int outerwidth, Layout.Alignment align, float spacingmult, float spacingadd, BoringLayout.Metrics metrics, boolean includepad)
BoringLayout	replaceOrMake(CharSequence source, TextPaint paint, int outerwidth, Layout.Alignment align, float spacingmult, float spacingadd, BoringLayout.Metrics metrics, boolean includepad) Returns a BoringLayout for the specified text, potentially reusing this one if it is already suitable.
BoringLayout	replaceOrMake(CharSequence source, TextPaint paint, int outerwidth, Layout.Alignment align, float spacingmult, float spacingadd, BoringLayout.Metrics metrics, boolean includepad, TextUtils.TruncateAt ellipsize, int ellipsizedWidth) Returns a BoringLayout for the specified text, potentially reusing this one if it is already suitable.

[Expand]

Inherited Methods

From class android.text.Layout

void	draw(Canvas c) Draw this Layout on the specified Canvas.
void	draw(Canvas c, Path highlight, Paint highlightpaint, int cursorOffsetVertical) Draw the specified rectangle from this Layout on the specified Canvas, with the specified path drawn between the background and the text.
final Layout.Alignment	getAlignment() Return the base alignment of this layout.
abstract int	getBottomPadding() Returns the number of extra pixels of descent padding in the bottom line of the Layout.
void	getCursorPath(int point, Path dest, CharSequence editingBuffer) Fills in the specified Path with a representation of a cursor at the specified offset.
static float	getDesiredWidth(CharSequence source, int start, int end, TextPaint paint) Return how wide a layout would be necessary to display the specified text slice with one line per paragraph.
static float	getDesiredWidth(CharSequence source, TextPaint paint) Return how wide a layout would be necessary to display the specified text with one line per paragraph.
abstract int	getEllipsisCount(int line) Returns the number of characters to be ellipsized away, or 0 if no ellipsis is to take place.
abstract int	getEllipsisStart(int line) Return the offset of the first character to be ellipsized away, relative to the start of the line.
int	getEllipsizedWidth() Return the width to which this Layout is ellipsizing, or getWidth() if it is not doing anything special.
int	getHeight() Return the total height of this layout.
final int	getLineAscent(int line) Get the ascent of the text on the specified line.
final int	getLineBaseline(int line) Return the vertical position of the baseline of the specified line.
final int	getLineBottom(int line) Return the vertical position of the bottom of the specified line.
int	getLineBounds(int line, Rect bounds) Return the baseline for the specified line (0…getLineCount() - 1) If bounds is not null, return the top, left, right, bottom extents of the specified line in it.
abstract boolean	getLineContainsTab(int line) Returns whether the specified line contains one or more characters that need to be handled specially, like tabs or emoji.
abstract int	getLineCount() Return the number of lines of text in this layout.
abstract int	getLineDescent(int line) Return the descent of the specified line.
abstract Layout.Directions	getLineDirections(int line) Returns an array of directionalities for the specified line.
final int	getLineEnd(int line) Return the text offset after the last character on the specified line.
int	getLineForOffset(int offset) Get the line number on which the specified text offset appears.
int	getLineForVertical(int vertical) Get the line number corresponding to the specified vertical position.
float	getLineLeft(int line) Get the leftmost position that should be exposed for horizontal scrolling on the specified line.
float	getLineMax(int line) Gets the horizontal extent of the specified line, excluding trailing whitespace.
float	getLineRight(int line) Get the rightmost position that should be exposed for horizontal scrolling on the specified line.
abstract int	getLineStart(int line) Return the text offset of the beginning of the specified line.
abstract int	getLineTop(int line) Return the vertical position of the top of the specified line.
int	getLineVisibleEnd(int line) Return the text offset after the last visible character (so whitespace is not counted) on the specified line.
float	getLineWidth(int line) Gets the horizontal extent of the specified line, including trailing whitespace.
int	getOffsetForHorizontal(int line, float horiz) Get the character offset on the specfied line whose position is closest to the specified horizontal position.
int	getOffsetToLeftOf(int offset) Return the text offset that would be reached by moving left (possibly onto another line) from the specified offset.
int	getOffsetToRightOf(int offset) Return the text offset that would be reached by moving right (possibly onto another line) from the specified offset.
final TextPaint	getPaint() Return the base Paint properties for this layout.
final Layout.Alignment	getParagraphAlignment(int line) Get the alignment of the specified paragraph, taking into account markup attached to it.
abstract int	getParagraphDirection(int line) Returns the primary directionality of the paragraph containing the specified line.
final int	getParagraphLeft(int line) Get the left edge of the specified paragraph, inset by left margins.
final int	getParagraphRight(int line) Get the right edge of the specified paragraph, inset by right margins.
float	getPrimaryHorizontal(int offset) Get the primary horizontal position for the specified text offset.
float	getSecondaryHorizontal(int offset) Get the secondary horizontal position for the specified text offset.
void	getSelectionPath(int start, int end, Path dest) Fills in the specified Path with a representation of a highlight between the specified offsets.
final float	getSpacingAdd() Return the number of units of leading that are added to each line.
final float	getSpacingMultiplier() Return what the text height is multiplied by to get the line height.
final CharSequence	getText() Return the text that is displayed by this Layout.
abstract int	getTopPadding() Returns the (negative) number of extra pixels of ascent padding in the top line of the Layout.
final int	getWidth() Return the width of this layout.
final void	increaseWidthTo(int wid) Increase the width of this layout to the specified width.
final boolean	isSpanned()

From class java.lang.Object

Object	clone() Creates and returns a copy of this `Object`.
boolean	equals(Object o) Compares this instance with the specified object and indicates if they are equal.
void	finalize() Is called before the object's memory is being reclaimed by the VM.
final Class<? extends Object>	getClass() Returns the unique instance of Class which represents this object's class.
int	hashCode() Returns an integer hash code for this object.
final void	notify() Causes a thread which is waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
final void	notifyAll() Causes all threads which are waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
String	toString() Returns a string containing a concise, human-readable description of this object.
final void	wait(long millis, int nanos) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.
final void	wait(long millis) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.
final void	wait() Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object.

From interface android.text.TextUtils.EllipsizeCallback

Public Constructors

public BoringLayout (CharSequence source, TextPaint paint, int outerwidth, Layout.Alignment align, float spacingmult, float spacingadd, BoringLayout.Metrics metrics, boolean includepad)

public BoringLayout (CharSequence source, TextPaint paint, int outerwidth, Layout.Alignment align, float spacingmult, float spacingadd, BoringLayout.Metrics metrics, boolean includepad, TextUtils.TruncateAt ellipsize, int ellipsizedWidth)

Public Methods

public void draw (Canvas c, Path highlight, Paint highlightpaint, int cursorOffset)

Draw the specified rectangle from this Layout on the specified Canvas, with the specified path drawn between the background and the text.

public void ellipsized (int start, int end)

Callback for the ellipsizer to report what region it ellipsized.

public int getBottomPadding ()

Returns the number of extra pixels of descent padding in the bottom line of the Layout.

public int getEllipsisCount (int line)

Returns the number of characters to be ellipsized away, or 0 if no ellipsis is to take place.

public int getEllipsisStart (int line)

Return the offset of the first character to be ellipsized away, relative to the start of the line. (So 0 if the beginning of the line is ellipsized, not getLineStart().)

public int getEllipsizedWidth ()

Return the width to which this Layout is ellipsizing, or getWidth() if it is not doing anything special.

public int getHeight ()

Return the total height of this layout.

public boolean getLineContainsTab (int line)

Returns whether the specified line contains one or more characters that need to be handled specially, like tabs or emoji.

public int getLineCount ()

Return the number of lines of text in this layout.

public int getLineDescent (int line)

Return the descent of the specified line.

public final Layout.Directions getLineDirections (int line)

Returns an array of directionalities for the specified line. The array alternates counts of characters in left-to-right and right-to-left segments of the line.

public float getLineMax (int line)

Gets the horizontal extent of the specified line, excluding trailing whitespace.

public int getLineStart (int line)

Return the text offset of the beginning of the specified line. If the specified line is one beyond the last line, returns the end of the last line.

public int getLineTop (int line)

Return the vertical position of the top of the specified line. If the specified line is one beyond the last line, returns the bottom of the last line.

public int getParagraphDirection (int line)

Returns the primary directionality of the paragraph containing the specified line.

public int getTopPadding ()

Returns the (negative) number of extra pixels of ascent padding in the top line of the Layout.

public static BoringLayout.Metrics isBoring (CharSequence text, TextPaint paint, BoringLayout.Metrics metrics)

Returns null if not boring; the width, ascent, and descent in the provided Metrics object (or a new one if the provided one was null) if boring.

public static BoringLayout.Metrics isBoring (CharSequence text, TextPaint paint)

Returns null if not boring; the width, ascent, and descent if boring.

public static BoringLayout make (CharSequence source, TextPaint paint, int outerwidth, Layout.Alignment align, float spacingmult, float spacingadd, BoringLayout.Metrics metrics, boolean includepad, TextUtils.TruncateAt ellipsize, int ellipsizedWidth)

public static BoringLayout make (CharSequence source, TextPaint paint, int outerwidth, Layout.Alignment align, float spacingmult, float spacingadd, BoringLayout.Metrics metrics, boolean includepad)

public BoringLayout replaceOrMake (CharSequence source, TextPaint paint, int outerwidth, Layout.Alignment align, float spacingmult, float spacingadd, BoringLayout.Metrics metrics, boolean includepad)

Returns a BoringLayout for the specified text, potentially reusing this one if it is already suitable. The caller must make sure that no one is still using this Layout.

public BoringLayout replaceOrMake (CharSequence source, TextPaint paint, int outerwidth, Layout.Alignment align, float spacingmult, float spacingadd, BoringLayout.Metrics metrics, boolean includepad, TextUtils.TruncateAt ellipsize, int ellipsizedWidth)