NumericShaper (Java Platform SE 6) - JavaTM 2 Platform Standard Edition 6.0 API 规范中文版

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM Platform
Standard Ed. 6

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

java.awt.font
类 NumericShaper

java.lang.Object
  java.awt.font.NumericShaper

所有已实现的接口：: Serializable

public final class NumericShaper
extends Object
implements Serializable
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

字段摘要
`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 进行比较的指定对象
返回：: 如果 o 是 NumericShaper 的一个实例，并且以相同的方式成形，则返回 true；否则返回 false。
另请参见：: Object.equals(java.lang.Object)

toString

public String toString()

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

覆盖：: 类 Object 中的 toString

返回：: 描述此成形器的 String。

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM Platform
Standard Ed. 6

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

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

NumericShaper (Java Platform SE 6) - JavaTM 2 Platform Standard Edition 6.0 API 规范中文版

java.awt.font 类 NumericShaper

EUROPEAN

ARABIC

EASTERN_ARABIC

DEVANAGARI

BENGALI

GURMUKHI

GUJARATI

ORIYA

TAMIL

TELUGU

KANNADA

MALAYALAM

THAI

LAO

TIBETAN

MYANMAR

ETHIOPIC

KHMER

MONGOLIAN

ALL_RANGES

getShaper

getContextualShaper

getContextualShaper

shape

shape

isContextual

getRanges

hashCode

equals

toString

java.awt.font
类 NumericShaper