android.graphics
Class Typeface

java.lang.Object
  android.graphics.Typeface

public class Typeface
extends Object

The Typeface class specifies the typeface and intrinsic style of a font. This is used in the paint, along with optionally Paint settings like textSize, textSkewX, textScaleX to specify how text appears when drawn (and measured).

Field Summary

static int	BOLD
static int	BOLD_ITALIC
static Typeface	DEFAULT The default NORMAL typeface object
static Typeface	DEFAULT_BOLD The default BOLD typeface object.
static int	ITALIC
static Typeface	MONOSPACE The NORMAL style of the default monospace typeface.
(package private) int	native_instance
static int	NORMAL
static Typeface	SANS_SERIF The NORMAL style of the default sans serif typeface.
static Typeface	SERIF The NORMAL style of the default serif typeface.

Method Summary

static Typeface	create(String familyName, int style) Create a typeface object given a family name, and option style information.
static Typeface	create(Typeface family, int style) Create a typeface object that best matches the specified existing typeface and the specified Style.
static Typeface	createFromAsset(AssetManager mgr, String path) Create a new typeface from the specified font data.
static Typeface	defaultFromStyle(int style) Returns one of the default typeface objects, based on the specified style
protected void	finalize() Called by the virtual machine when there are no longer any (non-weak) references to the receiver.
int	getStyle() Returns the typeface's intrinsic style attributes
boolean	isBold() Returns true if getStyle() has the BOLD bit set.
boolean	isItalic() Returns true if getStyle() has the ITALIC bit set.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT

public static final Typeface DEFAULT

The default NORMAL typeface object

DEFAULT_BOLD

public static final Typeface DEFAULT_BOLD

The default BOLD typeface object. Note: this may be not actually be bold, depending on what fonts are installed. Call getStyle() to know for sure.

SANS_SERIF

public static final Typeface SANS_SERIF

The NORMAL style of the default sans serif typeface.

SERIF

public static final Typeface SERIF

The NORMAL style of the default serif typeface.

MONOSPACE

public static final Typeface MONOSPACE

The NORMAL style of the default monospace typeface.

native_instance

int native_instance

NORMAL

public static final int NORMAL

See Also:

Constant Field Values

BOLD

public static final int BOLD

See Also:

Constant Field Values

ITALIC

public static final int ITALIC

See Also:

Constant Field Values

BOLD_ITALIC

public static final int BOLD_ITALIC

See Also:

Constant Field Values

Method Detail

getStyle

public int getStyle()

Returns the typeface's intrinsic style attributes

isBold

public final boolean isBold()

Returns true if getStyle() has the BOLD bit set.

isItalic

public final boolean isItalic()

Returns true if getStyle() has the ITALIC bit set.

create

public static Typeface create(String familyName,
                              int style)

Create a typeface object given a family name, and option style information. If null is passed for the name, then the "default" font will be chosen. The resulting typeface object can be queried (getStyle()) to discover what its "real" style characteristics are.

Parameters:

familyName - May be null. The name of the font family.

style - The style (normal, bold, italic) of the typeface. e.g. NORMAL, BOLD, ITALIC, BOLD_ITALIC

Returns:

The best matching typeface.

create

public static Typeface create(Typeface family,
                              int style)

Create a typeface object that best matches the specified existing typeface and the specified Style. Use this call if you want to pick a new style from the same family of an existing typeface object. If family is null, this selects from the default font's family.

Parameters:

family - May be null. The name of the existing type face.

style - The style (normal, bold, italic) of the typeface. e.g. NORMAL, BOLD, ITALIC, BOLD_ITALIC

Returns:

The best matching typeface.

defaultFromStyle

public static Typeface defaultFromStyle(int style)

Returns one of the default typeface objects, based on the specified style

Returns:

the default typeface that corresponds to the style

createFromAsset

public static Typeface createFromAsset(AssetManager mgr,
                                       String path)

Create a new typeface from the specified font data.

Parameters:

mgr - The application's asset manager

path - The file name of the font data in the assets directory

Returns:

The new typeface.

finalize

protected void finalize()
                 throws Throwable

Description copied from class: Object

Called by the virtual machine when there are no longer any (non-weak) references to the receiver. Subclasses can use this facility to guarantee that any associated resources are cleaned up before the receiver is garbage collected. Uncaught exceptions which are thrown during the running of the method cause it to terminate immediately, but are otherwise ignored.

Note: The virtual machine assumes that the implementation in class Object is empty.

Overrides:

finalize in class Object

Throws:

Throwable - The virtual machine ignores any exceptions which are thrown during finalization.