Most visited

Recently visited

Added in API level 1

Typeface

public class Typeface
extends Object

java.lang.Object
   ↳ android.graphics.Typeface


字体类指定字体的字体和内在样式。 这用于绘画,以及可选的Paint设置,如textSize,textSkewX,textScaleX,以指定绘制(和测量)时文本的显示方式。

Summary

Constants

int BOLD

int BOLD_ITALIC

int ITALIC

int NORMAL

Fields

public static final Typeface DEFAULT

默认的NORMAL字体对象

public static final Typeface DEFAULT_BOLD

默认的BOLD字体对象。

public static final Typeface MONOSPACE

默认等宽字体的NORMAL风格。

public static final Typeface SANS_SERIF

默认无衬线字体的NORMAL风格。

public static final Typeface SERIF

默认serif字体的NORMAL风格。

Public methods

static Typeface create(Typeface family, int style)

创建一个与指定的现有字体和指定的样式最匹配的字体对象。

static Typeface create(String familyName, int style)

创建一个给定姓名的字体对象,以及选项样式信息。

static Typeface createFromAsset(AssetManager mgr, String path)

从指定的字体数据创建一个新的字体。

static Typeface createFromFile(File path)

从指定的字体文件创建一个新的字体。

static Typeface createFromFile(String path)

从指定的字体文件创建一个新的字体。

static Typeface defaultFromStyle(int style)

根据指定的样式返回默认字体对象之一

boolean equals(Object o)

指示其他某个对象是否“等于”这一个。

int getStyle()

返回字体的内在样式属性

int hashCode()

返回对象的哈希码值。

final boolean isBold()

如果getStyle()设置了BOLD位,则返回true。

final boolean isItalic()

如果getStyle()设置了ITALIC位,则返回true。

Protected methods

void finalize()

当垃圾收集确定没有更多对该对象的引用时,由对象上的垃圾回收器调用。

Inherited methods

From class java.lang.Object

Constants

BOLD

Added in API level 1
int BOLD

常数值:1(0x00000001)

BOLD_ITALIC

Added in API level 1
int BOLD_ITALIC

常量值:3(0x00000003)

ITALIC

Added in API level 1
int ITALIC

常量值:2(0x00000002)

NORMAL

Added in API level 1
int NORMAL

常量值:0(0x00000000)

Fields

DEFAULT

Added in API level 1
Typeface DEFAULT

默认的NORMAL字体对象

DEFAULT_BOLD

Added in API level 1
Typeface DEFAULT_BOLD

默认的BOLD字体对象。 注意:这可能实际上不是粗体,取决于安装的字体。 调用getStyle()来确认。

MONOSPACE

Added in API level 1
Typeface MONOSPACE

默认等宽字体的NORMAL风格。

SANS_SERIF

Added in API level 1
Typeface SANS_SERIF

默认无衬线字体的NORMAL风格。

SERIF

Added in API level 1
Typeface SERIF

默认serif字体的NORMAL风格。

Public methods

create

Added in API level 1
Typeface create (Typeface family, 
                int style)

创建一个与指定的现有字体和指定的样式最匹配的字体对象。 如果您想从现有字体对象的同一系列中选择新样式,请使用此调用。 如果family为null,则从默认字体家族中选择。

Parameters
family Typeface: May be null. The name of the existing type face.
style int: The style (normal, bold, italic) of the typeface. e.g. NORMAL, BOLD, ITALIC, BOLD_ITALIC
Returns
Typeface The best matching typeface.

create

Added in API level 1
Typeface create (String familyName, 
                int style)

创建一个给定姓名的字体对象,以及选项样式信息。 如果名称传递为null,则将选择“默认”字体。 可以查询生成的字体对象(getStyle())以发现其“真实”风格特征。

Parameters
familyName String: May be null. The name of the font family.
style int: The style (normal, bold, italic) of the typeface. e.g. NORMAL, BOLD, ITALIC, BOLD_ITALIC
Returns
Typeface The best matching typeface.

createFromAsset

Added in API level 1
Typeface createFromAsset (AssetManager mgr, 
                String path)

从指定的字体数据创建一个新的字体。

Parameters
mgr AssetManager: The application's asset manager
path String: The file name of the font data in the assets directory
Returns
Typeface The new typeface.

createFromFile

Added in API level 4
Typeface createFromFile (File path)

从指定的字体文件创建一个新的字体。

Parameters
path File: The path to the font data.
Returns
Typeface The new typeface.

createFromFile

Added in API level 4
Typeface createFromFile (String path)

从指定的字体文件创建一个新的字体。

Parameters
path String: The full path to the font data.
Returns
Typeface The new typeface.

defaultFromStyle

Added in API level 1
Typeface defaultFromStyle (int style)

根据指定的样式返回默认字体对象之一

Parameters
style int
Returns
Typeface the default typeface that corresponds to the style

equals

Added in API level 1
boolean equals (Object o)

指示其他某个对象是否“等于”这一个。

equals方法在非空对象引用上实现等价关系:

  • It is reflexive: for any non-null reference value x, x.equals(x) should return true.
  • It is symmetric: for any non-null reference values x and y, x.equals(y) should return true if and only if y.equals(x) returns true.
  • It is transitive: for any non-null reference values x, y, and z, if x.equals(y) returns true and y.equals(z) returns true, then x.equals(z) should return true.
  • It is consistent: for any non-null reference values x and y, multiple invocations of x.equals(y) consistently return true or consistently return false, provided no information used in equals comparisons on the objects is modified.
  • For any non-null reference value x, x.equals(null) should return false.

Objectequals方法实现了对象上最有区别的可能等价关系; 也就是说,对于任何非空参考值xy ,当且仅当xy引用同一对象( x == y的值为true )时,此方法返回true

请注意,无论何时重写此方法,通常都必须覆盖 hashCode方法,以便维护 hashCode方法的常规协定,该方法声明相等对象必须具有相同的哈希代码。

Parameters
o Object: the reference object with which to compare.
Returns
boolean true if this object is the same as the obj argument; false otherwise.

getStyle

Added in API level 1
int getStyle ()

返回字体的内在样式属性

Returns
int

hashCode

Added in API level 1
int hashCode ()

返回对象的哈希码值。 为了散列表的好处而支持此方法,例如由HashMap提供的HashMap

hashCode的总合同是:

  • Whenever it is invoked on the same object more than once during an execution of a Java application, the hashCode method must consistently return the same integer, provided no information used in equals comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application.
  • If two objects are equal according to the equals(Object) method, then calling the hashCode method on each of the two objects must produce the same integer result.
  • It is not required that if two objects are unequal according to the equals(java.lang.Object) method, then calling the hashCode method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables.

尽可能合理实用,类Object定义的hashCode方法确实为不同的对象返回不同的整数。 (这通常通过将对象的内部地址转换为整数来实现,但Java TM编程语言不需要此实现技术。)

Returns
int a hash code value for this object.

isBold

Added in API level 1
boolean isBold ()

如果getStyle()设置了BOLD位,则返回true。

Returns
boolean

isItalic

Added in API level 1
boolean isItalic ()

如果getStyle()设置了ITALIC位,则返回true。

Returns
boolean

Protected methods

finalize

Added in API level 1
void finalize ()

当垃圾收集确定没有更多对该对象的引用时,由对象上的垃圾回收器调用。 子类会覆盖finalize方法以处置系统资源或执行其他清理。

的常规协定finalize是,它被调用,如果当在Java TM虚拟机已确定不再有由该目的可以通过还没有死亡,除了作为一个动作的结果的任何线程访问的任何手段取决于某些其他可以完成的对象或类别的最终定稿。 方法finalize可以采取任何行动,包括使该对象再次可用于其他线程; 然而, finalize的通常目的是在对象被不可撤销地丢弃之前执行清理操作。 例如,表示输入/输出连接的对象的finalize方法可能会执行显式I / O事务,以在永久丢弃该对象之前中断连接。

Objectfinalize方法Object执行特殊操作; 它只是正常返回。 Object子类可能会覆盖此定义。

Java编程语言不保证哪个线程将为任何给定对象调用finalize方法。 但是,保证调用finalize的线程在调用finalize时不会保留任何用户可见的同步锁。 如果finalize方法引发未捕获的异常,则忽略该异常,并终止该对象的终止。

在针对某个对象调用 finalize方法之后,不会采取进一步的操作,直到Java虚拟机再次确定不再有任何途径可以通过尚未死亡的任何线程访问此对象,包括可能的操作通过准备完成的其他对象或类别,此时该对象可能被丢弃。

对于任何给定的对象,Java虚拟机不会多次调用 finalize方法。

finalize方法抛出的任何异常 finalize导致此对象的终止被暂停,但是会被忽略。

Throws
Throwable

Hooray!