JavaTM 2 Platform
Standard Ed. 5.0

java.awt
类 FontMetrics

java.lang.Object
  继承者 java.awt.FontMetrics
所有已实现的接口:
Serializable

public abstract class FontMetrics
extends Object
implements Serializable

FontMetrics 类定义了字体规格对象,该对象封装了有关在特定屏幕上呈现特定字体的信息。

关于 subclasser 的注意事项:由于很多这样的格式关闭 (form closed) 方法相互进行递归循环,所以必须注意,在每个这样的循环中至少要实现其中一个方法,以防止在使用子类时产生无穷递归。特别建议,最少要重写以下方法集合,以确保正确性,并防止无穷递归(虽然其他子集也有此功效)。

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

当应用程序要求 AWT 将字符放置在 (x, y) 处时,该字符的放置会使得其引用点(显示为附图中的点)也放置在该位置。引用点指定一条水平线,称为字符的 baseline(基线)。在正常的打印中,字符的 baseline 应该对齐。

此外,字体中的每个字符都具有 ascentdescentadvance width 属性。ascent 是字符超出 baseline 之上的距离。descent 是字符超出 baseline 以下的距离。advance width 指示 AWT 应该放置下一个字符的位置。

字符数组或字符串也可以具有 ascent、descent 和 advance width 属性。数组的 ascent 是数组中所有字符的最大 ascent。descent 是数组中所有字符的最大 descent。advance width 是字符数组中每个字符的 advance width 之和。String 的 advance 是 String 沿 baseline 的距离。此距离是 String 居中或右对齐应该使用的 width。注意,String 的 advance 不一定是所有单独测量的字符的 advance 之和,因为字符的 width 可能随上下文的不同而不同。例如,在 Arabic 文本中,可以更改一个字符的形状,以连接到其他字符。而在有些脚本中,某些字符序列可以由单个形状(称为连字)表示。单独测量的字符并不能说明这些转换。

从以下版本开始:
JDK1.0
另请参见:
Font, 序列化表格

字段摘要
protected  Font font
          实际的 Font,字体规格是由此创建的。
 
构造方法摘要
protected FontMetrics(Font font)
          创建一个新 FontMetrics 对象,用于查找该 Font 中关于指定 Font 和特定字符字形的 height 和 width 信息。
 
方法摘要
 int bytesWidth(byte[] data, int off, int len)
          返回显示此 Font 中指定字节数组的总 advance width。
 int charsWidth(char[] data, int off, int len)
          返回显示此 Font 中指定字符数组的总 advance width。
 int charWidth(char ch)
          返回此 Font 中指定字符的 advance width。
 int charWidth(int codePoint)
          返回此 Font 中指定字符的 advance width。
 int getAscent()
          确定由此 FontMetrics 对象所描述的 Fontfont ascent
 int getDescent()
          确定由此 FontMetrics 对象所描述的 Fontfont descent
 Font getFont()
          获得由此 FontMetrics 对象所描述的 Font
 int getHeight()
          获取此 font 中文本行的标准 height。
 int getLeading()
          确定由此 FontMetrics 对象所描述的 Font标准行间距
 LineMetrics getLineMetrics(char[] chars, int beginIndex, int limit, Graphics context)
          返回指定 Graphics 上下文中指定字符数组的 LineMetrics 对象。
 LineMetrics getLineMetrics(CharacterIterator ci, int beginIndex, int limit, Graphics context)
          返回指定 Graphics 上下文中指定 CharacterIteratorLineMetrics 对象。
 LineMetrics getLineMetrics(String str, Graphics context)
          返回指定 Graphics 上下文中指定 StringLineMetrics 对象。
 LineMetrics getLineMetrics(String str, int beginIndex, int limit, Graphics context)
          返回指定 Graphics 上下文中指定 StringLineMetrics 对象。
 int getMaxAdvance()
          获取此 Font 中所有字符的最大 advance width。
 int getMaxAscent()
          确定由此 FontMetrics 对象所描述的 Font 的最大 ascent。
 Rectangle2D getMaxCharBounds(Graphics context)
          返回指定 Graphics 上下文中具有最大边界的字符的边界。
 int getMaxDecent()
          已过时。 从 JDK version 1.1.1 开始,由 getMaxDescent() 取代。
 int getMaxDescent()
          确定由此 FontMetrics 对象所描述的 Font 的最大 descent。
 Rectangle2D getStringBounds(char[] chars, int beginIndex, int limit, Graphics context)
          返回指定 Graphics 上下文中指定字符数组的边界。
 Rectangle2D getStringBounds(CharacterIterator ci, int beginIndex, int limit, Graphics context)
          返回用指定 Graphics 上下文中的指定 CharacterIterator 进行索引的字符的边界。
 Rectangle2D getStringBounds(String str, Graphics context)
          返回指定 Graphics 上下文中指定 String 的边界。
 Rectangle2D getStringBounds(String str, int beginIndex, int limit, Graphics context)
          返回指定 Graphics 上下文中指定 String 的边界。
 int[] getWidths()
          获取此 Font 中前 256 个字符的 advance width。
 boolean hasUniformLineMetrics()
          检查 Font 是否具有统一的行规格。
 int stringWidth(String str)
          返回此 Font 中指定 String 的总 advance width。
 String toString()
          返回此 FontMetrics 对象的值的 String 表示形式。
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

字段详细信息

font

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

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

FontMetrics

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

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

getFont

public Font getFont()
获得由此 FontMetrics 对象所描述的 Font

返回:
由此 FontMetrics 对象所描述的 Font

getLeading

public int getLeading()
确定由此 FontMetrics 对象所描述的 Font标准行间距。标准行间距(或行间间隔)是保留在一个文本行的 descent 和下一个文本行的 ascent 之间的逻辑间隔量。计算 height 规格时要包括此额外的间隔。

返回:
Font 的标准行间距。
另请参见:
getHeight(), getAscent(), getDescent()

getAscent

public int getAscent()
确定由此 FontMetrics 对象所描述的 Fontfont ascent。font ascent 是字体的 baseline 到大多数字母数字字符顶部的距离。在 Font 中,有些字符可能扩展超过 font ascent 线。

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

getDescent

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

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

getHeight

public int getHeight()
获取此 font 中文本行的标准 height。它是相邻文本行的 baseline 之间的距离。它是 leading、ascent、descent 的总和。由于采用了舍入方法,它可能不同于 getAscent()、getDescent()、getLeading() 的总和。这并不能保证以此距离间隔的文本行是不相交的;如果有些字符超出了标准 ascent 或标准 descent,则这些文本行可能出现重叠部分。

返回:
font 的标准 height。
另请参见:
getLeading(), getAscent(), getDescent()

getMaxAscent

public int getMaxAscent()
确定由此 FontMetrics 对象所描述的 Font 的最大 ascent。字符超出字体的 baseline 的距离不会大于此 height。

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

getMaxDescent

public int getMaxDescent()
确定由此 FontMetrics 对象所描述的 Font 的最大 descent。字符低于字体的 baseline 的距离不会大于此 height。

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

getMaxDecent

@Deprecated
public int getMaxDecent()
已过时。 从 JDK version 1.1.1 开始,由 getMaxDescent() 取代。

只用于向后兼容性。

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

getMaxAdvance

public int getMaxAdvance()
获取此 Font 中所有字符的最大 advance width。advance 是字符串的 baseline 上最左边的点到最右边的点之间的距离。String 的 advance 不一定是它的所有字符的 advance 之和。

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

charWidth

public int charWidth(int codePoint)
返回此 Font 中指定字符的 advance width。advance 是字符的 baseline 上最左边的点到最右边的点之间的距离。注意,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 是字符的 baseline 上最左边的点到最右边的点之间的距离。注意,String 的 advance 不一定是它所有字符的 advance 之和。

注: 此方法无法处理增补字符。要支持包括增补字符在内的所有 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 是字符串的 baseline 上最左边的点到最右边的点之间的距离。

注意,由此方法所返回的总 advance width 没有考虑呈现的上下文。因此,anti-aliasing 和 fractional 的规格提示可能影响 advance 的值。如果启用 anti-aliasing 和 fractional 规格提示,请使用 getStringBounds(String, Graphics) 代替此方法。String 的 advance 不一定是它的所有字符的 advance 之和。

参数:
str - 要测量的 String
返回:
由此 FontMetrics 描述的 Font 中指定 String 的 advance width。
另请参见:
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 是字符串的 baseline 上最左边的点到最右边的点之间的距离。String 的 advance 不一定是它的所有字符的 advance 之和。这等同于测量 String 的指定范围的字符。

参数:
data - 要测量的字符数组
off - 数组中字符的起始偏移量
len - 数组中要测量的字符数
返回:
由此 FontMetrics 对象所描述的字体中指定 char 数组的子数组的 advance width。
另请参见:
charWidth(int), charWidth(char), bytesWidth(byte[], int, int), stringWidth(String)

bytesWidth

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

参数:
data - 要测量的字节数组
off - 数组中字节的起始偏移量
len - 数组中要测量的字节数
返回:
由此 FontMetrics 对象所描述的 Font 中指定 byte 数组的子数组的 advance width。
另请参见:
charsWidth(char[], int, int), stringWidth(String)

getWidths

public int[] getWidths()
获取此 Font 中前 256 个字符的 advance width。advance 是字符的 baseline 上最左边的点到最右边的点之间的距离。注意,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 上下文
返回:
一个 LineMetrics 对象,它使用指定的 StringGraphics 上下文创建。
另请参见:
Font.getLineMetrics(String, FontRenderContext)

getLineMetrics

public LineMetrics getLineMetrics(String str,
                                  int beginIndex,
                                  int limit,
                                  Graphics context)
返回指定 Graphics 上下文中指定 StringLineMetrics 对象。

参数:
str - 指定的 String
beginIndex - str 的初始偏移量
limit - str 的长度
context - 指定的 Graphics 上下文
返回:
一个 LineMetrics 对象,它使用指定的 StringGraphics 上下文创建。
另请参见:
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 的长度
context - 指定的 Graphics 上下文
返回:
一个 LineMetrics 对象,它使用指定的字符数组和 Graphics 上下文创建。
另请参见:
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 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策