JavaTM Platform
Standard Ed. 6

java.awt.font
类 NumericShaper

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

public final class NumericShaper
extends Object
implements Serializable

NumericShaper 类用于将 Latin-1(欧洲语)数字转换成其他 Unicode 十进制数字。此类的用户主要是那些希望使用民族数字形状显示数据,但又发现使用 Latin-1(欧洲语)数字内部表示该数据更方便的人。此类不能解释过时的数字形状选择器字符 (U+206E)。

NumericShaper 的实例通常用作具有 TextAttribute 类的 NUMERIC_SHAPING 属性的文本属性。例如,以下代码片段可使 TextLayout 将欧洲数字转换成阿拉伯语上下文中的阿拉伯数字:

 Map map = new HashMap();
 map.put(TextAttribute.NUMERIC_SHAPING, 
     NumericShaper.getContextualShaper(NumericShaper.ARABIC));
 FontRenderContext frc = ...;
 TextLayout layout = new TextLayout(text, map, frc);
 layout.draw(g2d, x, y);
 

它还可能使用 NumericShaper 的实例显式执行数字成形,如以下代码片断所演示的:
   char[] text = ...;
   // shape all EUROPEAN digits (except zero) to ARABIC digits
   NumericShaper shaper = NumericShaper.getShaper(NumericShaper.ARABIC);
   shaper.shape(text, start, count);

   // shape European digits to ARABIC digits if preceding text is Arabic, or
   // shape European digits to TAMIL digits if preceding text is Tamil, or
   // leave European digits alone if there is no preceding text, or 
   // preceding text is neither Arabic nor Tamil
   NumericShaper shaper = 
      NumericShaper.getContextualShaper(NumericShaper.ARABIC | 
                                              NumericShaper.TAMIL,
                                              NumericShaper.EUROPEAN);
   shaper.shape(text. start, count);
 

从以下版本开始:
1.4
另请参见:
序列化表格

字段摘要
static int ALL_RANGES
          标识所有的范围,用于完整的上下文成形。
static int ARABIC
          标识 ARABIC 范围和十进制基数。
static int BENGALI
          标识 BENGALI 范围和十进制基数。
static int DEVANAGARI
          标识 DEVANAGARI 范围和十进制基数。
static int EASTERN_ARABIC
          标识 ARABIC 范围和 ARABIC_EXTENDED 十进制基数。
static int ETHIOPIC
          标识 ETHIOPIC 范围和十进制基数。
static int EUROPEAN
          标识 Latin-1(欧洲语)和扩展范围,以及 Latin-1(欧洲语)十进制基数。
static int GUJARATI
          标识 GUJARATI 范围和十进制基数。
static int GURMUKHI
          标识 GURMUKHI 范围和十进制基数。
static int KANNADA
          标识 KANNADA 范围和十进制基数。
static int KHMER
          标识 KHMER 范围和十进制基数。
static int LAO
          标识 LAO 范围和十进制基数。
static int MALAYALAM
          标识 MALAYALAM 范围和十进制基数。
static int MONGOLIAN
          标识 MONGOLIAN 范围和十进制基数。
static int MYANMAR
          标识 MYANMAR 范围和十进制基数。
static int ORIYA
          标识 ORIYA 范围和十进制基数。
static int TAMIL
          标识 TAMIL 范围和十进制基数。
static int TELUGU
          标识 TELUGU 范围和十进制基数。
static int THAI
          标识 THAI 范围和十进制基数。
static int TIBETAN
          标识 TIBETAN 范围和十进制基数。
 
方法摘要
 boolean equals(Object o)
          如果指定的对象是 NumericShaper 的一个实例,并且完全一致地成形到此实例,则返回 true。
static NumericShaper getContextualShaper(int ranges)
          返回提供的 unicode 范围的上下文成形器。
static NumericShaper getContextualShaper(int ranges, int defaultContext)
          返回提供的 unicode 范围的上下文成形器。
 int getRanges()
          返回一个 int,它使用或操作 (OR) 连接所有将成形的范围的值。
static NumericShaper getShaper(int singleRange)
          返回所提供的 unicode 范围的成形器。
 int hashCode()
          返回此成形器的哈希码。
 boolean isContextual()
          返回一个 boolean 值,指示此成形器是否以上下文方式成形。
 void shape(char[] text, int start, int count)
          转换文本中在 start 和 start + count 之间出现的数字。
 void shape(char[] text, int start, int count, int context)
          使用提供的上下文,转换文本中在 start 和 start + count 之间出现的数字。
 String toString()
          返回描述此成形器的 String
 
从类 java.lang.Object 继承的方法
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

字段详细信息

EUROPEAN

public static final int EUROPEAN
标识 Latin-1(欧洲语)和扩展范围,以及 Latin-1(欧洲语)十进制基数。

另请参见:
常量字段值

ARABIC

public static final int ARABIC
标识 ARABIC 范围和十进制基数。

另请参见:
常量字段值

EASTERN_ARABIC

public static final int EASTERN_ARABIC
标识 ARABIC 范围和 ARABIC_EXTENDED 十进制基数。

另请参见:
常量字段值

DEVANAGARI

public static final int DEVANAGARI
标识 DEVANAGARI 范围和十进制基数。

另请参见:
常量字段值

BENGALI

public static final int BENGALI
标识 BENGALI 范围和十进制基数。

另请参见:
常量字段值

GURMUKHI

public static final int GURMUKHI
标识 GURMUKHI 范围和十进制基数。

另请参见:
常量字段值

GUJARATI

public static final int GUJARATI
标识 GUJARATI 范围和十进制基数。

另请参见:
常量字段值

ORIYA

public static final int ORIYA
标识 ORIYA 范围和十进制基数。

另请参见:
常量字段值

TAMIL

public static final int TAMIL
标识 TAMIL 范围和十进制基数。泰米尔语没有十进制数字 0,所以使用 Latin-1(欧洲语)0。

另请参见:
常量字段值

TELUGU

public static final int TELUGU
标识 TELUGU 范围和十进制基数。

另请参见:
常量字段值

KANNADA

public static final int KANNADA
标识 KANNADA 范围和十进制基数。

另请参见:
常量字段值

MALAYALAM

public static final int MALAYALAM
标识 MALAYALAM 范围和十进制基数。

另请参见:
常量字段值

THAI

public static final int THAI
标识 THAI 范围和十进制基数。

另请参见:
常量字段值

LAO

public static final int LAO
标识 LAO 范围和十进制基数。

另请参见:
常量字段值

TIBETAN

public static final int TIBETAN
标识 TIBETAN 范围和十进制基数。

另请参见:
常量字段值

MYANMAR

public static final int MYANMAR
标识 MYANMAR 范围和十进制基数。

另请参见:
常量字段值

ETHIOPIC

public static final int ETHIOPIC
标识 ETHIOPIC 范围和十进制基数。

另请参见:
常量字段值

KHMER

public static final int KHMER
标识 KHMER 范围和十进制基数。

另请参见:
常量字段值

MONGOLIAN

public static final int MONGOLIAN
标识 MONGOLIAN 范围和十进制基数。

另请参见:
常量字段值

ALL_RANGES

public static final int ALL_RANGES
标识所有的范围,用于完整的上下文成形。

另请参见:
常量字段值
方法详细信息

getShaper

public static NumericShaper getShaper(int singleRange)
返回所提供的 unicode 范围的成形器。将所有 Latin-1(欧洲语)数字转换成相应的十进制 unicode 数字。

参数:
singleRange - 指定的 Unicode 范围
返回:
非上下文的数字成形器
抛出:
IllegalArgumentException - 如果范围不是单个范围

getContextualShaper

public static NumericShaper getContextualShaper(int ranges)
返回提供的 unicode 范围的上下文成形器。将 Latin-1(欧洲语)数字转换成与前述文本范围对应的十进制数字(如果该范围是提供的范围之一)。通过或操作连接这些值(如 NumericShaper.ARABIC | NumericShaper.THAI)来表示多个范围。该成形器假定 EUROPEAN 为初始上下文,即如果在字符串中在任何强方向文本之前碰到 EUROPEAN 数字,则该上下文将被假定为 EUROPEAN,因此将不成形数字。

参数:
ranges - 指定的 Unicode 范围
返回:
指定范围的成形器

getContextualShaper

public static NumericShaper getContextualShaper(int ranges,
                                                int defaultContext)
返回提供的 unicode 范围的上下文成形器。将 Latin-1(欧洲语)数字转换成与前述文本范围对应的十进制数字(如果该范围是提供的范围之一)。通过或操作连接这些值(例如 NumericShaper.ARABIC | NumericShaper.THAI)来表示多个范围。该成形器将 defaultContext 用作初始上下文。

参数:
ranges - 指定的 Unicode 范围
defaultContext - 初始上下文,如 NumericShaper.EUROPEAN
返回:
指定 Unicode 范围的成形器。
抛出:
IllegalArgumentException - 如果指定的 defaultContext 不是一个有效范围。

shape

public void shape(char[] text,
                  int start,
                  int count)
转换文本中在 start 和 start + count 之间出现的数字。

参数:
text - 要转换的字符数组
start - 要开始转换的 text 的索引
count - 要转换的 text 中的字符数
抛出:
IndexOutOfBoundsException - 如果 start 或 start + count 超出范围
NullPointerException - 如果 text 为 null

shape

public void shape(char[] text,
                  int start,
                  int count,
                  int context)
使用提供的上下文,转换文本中在 start 和 start + count 之间出现的数字。如果该成形器不是上下文成形器,则忽略上下文。

参数:
text - 字符数组
start - 要开始转换的 text 的索引
count - 要转换的 text 中的字符数
context - 向其转换字符(如 NumericShaper.EUROPEAN)的上下文
抛出:
IndexOutOfBoundsException - 如果 start 或 start + count 超出范围
NullPointerException - 如果 text 为 null
IllegalArgumentException - 如果这是一个上下文成形器,并且指定的 context 不是一个有效范围。

isContextual

public boolean isContextual()
返回一个 boolean 值,指示此成形器是否以上下文方式成形。

返回:
如果此成形器是上下文的,则返回 true;否则返回 false

getRanges

public int getRanges()
返回一个 int,它使用或操作 (OR) 连接所有将成形的范围的值。

例如,要检查成形器是否成形阿拉伯数字,应使用以下语句:

if ((shaper.getRanges() & shaper.ARABIC) != 0) { ...

返回:
要成形的所有范围的值。

hashCode

public int hashCode()
返回此成形器的哈希码。

覆盖:
Object 中的 hashCode
返回:
此成形器的哈希码。
另请参见:
Object.hashCode()

equals

public boolean equals(Object o)
如果指定的对象是 NumericShaper 的一个实例,并且完全一致地成形到此实例,则返回 true。

覆盖:
Object 中的 equals
参数:
o - 要与此 NumericShaper 进行比较的指定对象
返回:
如果 oNumericShaper 的一个实例,并且以相同的方式成形,则返回 true;否则返回 false
另请参见:
Object.equals(java.lang.Object)

toString

public String toString()
返回描述此成形器的 String。该方法仅用于调试目的。

覆盖:
Object 中的 toString
返回:
描述此成形器的 String

JavaTM Platform
Standard Ed. 6

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

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