javatm platform
standard ed. 6

java.awt
类 fontmetrics

java.lang.object 继承者 java.awt.fontmetrics
所有(suǒ yǒu)已实现的接口:
serializable

public abstract class fontmetrics
extends object
implements serializable

fontmetrics 类定义字体(zì tǐ)规格对象,该对象封装将在特定屏幕上呈现特定字体(zì tǐ)的有关信息。

子类注意(危险信号)事项:由于(yóu yú)当中很多方法都形成(caused)(xíng chéng)关闭的、相互递归的循环,所以必须注意(危险信号),在每个这样(then)的循环中至少要实现其中一个方法,以防止在使用子类时产生无穷递归。特别建议,至少要重写以下方法集合以确保正确性,并防止无穷递归(虽然其他(qí tā)子集也可以( kě yǐ))。

字母 'p' 显示其“引用点” 注意,这些方法的实现效率低下,因此(therefore)通常利用更高效的特定于工具包的实现重写它们。

当应用程序要求将字符放置在 (x, y) 位置(wèi zhi)时,放置字符的方式是使其引用点(附图中显示的点)放置在该位置(wèi zhi)。引用点指定一条水平线,称为字符的基线 (baseline)。在正常的打印中,字符的基线应该(yīng gāi)对齐。

此外,字体中的每个字符都具有 ascentdescentadvance width 属性。ascent 是字符超出基线之上的距离。descent 是字符超出基线以下的距离。advance width 指示 awt 应该(yīng gāi)放置下一个字符的位置。

字符数组或字符串也可以( kě yǐ)具有 ascent、descent 和 advance width 属性。数组的 ascent 是数组中所有字符的最大(largest) ascent。descent 是数组中所有字符的最大(largest) descent。advance width 是字符数组中每个字符的 advance width 之和。string 的 advance 是 string 沿基线的距离。此距离是 string 居中或右对齐应该使用的 width。

注意,string 的 advance 不一定是每个字符单独(alone)测量的 advance 之和,因为字符的 width 可随上下文变动。例如,在 arabic 文本中,可以更改一个字符的形状,以连接到其他(qí tā)字符。而在有些脚本中,某些字符序列可以由单个形状(称为连字)表示。单独(alone)测量的字符并不能说明这些转换。

字体规格是基线相关的,意味着它们通常是独立应用于该字体的循环(模可能(would)的网格提示(tips)作用)。请参阅 font

从以下版本开始(appeared):
jdk1.0
另请参见:
font,序列化表格

字段摘要
protected  fontfont
          实际的 font,字体规格是由此创建的。
 
构造方法摘要
protected fontmetrics(font font)
          创建一个新 fontmetrics 对象,用于查找该 font 中关于指定 font 和特定字符字形的 height 和 width 信息。
 
方法摘要
 intbyteswidth(byte[] data,int off,int len)
          返回显示此 font 中指定字节数组的总 advance width。
 intcharswidth(char[] data,int off,int len)
          返回显示此 font 中指定字符数组的总 advance width。
 intcharwidth(char ch)
          返回此 font 中指定字符的 advance width。
 intcharwidth(int codepoint)
          返回此 font 中指定字符的 advance width。
 intgetascent()
          确定此 fontmetrics 对象所描述的 fontfont ascent
 intgetdescent()
          确定此 fontmetrics 对象所描述的 fontfont descent
 fontgetfont()
          获取此 fontmetrics 对象所描述的 font
 fontrendercontextgetfontrendercontext()
          获取此 fontmetrics 对象用来测量文本的 fontrendercontext
 intgetheight()
          获取此 font 中文(zhōng wén)本行的标准 height。
 intgetleading()
          确定此 fontmetrics 对象所描述的 font标准行间距
 linemetricsgetlinemetrics(char[] chars,int beginindex,int limit,graphics context)
          返回指定 graphics 上下文中指定字符数组的 linemetrics 对象。
 linemetricsgetlinemetrics(characteriterator ci,int beginindex,int limit,graphics context)
          返回指定 graphics 上下文中指定 characteriteratorlinemetrics 对象。
 linemetricsgetlinemetrics(string str,graphics context)
          返回指定 graphics 上下文中指定 stringlinemetrics 对象。
 linemetricsgetlinemetricsjs随机数(string str,int beginindex,int limit,graphics context)
          返回指定 graphics 上下文中指定 stringlinemetrics 对象。
 intgetmaxadvance()
          获取此 font 中所有字符的最大 advance width。
 intgetmaxascent()
          确定此 fontmetrics 对象所描述的 font 的最大 ascent。
 rectangle2dgetmaxcharbounds(graphics context)
          返回指定 graphics 上下文中具有最大边界的字符的边界。
 intgetmaxdecent()
          已过时。 从 jdk version 1.1.1 开始(appeared),由 getmaxdescent() 取代。
 intgetmaxdescent()
          确定此 fontmetrics 对象所描述的 font 的最大 descent。
 rectangle2dgetstringbounds(char[] chars,int beginindex,int limit,graphics context)
          返回指定 graphics 上下文中指定字符数组的边界。
 rectangle2dgetstringbounds(characteriterator ci,int beginindex,int limit,graphics context)
          返回用指定 graphics 上下文中指定 characteriterator 进行索引的字符的边界。
 rectangle2dgetstringbounds(string str,graphics context)
          返回指定 graphics 上下文中指定 string 的边界。
 rectangle2dgetstringbounds(string str,int beginindex,int limit,graphics context)
          返回指定 graphics 上下文中指定 string 的边界。
 int[]getwidths()
          获取此 font 中前 256 个字符的 advance width。
 booleanhasuniformlinemetrics()
          检查 font 是否具有统一的行规格。
 intstringwidth(string str)
          返回此 font 中指定 string 的总 advance width。
 stringtostring()
          返回此 fontmetrics 对象的值的 string 表示形式。
 
从类 java.lang.object 继承的方法
clone, equals, finalize, getclass, hashcode, notify, notifyall, wait, wait, wait
 

字段详细(sense)畔

font

protected font font
实际的 font,字体规格是由此创建的。它不能为 null。

另请参见:
getfont()
构造方法详细信息

fontmetrics

protected fontmetrics(font font)
创建一个新 fontmetrics 对象,用于查找该 font 中关于指定 font 和特定字符字形的 height 和 width 信息。

参数:
font - font
另请参见:
font
方法详细信息

getfont

public font getfont()
获取此 fontmetrics 对象所描述的 font

返回:
fontmetrics 对象所描述的 font

getfontrendercontext

public fontrendercontext getfontrendercontext()
获取此 fontmetrics 对象用来测量文本的 fontrendercontext

注意,此类中带有 graphics 参数的方法测量使用该 graphics 对象的 fontrendercontext 文本,而非此 fontrendercontext

返回:
fontmetrics 对象使用的 fontrendercontext
从以下版本开始:
1.6

getleading

public int getleading()
确定此 fontmetrics 对象所描述的 font标准行间距。标准行间距(或行间间隔)是保留在一个文本行的 descent 和下一个文本行的 ascent 之间的逻辑间隔量。计算 height 规格时要包括(bāo kuò)这一额外间隔。

返回:
font 的标准行间距。
另请参见:
getheight(),getascent(),getdescent()

getascent

public int getascent()
确定此 fontmetrics 对象所描述的 fontfont ascent。font ascent 是字体基线到大多数字母数字字符顶部的距离。在 font 中,有些字符可能(would)扩展超过 font ascent 线。

返回:
font 的 font ascent。
另请参见:
getmaxascent()

getdescent

public int getdescent()
确定此 fontmetrics 对象所描述的 fontfont descent。font descent 是字体基线到大多数字母数字字符底部的距离。在 font 中,有些字符可能扩展到 font descent 线之下。

返回:
font 的 font descent。
另请参见:
getmaxdescent()

”打发时间好去处在Ant’s拼布包教学工作(work)坊里,学生(xué sheng)只须缴付199令吉年费,即可每天无限制地上门学习手缝和机缝拼布包,诚如黄丽萍所言,这里为许多(many)人提供了打发时间的好去处。
“所以,有意上门学习拼布包的学生(xué sheng),都会向我们购买材料,这也是我们能够维持工作(work)坊的动力。
苏用发1947年出生于印尼苏北棉兰市,17岁从父办厂,创建苏钢集团,自任总裁,如今已是印尼着名的“钢铁大王”。
莫哈末阿里在第13届大选弃州攻国,但爆冷败选,他日前指责是华人没有投票(ticket)给他做为对国阵的回报,才导致他败选。
“我们正与南非一家英文(English)报进行洽谈,準备展开合作(cooperation)。
“1990年的万象就像中国(China)的一个村镇,连县城都比不上,现在市中心(zhōng xīn)最宽的澜沧大街,当时路上全是坑洼,一到晚上七八点钟,整个城市(cities)就全黑了。

getheight

public int getheight()
获取此 font 中文(zhōng wén)本行的标准 height。它是相邻文本行基线之间的距离。它是 leading、ascent、descent 的总和。由于(yóu yú)采用了舍入方法,它可能不同于 getascent()、getdescent()、getleading() 的总和。不保证以此距离间隔的文本行是不相交的;如果有些字符超出了标准 ascent 或标准 descent,则这些文本行可能会重叠。

返回:
font 的标准 height。
另请参见:
getleading(),getascent(),getdescent()

getmaxascent

public int getmaxascent()
确定此 fontmetrics 对象所描述的 font 的最大 ascent。字符超出字体基线的距离不会大于此 height。

返回:
font 中所有字符的最大 ascent。
另请参见:
getascent()

getmaxdescent

public int getmaxdescent()
确定此 fontmetrics 对象所描述的 font 的最大 descent。字符低于字体基线的距离不会大于此 height。

返回:
font 中所有字符的最大 descent。
另请参见:
getdescent()

getmaxdecent

@deprecatedpublic int getmaxdecent()
已过时。 从 jdk version 1.1.1 开始,由 getmaxdescent() 取代。

只用于向后兼容性。

返回:
font 中所有字符的最大 descent。
另请参见:
getmaxdescent()

getmaxadvance

public int getmaxadvance()
获取此 font 中所有字符的最大 advance width。advance 是字符串基线上最左边的点到最右边的点之间的距离。string 的 advance 不一定是它所有字符的 advance 之和。

返回:
font 中所有字符的最大 advance width;如果最大 advance width 未知,则返回 -1

charwidth

public int charwidth(int codepoint)
返回此 font 中指定字符的 advance width。advance 是字符基线上最左边的点到最右边的点之间的距离。注意,string 的 advance 不一定是它所有字符的 advance 之和。

此方法没有验证指定的字符是否为一个有效的 unicode 代码点。如有必要,调用者必须使用 character.isvalidcodepoint 验证字符值。

参数:
codepoint - 要测量的字符(unicode 代码点)
返回:
fontmetrics 对象所描述的 font 中指定字符的 advance width。
另请参见:
charswidth(char[], int, int),stringwidth(string)

charwidth

public int charwidth(char ch)
返回此 font 中指定字符的 advance width。advance 是字符基线上最左边的点到最右边的点之间的距离。注意,string 的 advance 不一定是它所有字符的 advance 之和。

注: 此方法无法(to be)处理增补字符。要支持(zhī chí)包括(bāo kuò)增补字符在内的所有 unicode 字符,请使用 charwidth(int) 方法。

参数:
ch - 要测量的字符
返回:
fontmetrics 对象所描述的 font 中指定字符的 advance width。
另请参见:
charswidth(char[], int, int),stringwidth(string)

stringwidth

public int stringwidth(string str)
返回此 font 中指定 string 的总 advance width。advance 是字符串基线上最左边的点到最右边的点之间的距离。

注意,code>string 的 advance 不一定是它所有字符的 advance 之和。

参数:
str - 要测量的 string
返回:
fontmetrics 描述的 font 中指定 string 的 advance width。
抛出:
nullpointerexception - 如果 str 为 null。
另请参见:
byteswidth(byte[], int, int),charswidth(char[], int, int),getstringbounds(string, graphics)

charswidth

public int charswidth(char[] data,     int off,     int len)
返回显示此 font 中指定字符数组的总 advance width。advance 是字符串基线上最左边的点到最右边的点之间的距离。string 的 advance 不一定是它所有字符的 advance 之和。这等同于测量 string 指定范围内的字符。

参数:
data - 要测量的字符数组
off - 数组中字符的起始偏移量
len - 数组中要测量的字符数
返回:
fontmetrics 对象所描述的字体中指定 char 数组子数组的 advance width。
抛出:
nullpointerexception - 如果 data 为 null。
indexoutofboundsexception - 如果 offlen 参数索引字符超出 data 数组范围。
另请参见:
charwidth(int),charwidth(char),byteswidth(byte[], int, int),stringwidth(string)

byteswidth

public int byteswidth(byte[] data,     int off,     int len)
返回显示此 font 中指定字节数组的总 advance width。advance 是字符串基线上最左边的点到最右边的点之间的距离。string 的 advance 不一定是它所有字符的 advance 之和。这等同于测量 string 指定范围内的字符。

参数:
data - 要测量的字节数组
off - 数组中字节的起始偏移量
len - 数组中要测量的字节数
返回:
fontmetrics 对象所描述的 font 中指定 byte 数组的子数组的 advance width。
抛出:
nullpointerexception - 如果 data 为 null。
indexoutofboundsexception - 如果 offlen 参数索引字节超出 data 数组范围。
另请参见:
charswidth(char[], int, int),stringwidth(string)

getwidths

public int[] getwidths()
获取此 font 中前 256 个字符的 advance width。advance 是字符基线上最左边的点到最右边的点之间的距离。注意,string 的 advance 不一定是它所有字符的 advance 之和。

返回:
一个数组,它存储此 fontmetrics 对象所描述的 font 中字符的 advance width。

hasuniformlinemetrics

public boolean hasuniformlinemetrics()
检查 font 是否具有统一的行规格。复合字体可能由几种不同的字体组成,涉及到各种字符集。在此情况下,fontlinemetrics 对象是不统一的。不同的字体可能有不同的 ascent、descent、metrics 等等。对于行测量和行断开来说,此信息有时是必需的。

返回:
如果字体具有统一的行规格,则返回 true;否则返回 false
另请参见:
font.hasuniformlinemetrics()

getlinemetrics

public linemetrics getlinemetrics(string str,       graphics context)
返回指定 graphics 上下文中指定 stringlinemetrics 对象。

参数:
str - 指定的 string
context - 指定的 graphics 上下文
返回:
使用指定 stringgraphics 上下文创建的 linemetrics 对象。
另请参见:
font.getlinemetrics(string, fontrendercontext)

getlinemetrics

public linemetrics getlinemetrics(string str,       int beginindex,       int limit,       graphics context)
返回指定 graphics 上下文中指定 stringlinemetrics 对象。

参数:
str - 指定的 string
beginindex - str 的初始偏移量
limit - str 的结束(End)偏移量
context - 指定的 graphics 上下文
返回:
使用指定 stringjs随机数graphics 上下文创建的 linemetrics 对象。
另请参见:
font.getlinemetrics(string, int, int, fontrendercontext)

getlinemetrics

public linemetrics getlinemetrics(char[] chars,       int beginindex,       int limit,       graphics context)
返回指定 graphics 上下文中指定字符数组的 linemetrics 对象。

参数:
chars - 指定的字符数组
beginindex - chars 的初始偏移量
limit - chars 的结束(End)偏移量
context - 指定的 graphics 上下文
返回:
使用指定字符数组和 graphics 上下文创建的 linemetrics 对象。
另请参见:
font.getlinemetrics(char[], int, int, fontrendercontext)

getlinemetrics

public linemetrics getlinemetrics(characteriterator ci,       int beginindex,       int limit,       graphics context)
返回指定 graphics 上下文中指定 characteriteratorlinemetrics 对象。

参数:
ci - 指定的 characteriterator
beginindex - ci 中的初始偏移量
limit - ci 的结束索引
context - 指定的 graphics 上下文
返回:
使用指定参数创建的 linemetrics网站地图 手机端 对象。
另请参见:
font.getlinemetrics(characteriterator, int, int, fontrendercontext)

getstringbounds

public rectangle2d getstringbounds(string str,      graphics context)
返回指定 graphics 上下文中指定 string 的边界。边界用来对 string 进行布局。

注意:返回的边界在基线相关的坐标内(请参阅类注释)。

参数:
str - 指定的 string
context - 指定的 graphics 上下文
返回:
一个 rectangle2d,它是指定 graphics 上下文中指定 string 的边界框。
另请参见:
font.getstringbounds(string, fontrendercontext)

getstringbounds

public rectangle2d getstringbounds(string str,      int beginindex,      int limit,      graphics context)
返回指定 graphics 上下文中指定 string 的边界。边界用来对 string 进行布局。

注意:返回的边界在基线相关的坐标内(请参阅类注释)。

参数:
str - 指定的 string
beginindex - str 的起始偏移量
limit - str 的结束偏移量
context - 指定的 graphics 上下文
返回:
一个 rectangle2d,它是指定 string 上下文中指定 graphics 的边界框。
另请参见:
font.getstringbounds(string, int, int, fontrendercontext)

getstringbounds

public rectangle2d getstringbounds(char[] chars,      int beginindex,      int limit,      graphics context)
返回指定 graphics 上下文中指定字符数组的边界。边界用来对 string 进行布局,string 是使用指定的字符数组、beginindexlimit 创建的。

注意:返回的边界在基线相关的坐标内(请参阅类注释)。

参数:
chars - 字符数组
beginindex - 字符数组的初始偏移量
limit - 字符数组的结束偏移量
context - 指定的 graphics 上下文
返回:
一个 rectangle2d,它是指定 graphics 上下文中指定字符数组的边界框。
另请参见:
font.getstringbounds(char[], int, int, fontrendercontext)

getstringbounds

public rectangle2d getstringbounds(characteriterator ci,      int beginindex,      int limit,      graphics context)
返回用指定 graphics 上下文中指定 characteriterator 进行索引的字符的边界。

注意:返回的边界在基线相关的坐标内(请参阅类注释)。

参数:
ci - 指定的 characteriterator
beginindex - ci 中的初始偏移量
limit - ci 的结束索引
context - 指定的 graphics 上下文
返回:
一个 rectangle2d,它是用指定 graphics 上下文中的指定 characteriterator 进行索引的字符的边界框。
另请参见:
font.getstringbounds(characteriterator, int, int, fontrendercontext)

getmaxcharbounds

public rectangle2d getmaxcharbounds(graphics context)
返回指定 graphics 上下文中具有最大边界的字符的边界。

参数:
context - 指定的 graphics 上下文
返回:
一个 rectangle2d,它是具有最大边界的字符的边界框。
另请参见:
font.getmaxcharbounds(fontrendercontext)

tostring

public string tostring()
返回此 fontmetrics 对象的值的 string 表示形式。

覆盖:
object 中的 tostring
返回:
fontmetrics 对象的 string 表示形式。
从以下版本开始:
jdk1.0.

javatm platform
standard ed. 6

提交错误或意见(remark)
有关更多的 api 参考资料和开发(kāi fā)人员文档,请参阅 java se 开发(kāi fā)人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 sun microsystems, inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策