com.araneaapps.android.libs.awesomedrawable

Class TextDrawable

java.lang.Object

android.graphics.drawable.Drawable

com.araneaapps.android.libs.awesomedrawable.TextDrawable

Direct Known Subclasses:

AwesomeTextDrawable

public class TextDrawable
extends android.graphics.drawable.Drawable

A Drawable object that draws text. A TextDrawable accepts most of the same parameters that can be applied to android.widget.TextView for displaying and formatting text.

Optionally, a Path may be supplied on which to draw the text.

A TextDrawable has an intrinsic size equal to that required to draw all the text it has been supplied, when possible. In cases where a Path has been supplied, the caller must explicitly call setBounds() to provide the Drawable size based on the Path constraints.

Nested Class Summary

Nested classes/interfaces inherited from class android.graphics.drawable.Drawable

android.graphics.drawable.Drawable.Callback, android.graphics.drawable.Drawable.ConstantState

Constructor Summary

Constructors

Constructor and Description
TextDrawable(android.content.Context context)

Method Summary

Methods

Modifier and Type	Method and Description
void	draw(android.graphics.Canvas canvas)
int	getIntrinsicHeight()
int	getIntrinsicWidth()
int	getOpacity()
CharSequence	getText() Return the text currently being displayed
android.text.Layout.Alignment	getTextAlign() Return the current text alignment setting
float	getTextScaleX() Return the horizontal stretch factor of the text
float	getTextSize() Return the current text size, in pixels
android.graphics.Typeface	getTypeface() Return the current typeface and style that the Paint using for display.
boolean	isStateful()
protected void	onBoundsChange(android.graphics.Rect bounds)
protected boolean	onStateChange(int[] state)
void	setAlpha(int alpha)
void	setColorFilter(android.graphics.ColorFilter cf)
void	setText(CharSequence text) Set the text that will be displayed
void	setTextAlign(android.text.Layout.Alignment align) Set the text alignment.
void	setTextColor(android.content.res.ColorStateList colorStateList) Set the text color as a state list
void	setTextColor(int color) Set a single text color for all states
void	setTextPath(android.graphics.Path path) Optional Path object on which to draw the text.
void	setTextScaleX(float size) Set the horizontal stretch factor of the text
void	setTextSize(float size) Set the text size.
void	setTextSize(int unit, float size) Set the text size, using the supplied complex units
void	setTypeface(android.graphics.Typeface tf) Sets the typeface and style in which the text should be displayed.
void	setTypeface(android.graphics.Typeface tf, int style) Sets the typeface and style in which the text should be displayed, and turns on the fake bold and italic bits in the Paint if the Typeface that you provided does not have all the bits in the style that you specified.

Methods inherited from class android.graphics.drawable.Drawable

clearColorFilter, copyBounds, copyBounds, createFromPath, createFromResourceStream, createFromResourceStream, createFromStream, createFromXml, createFromXmlInner, getBounds, getCallback, getChangingConfigurations, getConstantState, getCurrent, getLevel, getMinimumHeight, getMinimumWidth, getPadding, getState, getTransparentRegion, inflate, invalidateSelf, isVisible, jumpToCurrentState, mutate, onLevelChange, resolveOpacity, scheduleSelf, setBounds, setBounds, setCallback, setChangingConfigurations, setColorFilter, setDither, setFilterBitmap, setLevel, setState, setVisible, unscheduleSelf

Methods inherited from class java.lang.Object

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

Constructor Detail

TextDrawable

public TextDrawable(android.content.Context context)

Method Detail

setText

public void setText(CharSequence text)

Set the text that will be displayed

Parameters:

text - Text to display

getText

public CharSequence getText()

Return the text currently being displayed

getTextSize

public float getTextSize()

Return the current text size, in pixels

setTextSize

public void setTextSize(float size)

Set the text size. The value will be interpreted in "sp" units

Parameters:

size - Text size value, in sp

setTextSize

public void setTextSize(int unit,
               float size)

Set the text size, using the supplied complex units

Parameters:

unit - Units for the text size, such as dp or sp

size - Text size value

getTextScaleX

public float getTextScaleX()

Return the horizontal stretch factor of the text

setTextScaleX

public void setTextScaleX(float size)

Set the horizontal stretch factor of the text

Parameters:

size - Text scale factor

getTextAlign

public android.text.Layout.Alignment getTextAlign()

Return the current text alignment setting

setTextAlign

public void setTextAlign(android.text.Layout.Alignment align)

Set the text alignment. The alignment itself is based on the text layout direction. For LTR text NORMAL is left aligned and OPPOSITE is right aligned. For RTL text, those alignments are reversed.

Parameters:

align - Text alignment value. Should be set to one of:

Layout.Alignment.ALIGN_NORMAL, Layout.Alignment.ALIGN_NORMAL, Layout.Alignment.ALIGN_OPPOSITE.

setTypeface

public void setTypeface(android.graphics.Typeface tf)

Sets the typeface and style in which the text should be displayed. Note that not all Typeface families actually have bold and italic variants, so you may need to use setTypeface(android.graphics.Typeface, int) to get the appearance that you actually want.

setTypeface

public void setTypeface(android.graphics.Typeface tf,
               int style)

Sets the typeface and style in which the text should be displayed, and turns on the fake bold and italic bits in the Paint if the Typeface that you provided does not have all the bits in the style that you specified.

getTypeface

public android.graphics.Typeface getTypeface()

Return the current typeface and style that the Paint using for display.

setTextColor

public void setTextColor(int color)

Set a single text color for all states

Parameters:

color - Color value such as Color.WHITE or Color.argb(int, int, int, int)

setTextColor

public void setTextColor(android.content.res.ColorStateList colorStateList)

Set the text color as a state list

Parameters:

colorStateList - ColorStateList of text colors, such as inflated from an R.color resource

setTextPath

public void setTextPath(android.graphics.Path path)

Optional Path object on which to draw the text. If this is set, TextDrawable cannot properly measure the bounds this drawable will need. You must call setBounds() before applying this TextDrawable to any View.

Calling this method with null will remove any Path currently attached.

onBoundsChange

protected void onBoundsChange(android.graphics.Rect bounds)

Overrides:

onBoundsChange in class android.graphics.drawable.Drawable

isStateful

public boolean isStateful()

Overrides:

isStateful in class android.graphics.drawable.Drawable

onStateChange

protected boolean onStateChange(int[] state)

Overrides:

onStateChange in class android.graphics.drawable.Drawable

getIntrinsicHeight

public int getIntrinsicHeight()

Overrides:

getIntrinsicHeight in class android.graphics.drawable.Drawable

getIntrinsicWidth

public int getIntrinsicWidth()

Overrides:

getIntrinsicWidth in class android.graphics.drawable.Drawable

draw

public void draw(android.graphics.Canvas canvas)

Specified by:

draw in class android.graphics.drawable.Drawable

setAlpha

public void setAlpha(int alpha)

Specified by:

setAlpha in class android.graphics.drawable.Drawable

getOpacity

public int getOpacity()

Specified by:

getOpacity in class android.graphics.drawable.Drawable

setColorFilter

public void setColorFilter(android.graphics.ColorFilter cf)

Specified by:

setColorFilter in class android.graphics.drawable.Drawable