将拉丁数字转换为其他 Unicode 数字

默认情况下，当文本包含数字值时，这些值使用拉丁(欧洲)数字显示。当首选其他 Unicode 数字形状时，请使用java.awt.font.NumericShaper类。使用NumericShaper API，您可以以任何 Unicode 数字形状显示内部表示为 ASCII 值的数字值。

ArabicDigits示例中的以下代码段显示了如何使用NumericShaper实例将拉丁数字转换为阿拉伯数字。决定整形动作的线为粗体。

ArabicDigitsPanel(String fontname) {
    HashMap map = new HashMap();
    Font font = new Font(fontname, Font.PLAIN, 60);
    map.put(TextAttribute.FONT, font);
    map.put(TextAttribute.NUMERIC_SHAPING,
        NumericShaper.getShaper(NumericShaper.ARABIC));

    FontRenderContext frc = new FontRenderContext(null, false, false);
    layout = new TextLayout(text, map, frc);
}

// ...

public void paint(Graphics g) {
    Graphics2D g2d = (Graphics2D)g;
    layout.draw(g2d, 10, 50);
}

获取阿拉伯数字的NumericShaper实例，并将其放入TextLayout.NUMERIC_SHAPING属性键的HashMap中。哈希 Map 被传递到TextLayout实例。用paint方法渲染文本后，数字将显示在所需的脚本中。在此示例中，拉丁数字 0 到 9 被绘制为阿拉伯数字。

前面的示例使用NumericShaper.ARABIC常量检索所需的整形器，但是NumericShaper类提供了许多语言的常量。这些常量定义为位掩码，并称为NumericShaper 基于位掩码的常量。

基于枚举的范围常量

指定一组特定数字的另一种方法是使用NumericShaper.Range枚举类型(枚举)。 Java SE 7 发行版中引入的该枚举还提供了一组constants。尽管使用不同的机制定义了这些常量，但是NumericShaper.ARABIC位掩码在功能上等效于NumericShaper.Range.ARABIC枚举，并且每种常量类型都有对应的getShaper方法：

• getShaper(int singleRange)

• getShaper(NumericShaper.Range singleRange)

ArabicDigitsEnum示例与 ArabicDigits 示例相同，不同之处在于它使用NumericShaper.Range枚举指定语言脚本：

ArabicDigitsEnumPanel(String fontname) {
    HashMap map = new HashMap();
    Font font = new Font(fontname, Font.PLAIN, 60);
    map.put(TextAttribute.FONT, font);
    map.put(TextAttribute.NUMERIC_SHAPING,
        NumericShaper.getShaper(NumericShaper.Range.ARABIC));
    FontRenderContext frc = new FontRenderContext(null, false, false);
    layout = new TextLayout(text, map, frc);
}

两种getShaper方法都接受singleRange参数。无论使用哪种常量类型，都可以指定脚本特定数字的范围。可以使用OR操作数来组合基于位掩码的常量，也可以创建一组NumericShaper.Range枚举。下面显示了如何使用每种常量类型定义范围：

NumericShaper.MONGOLIAN | NumericShaper.THAI |
NumericShaper.TIBETAN
EnumSet.of(
    NumericShaper.Range.MONGOLIAN,
    NumericShaper.Range.THAI,
    NumericShaper.Range.TIBETAN)

您可以使用_方法(针对基于位掩码的成形器)或getRangeSet方法(针对基于枚举的成形器)来查询NumericShaper对象，以确定其支持的范围。

根据语言上下文渲染数字

ArabicDigits示例旨在将整形器用于特定的语言，但是有时必须根据语言上下文来呈现数字。例如，如果数字前面的文本使用泰语脚本，则首选泰文数字。如果 Literals 以藏文显示，则以藏文数字为佳。

您可以使用getContextualShaper方法之一来完成此操作：

• getContextualShaper(int ranges)

• getContextualShaper(int range，int defaultContext)

• getContextualShaper(Set<NumericShaper.Range> ranges)

• getContextualShaper(Set<NumericShaper.Range> range，NumericShaper.Range defaultContext)

前两种方法使用位掩码常量，后两种使用枚举常量。接受defaultContext参数的方法使您可以指定在文本前显示数值时使用的初始成形器。如果未定义默认上下文，则使用拉丁形状显示任何前导数字。

ShapedDigits示例显示了成型器的工作方式。显示五个文本布局：

• 第一个布局不使用整形器；所有数字都显示为拉丁文。

• 第二种布局将所有数字整形为阿拉伯数字，而与语言环境无关。

• 第三种布局使用使用阿拉伯数字的上下文整形器。默认上下文定义为阿拉伯语。

• 第四个布局使用使用阿拉伯数字的上下文整形器，但是该整形器未指定默认上下文。

• 第五个布局采用了使用ALL_RANGES位掩码的上下文整形器，但是该整形器未指定默认上下文。

以下代码行显示了成形器(如果使用的话)的定义方式：

• 不使用整形器。

• NumericShaper arabic = NumericShaper.getShaper(NumericShaper.ARABIC);

• NumericShaper contextualArabic = NumericShaper.getContextualShaper(NumericShaper.ARABIC, NumericShaper.ARABIC);

• NumericShaper contextualArabicASCII = NumericShaper.getContextualShaper(NumericShaper.ARABIC);

• NumericShaper contextualAll = NumericShaper.getContextualShaper(NumericShaper.ALL_RANGES);

有关更多实现细节，请参见ShapedDigits.java示例。