public class Typeface
extends Object
java.lang.Object | |
↳ | android.graphics.Typeface |
字体类指定字体的字体和内在样式。 这用于绘画,以及可选的Paint设置,如textSize,textSkewX,textScaleX,以指定绘制(和测量)时文本的显示方式。
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
|
Typeface DEFAULT_BOLD
默认的BOLD字体对象。 注意:这可能实际上不是粗体,取决于安装的字体。 调用getStyle()来确认。
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. |
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. |
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. |
Typeface createFromFile (File path)
从指定的字体文件创建一个新的字体。
Parameters | |
---|---|
path |
File : The path to the font data. |
Returns | |
---|---|
Typeface |
The new typeface. |
Typeface createFromFile (String path)
从指定的字体文件创建一个新的字体。
Parameters | |
---|---|
path |
String : The full path to the font data. |
Returns | |
---|---|
Typeface |
The new typeface. |
Typeface defaultFromStyle (int style)
根据指定的样式返回默认字体对象之一
Parameters | |
---|---|
style |
int
|
Returns | |
---|---|
Typeface |
the default typeface that corresponds to the style |
boolean equals (Object o)
指示其他某个对象是否“等于”这一个。
equals
方法在非空对象引用上实现等价关系:
x
, x.equals(x)
should return true
. x
and y
, x.equals(y)
should return true
if and only if y.equals(x)
returns true
. x
, y
, and z
, if x.equals(y)
returns true
and y.equals(z)
returns true
, then x.equals(z)
should return true
. 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. x
, x.equals(null)
should return false
. 类Object
的equals
方法实现了对象上最有区别的可能等价关系; 也就是说,对于任何非空参考值x
和y
,当且仅当x
和y
引用同一对象( 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. |
int hashCode ()
返回对象的哈希码值。 为了散列表的好处而支持此方法,例如由HashMap
提供的HashMap
。
hashCode
的总合同是:
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. equals(Object)
method, then calling the hashCode
method on each of the two objects must produce the same integer result. 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. |
void finalize ()
当垃圾收集确定没有更多对该对象的引用时,由对象上的垃圾回收器调用。 子类会覆盖finalize
方法以处置系统资源或执行其他清理。
的常规协定finalize
是,它被调用,如果当在Java TM虚拟机已确定不再有由该目的可以通过还没有死亡,除了作为一个动作的结果的任何线程访问的任何手段取决于某些其他可以完成的对象或类别的最终定稿。 方法finalize
可以采取任何行动,包括使该对象再次可用于其他线程; 然而, finalize
的通常目的是在对象被不可撤销地丢弃之前执行清理操作。 例如,表示输入/输出连接的对象的finalize方法可能会执行显式I / O事务,以在永久丢弃该对象之前中断连接。
类Object
的finalize
方法Object
执行特殊操作; 它只是正常返回。 Object
子类可能会覆盖此定义。
Java编程语言不保证哪个线程将为任何给定对象调用finalize
方法。 但是,保证调用finalize的线程在调用finalize时不会保留任何用户可见的同步锁。 如果finalize方法引发未捕获的异常,则忽略该异常,并终止该对象的终止。
在针对某个对象调用 finalize
方法之后,不会采取进一步的操作,直到Java虚拟机再次确定不再有任何途径可以通过尚未死亡的任何线程访问此对象,包括可能的操作通过准备完成的其他对象或类别,此时该对象可能被丢弃。
对于任何给定的对象,Java虚拟机不会多次调用 finalize
方法。
finalize
方法抛出的任何异常 finalize
导致此对象的终止被暂停,但是会被忽略。
Throws | |
---|---|
Throwable |