NumericShaper - [ Java参考文档 ] - 在线原生手册

目录搜索

文字

概述

软件包

类

使用

树

已过时

索引

帮助

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

toString

public String toString()

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

覆盖：: 类 Object 中的 toString

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

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 6

上一个类 下一个类

框架 无框架

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

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

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

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