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);
 

   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

另请参见：

序列化表格

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 进行比较的指定对象

返回：

如果 o 是 NumericShaper 的一个实例，并且以相同的方式成形，则返回 true；否则返回 false。

另请参见：

Object.equals(java.lang.Object)

toString

public String toString()

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

覆盖：

类 Object 中的 toString

返回：

描述此成形器的 String。

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