java.awt.font
类 TextAttribute

java.lang.Object
  java.text.AttributedCharacterIterator.Attribute
      java.awt.font.TextAttribute

所有已实现的接口：

Serializable

public final class TextAttribute
extends AttributedCharacterIterator.Attribute

TextAttribute 类定义用于呈现文本的属性键和属性值。

TextAttribute 实例被用作属性键，标识 Font、TextLayout、AttributedCharacterIterator 和其他处理文本属性的类中的属性。此类中定义的其他常量可以用作属性值。

对于每个文本属性，文档提供了：

• 其值的类型，
• 相关预定义常量（如果有）
• 属性不存在时的默认效果
• 有限制时的有效值
• 效果的描述。

值

• 属性值必须始终是不可变的。
• 在给出值限制的情况下，限制集合以外的任何值都是为将来使用保留的，该值将被视为默认值。
• null 值将被视为默认值并导致默认行为。
• 如果值的类型不正确，则忽略该属性。
• 值的标识无关紧要，只要是实际值即可。例如，TextAttribute.WEIGHT_BOLD 和 new Float(2.0) 指示相同的 WEIGHT。
• Number 类型的属性值（用于 WEIGHT、WIDTH、POSTURE、SIZE、JUSTIFICATION 和 TRACKING）随其自然范围的变化而变化，且不受预定义常量的限制。Number.floatValue() 用于从 Number 中获取实际值。
• WEIGHT、WIDTH 和 POSTURE 的值由系统插入，系统可以选择“最适用的”字体或者其他技巧来大致满足用户请求。

属性摘要

另请参见：

Font, TextLayout, AttributedCharacterIterator, 序列化表格

FAMILY

public static final TextAttribute FAMILY

字体名称的属性键。这些值是 String 的实例。默认值是 "Default"，该值导致使用平台默认字体系列。

Font 类定义用于逻辑字体名称 DIALOG、DIALOG_INPUT、SANS_SERIF、SERIF 和 MONOSPACED 的常量。

这定义了作为 name 传递给 Font 构造方法的值。逻辑字体名称和实际字体名称都允许使用。如果没有发现具有所请求名称的字体，则使用默认字体。

注：此属性不幸被错误命名，因为它指定了外观名称，而不只是系列名称。因此，“Lucida Sans Bold”之类的值会选择该外观（如果存在）。注意，如果请求的外观不存在，则默认字体可以与常规 weight 一起使用。该名称中的“Bold”是外观名称的一部分，而不是字体 weight 为粗体的单独请求。

WEIGHT

public static final TextAttribute WEIGHT

字体 weight 的属性键。这些值是 Number 的实例。默认值为 WEIGHT_REGULAR。

这里提供了一些常量值，请参阅 WEIGHT_EXTRA_LIGHT、WEIGHT_LIGHT、WEIGHT_DEMILIGHT、WEIGHT_REGULAR、WEIGHT_SEMIBOLD、WEIGHT_MEDIUM、WEIGHT_DEMIBOLD、WEIGHT_BOLD、WEIGHT_HEAVY、WEIGHT_EXTRABOLD 和 WEIGHT_ULTRABOLD。WEIGHT_BOLD 值对应于传递给 Font 构造方法的样式值 Font.BOLD。

该值大致为词干宽度与常规 weight 的比。

系统可以插入提供的值。

WEIGHT_EXTRA_LIGHT

public static final Float WEIGHT_EXTRA_LIGHT

最轻的预定义 weight。

另请参见：

WEIGHT

WEIGHT_LIGHT

public static final Float WEIGHT_LIGHT

标准的轻 weight。

另请参见：

WEIGHT

WEIGHT_DEMILIGHT

public static final Float WEIGHT_DEMILIGHT

WEIGHT_LIGHT 和 WEIGHT_STANDARD 之间的中间 weight。

另请参见：

WEIGHT

WEIGHT_REGULAR

public static final Float WEIGHT_REGULAR

标准 weight。这是 WEIGHT 的默认值。

另请参见：

WEIGHT

WEIGHT_SEMIBOLD

public static final Float WEIGHT_SEMIBOLD

比 WEIGHT_REGULAR 稍重的 weight。

另请参见：

WEIGHT

WEIGHT_MEDIUM

public static final Float WEIGHT_MEDIUM

WEIGHT_REGULAR 和 WEIGHT_BOLD 之间的中间 weight。

另请参见：

WEIGHT

WEIGHT_DEMIBOLD

public static final Float WEIGHT_DEMIBOLD

比 WEIGHT_BOLD 稍轻的 weight。

另请参见：

WEIGHT

WEIGHT_BOLD

public static final Float WEIGHT_BOLD

标准的粗体 weight。

另请参见：

WEIGHT

WEIGHT_HEAVY

public static final Float WEIGHT_HEAVY

比 WEIGHT_BOLD 稍重的 weight。

另请参见：

WEIGHT

WEIGHT_EXTRABOLD

public static final Float WEIGHT_EXTRABOLD

特别重的 weight。

另请参见：

WEIGHT

WEIGHT_ULTRABOLD

public static final Float WEIGHT_ULTRABOLD

最重的预定义 weight。

另请参见：

WEIGHT

WIDTH

public static final TextAttribute WIDTH

字体宽度的属性键。这些值是 Number 的实例。默认值为 WIDTH_REGULAR。

这里提供了一些常量值，请参阅 WIDTH_CONDENSED、WIDTH_SEMI_CONDENSED、WIDTH_REGULAR、WIDTH_SEMI_EXTENDED 和 WIDTH_EXTENDED。

该值大致为 advance 宽度与常规宽度的比。

系统可以插入提供的值。

WIDTH_CONDENSED

public static final Float WIDTH_CONDENSED

最精简的预定义 width。

另请参见：

WIDTH

WIDTH_SEMI_CONDENSED

public static final Float WIDTH_SEMI_CONDENSED

适度精简的 width。

另请参见：

WIDTH

WIDTH_REGULAR

public static final Float WIDTH_REGULAR

标准 width。这是 WIDTH 的默认值。

另请参见：

WIDTH

WIDTH_SEMI_EXTENDED

public static final Float WIDTH_SEMI_EXTENDED

适度扩展的 width。

另请参见：

WIDTH

WIDTH_EXTENDED

public static final Float WIDTH_EXTENDED

最大扩展的预定义 width。

另请参见：

WIDTH

POSTURE

public static final TextAttribute POSTURE

字体形态的属性键。这些值是 Number 的实例。默认值为 POSTURE_REGULAR。

这里提供了两个常量值 POSTURE_REGULAR 和 POSTURE_OBLIQUE。POSTURE_OBLIQUE 值对应于传递给 Font 构造方法的样式值 Font.ITALIC。

该值粗略地表示了字体词干的倾斜度，它以邻边除以对边的形式表示。正值表示向右倾斜。

系统可以插入提供的值。

这将会影响字体的倾斜角度，该角度由 Font.getItalicAngle 返回。

另请参见：

Font.getItalicAngle()

POSTURE_REGULAR

public static final Float POSTURE_REGULAR

标准直立形态。这是 POSTURE 的默认值。

另请参见：

POSTURE

POSTURE_OBLIQUE

public static final Float POSTURE_OBLIQUE

标准斜体形态。

另请参见：

POSTURE

SIZE

public static final TextAttribute SIZE

字体大小的属性键。这些值是 Number 的实例。默认值为 12pt。

这对应于 Font 构造方法的 size 参数。

非常大或非常小的大小将影响呈现性能，呈现系统可能不会以这些大小呈现文本。负大小是非法的，会导致使用默认尺寸。

注意，采用 2x 转换的 12pt 字体的外观和规格可能与未转换的 24pt 字体不同。

TRANSFORM

public static final TextAttribute TRANSFORM

字体转换的属性键。这些值是 TransformAttribute 的实例。默认值为 TransformAttribute.IDENTITY。

TransformAttribute 类定义了常量 IDENTITY。

这对应于传递给 Font.deriveFont(AffineTransform) 的转换。由于该转换是可变的，并且 TextAttribute 值不可以为 null，所以使用的是 TransformAttribute 包装器类。

该值主要用于支持缩放和倾斜，但可能还有其他作用。

某些转换会导致基线旋转和/或移位。将文本和基线一起转换，从而文本将遵循新的基线。例如，对于水平基线上的文本，新的基线将遵循通过转换得到的 x 向量单元的方向。文本规格是针对此新基线进行测量的。因此，如果其他属性相同，使用旋转的 TRANSFORM 和非旋转的 TRANSFORM 呈现的文本都将视为具有相同上行高度 (ascent)、下行高度 (descent) 和步进 (advance)。

在样式化文本中，每个这样延伸的基线都将一个接一个地排列，从而可能为整个文本延伸创建一条非线性的基线。有关更多信息，请参阅 TextLayout.getLayoutPath()。

另请参见：

TransformAttribute, AffineTransform

SUPERSCRIPT

public static final TextAttribute SUPERSCRIPT

用于上标和下标的属性键。这些值是 Integer 的实例。默认值为 0，意味着没有使用上标或下标。

这里提供了两个常量值，请参阅 SUPERSCRIPT_SUPER 和 SUPERSCRIPT_SUB。这两个常量的值分别为 1 和 -1。较大的大小值定义上标或下标的较高级别，例如，2 对应于 super-superscript，3 对应于 super-super-superscript，同样地，对于负值和下标，级别可以高达 7（或 -7）。超出此范围的值被保留；这些值代表的行为与平台有关。

SUPERSCRIPT 会影响字体的 ascent 和 descent。但是，ascent 和 descent 始终不能为负。

SUPERSCRIPT_SUPER

public static final Integer SUPERSCRIPT_SUPER

标准上标。

另请参见：

SUPERSCRIPT

SUPERSCRIPT_SUB

public static final Integer SUPERSCRIPT_SUB

标准下标。

另请参见：

SUPERSCRIPT

FONT

public static final TextAttribute FONT

用于提供呈现文本字体的属性键。这些值是 Font 的实例。默认值为 null，指示应该根据属性执行 Font 的正常分辨率。

TextLayout 和 AttributedCharacterIterator 根据 TextAttribute 的 Map 进行工作。通常，所有属性都被检查，并被用于选择和配置 Font 实例。然而，如果存在 FONT 属性，将使用其关联 Font。这为用户提供了一种将字体的分辨率属性重写到 Font，或强制使用特定 Font 实例的方法。这还允许用户在可以子类化 Font 的情况下指定 Font 的子类。

FONT 适用于特殊情形，在这些情形下，客户端已经拥有 Font 实例但是仍然需要使用基于 Map 的 API。通常，Map 中除了 FONT 属性以外没有其他属性。对于基于 Map 的 API，常见情形是单独指定所有属性，因此无需 FONT。

但是，如果 FONT 和其他属性都存在于 Map 中，那么呈现系统会将 Font 中定义的属性与附加属性合并。此合并过程将 TextAttributes 分为两组。一组（“主要”组）被认为是字体的选择和规格行为的基础。这些属性有 FAMILY、WEIGHT、WIDTH、POSTURE、SIZE、TRANSFORM、SUPERSCRIPT 和 TRACKING。另一组（“次要”组）由除了 FONT 自身以外的所有其他已定义属性组成。

要生成新的 Map，首先需要从 FONT 属性获得 Font，并将它的所有 属性提取为一个新的 Map。然后，只将取自原始 Map 的次要 属性添加到新 Map 的属性中。因此，主要属性的值仅取自 Font，而次要属性的值源自 Font，但可以用 Map 中的其他值重写它们。

注：Font 的基于 Map 的构造方法和 deriveFont 方法不处理 FONT 属性，因为这些属性用于创建新的 Font 对象。相反，Font.getFont(Map) 应该用于处理 FONT 属性。

另请参见：

Font

CHAR_REPLACEMENT

public static final TextAttribute CHAR_REPLACEMENT

用于取代字符的字体标准字型显示的用户定义字形的属性键。这些值是 GraphicAttribute 的实例。默认值为 null，指示应该使用字体提供的标准字形。

此属性用于为图形或文本行中嵌入的其他组件保留空间。在执行双向重排序（请参阅 Bidi）时，它对于正确排列“内联”组件在某一行中的位置是必需的。每个字符（Unicode 代码点）都将使用提供的 GraphicAttribute 呈现。通常，应用此属性的字符应是 \uFFFC。

GraphicAttribute 确定文本的逻辑边界和可视边界；实际 Font 值被忽略。

另请参见：

GraphicAttribute

FOREGROUND

public static final TextAttribute FOREGROUND

用于呈现文本的 paint 的属性键。这些值是 Paint 的实例。默认值为 null，指示使用呈现时在 Graphics2D 上设置的 Paint。

无论 Graphics 上设置的 Paint 值是什么，字形都将使用此 Paint 呈现（但是请参阅 SWAP_COLORS）。

另请参见：

Paint, SWAP_COLORS

BACKGROUND

public static final TextAttribute BACKGROUND

用于呈现文本背景的 paint 的属性键。这些值是 Paint 的实例。默认值为 null，指示不应呈现背景。

文本的逻辑边界将使用此 Paint 填充，然后该文本呈现于 Paint 之上（但是请参阅 SWAP_COLORS）。

如果有必要，可以扩展文本的可视边界来包含逻辑边界。轮廓不会受影响。

另请参见：

Paint, SWAP_COLORS

UNDERLINE

public static final TextAttribute UNDERLINE

下划线的属性键。这些值是 Integer 的实例。默认值为 -1，表示没有下划线。

提供的常量值是 UNDERLINE_ON。

下划线可影响可视边界和文本轮廓。

UNDERLINE_ON

public static final Integer UNDERLINE_ON

标准下划线。

另请参见：

UNDERLINE

STRIKETHROUGH

public static final TextAttribute STRIKETHROUGH

删除线的属性键。这些值是 Boolean 的实例。默认值为 false，表示没有删除线。

提供的常量值是 STRIKETHROUGH_ON。

删除线可影响可视边界和文本轮廓。

STRIKETHROUGH_ON

public static final Boolean STRIKETHROUGH_ON

单删除线。

另请参见：

STRIKETHROUGH

RUN_DIRECTION

public static final TextAttribute RUN_DIRECTION

线条延伸方向的属性键。这些值是 Boolean 的实例。默认值为 null，指示用来确定延伸方向的标准 Bidi 算法应该与 Bidi.DIRECTION_DEFAULT_LEFT_TO_RIGHT 值一起使用。

提供的常量是 RUN_DIRECTION_RTL 和 RUN_DIRECTION_LTR。

这确定了传递给 Bidi 构造方法的值，以选择段落中文本的主方向。

注：对于段落中的所有文本，此属性都应该具有相同的值，否则，行为将是不确定的。

另请参见：

Bidi

RUN_DIRECTION_LTR

public static final Boolean RUN_DIRECTION_LTR

从左到右的延伸方向。

另请参见：

RUN_DIRECTION

RUN_DIRECTION_RTL

public static final Boolean RUN_DIRECTION_RTL

从右到左的延伸方向。

另请参见：

RUN_DIRECTION

BIDI_EMBEDDING

public static final TextAttribute BIDI_EMBEDDING

文本嵌入级别的属性键。这些值是 Integer 的实例。默认值为 null，指示在没有显式嵌入的情况下应该使用双向算法。

1 到 61 的正值是嵌入 级别，-1 到 -61 的负值是重写 级别。0 值表示使用基线方向。这些级别被传入 Bidi 构造方法的嵌入级别数组。

注：如果此属性出现在段落中的任何位置，则该段落中的所有 Unicode bidi 控制字符（RLO、LRO、RLE、LRE 和 PDF）都将被忽略，没有此属性的情况下，文本延伸时假定此属性存在，并且属性值为 0。

另请参见：

Bidi

JUSTIFICATION

public static final TextAttribute JUSTIFICATION

段落调整的属性键。这些值是 Number 的实例。默认值为 1，指示调整时应该使用所提供的完整宽度。这些值被限制在 [0..1] 范围内。

提供的常量是 JUSTIFICATION_FULL 和 JUSTIFICATION_NONE。

当请求在 TextLayout 上进行调整时，指定要使用的额外空间部分。例如，如果该线条宽为 50 磅，要求调整到 70 磅，则值 0.75 会使用多余空间的四分之三（或 15 磅）来填补，这样得到的线条长度为 65 磅。

注：对于段落中的所有文本，此属性都应该具有相同的值，否则，行为将是不确定的。

另请参见：

TextLayout.getJustifiedLayout(float)

JUSTIFICATION_FULL

public static final Float JUSTIFICATION_FULL

将线条调整到完整的请求宽度。这是 JUSTIFICATION 的默认值。

另请参见：

JUSTIFICATION

JUSTIFICATION_NONE

public static final Float JUSTIFICATION_NONE

不允许调整线条。

另请参见：

JUSTIFICATION

INPUT_METHOD_HIGHLIGHT

public static final TextAttribute INPUT_METHOD_HIGHLIGHT

用于输入法高亮显示样式的属性键。

这些值是 InputMethodHighlight 或 Annotation 的实例。默认值为 null，指示在呈现前不应该应用输入法样式。

如果需要单独呈现具有相同 InputMethodHighlight 的文本邻近延伸，则应在 Annotation 实例中包装 InputMethodHighlight。

在使用输入法撰写文本时，将使用输入法高亮显示。即使是通常只处理无样式文本的文本编辑组件，也应保留输入法高亮显示，并使它们可用于绘制例程。

另请参见：

Font, InputMethodHighlight, Annotation

INPUT_METHOD_UNDERLINE

public static final TextAttribute INPUT_METHOD_UNDERLINE

输入法下划线的属性键。这些值是 Integer 的实例。默认值为 -1，表示没有下划线。

这里提供了一些常量值，请参阅 UNDERLINE_LOW_ONE_PIXEL、UNDERLINE_LOW_TWO_PIXEL、UNDERLINE_LOW_DOTTED、UNDERLINE_LOW_GRAY 和 UNDERLINE_LOW_DASHED。

如果需要，此值可以与 UNDERLINE 一起使用。该值主要用于输入法。在其他地方使用这些简单装饰下划线可能会使用户迷惑。

输入法下划线可影响可视边界和文本轮廓。

从以下版本开始：

1.3

UNDERLINE_LOW_ONE_PIXEL

public static final Integer UNDERLINE_LOW_ONE_PIXEL

单像素实心低下划线。

从以下版本开始：

1.3

另请参见：

INPUT_METHOD_UNDERLINE

UNDERLINE_LOW_TWO_PIXEL

public static final Integer UNDERLINE_LOW_TWO_PIXEL

双像素实心低下划线。

从以下版本开始：

1.3

另请参见：

INPUT_METHOD_UNDERLINE

UNDERLINE_LOW_DOTTED

public static final Integer UNDERLINE_LOW_DOTTED

单像素点线式低下划线。

从以下版本开始：

1.3

另请参见：

INPUT_METHOD_UNDERLINE

UNDERLINE_LOW_GRAY

public static final Integer UNDERLINE_LOW_GRAY

双像素灰色低下划线。

从以下版本开始：

1.3

另请参见：

INPUT_METHOD_UNDERLINE

UNDERLINE_LOW_DASHED

public static final Integer UNDERLINE_LOW_DASHED

单像素虚线低下划线。

从以下版本开始：

1.3

另请参见：

INPUT_METHOD_UNDERLINE

SWAP_COLORS

public static final TextAttribute SWAP_COLORS

交换前景和背景 Paint 的属性键。这些值是 Boolean 的实例。默认值为 false，表示不交换颜色。

定义的常量值是 SWAP_COLORS_ON。

如果设置 FOREGROUND 属性，则它的 Paint 将被用作背景，否则，将使用当前 Graphics 上的 Paint。如果设置 BACKGROUND 属性，则它的 Paint 将被用作前景，否则，系统将给（已解析）背景找到一种对比色，使文本可见。

另请参见：

FOREGROUND, BACKGROUND

SWAP_COLORS_ON

public static final Boolean SWAP_COLORS_ON

交换前景和背景。

从以下版本开始：

1.3

另请参见：

SWAP_COLORS

NUMERIC_SHAPING

public static final TextAttribute NUMERIC_SHAPING

将 ASCII 十进制数字转换为其他十进制范围数字的属性键。这些值是 NumericShaper 的实例。默认值为 null，表示不执行数字成形。

当定义了一个数字成形器时，在执行其他任何文本分析之前，首先用成形器处理该文本。

注：对于段落中的所有文本，此属性都应该具有相同的值，否则行为将是不确定的。

从以下版本开始：

1.4

另请参见：

NumericShaper

KERNING

public static final TextAttribute KERNING

请求进行字距调整的属性键。这些值是 Integer 的实例。默认值为 0，表示不请求进行字距调整。

提供的常量值是 KERNING_ON。

单个字符的默认 advance 不适合某些字符序列，例如，“To”或“AWAY”。若没有进行字距调整，那么相邻字符看起来好像使用了太多的空格来分隔。字距调整使选定的字符序列采用不同的空格来分隔，以获得更舒适的可视外观。

从以下版本开始：

1.6

KERNING_ON

public static final Integer KERNING_ON

请求标准字距调整。

从以下版本开始：

1.6

另请参见：

KERNING

LIGATURES

public static final TextAttribute LIGATURES

启用可选连字的属性键。这些值是 Integer 的实例。默认值为 0，表示不使用可选的连字。

定义的常量值是 LIGATURES_ON。

始终启用书写系统所需的连字。

从以下版本开始：

1.6

LIGATURES_ON

public static final Integer LIGATURES_ON

请求标准可选连字。

从以下版本开始：

1.6

另请参见：

LIGATURES

TRACKING

public static final TextAttribute TRACKING

控制跟踪的属性键。这些值是 Number 的实例。默认值为 0，表示没有附加的跟踪。

提供的常量值是 TRACKING_TIGHT 和 TRACKING_LOOSE。

跟踪值与字体磅值大小相乘，并通过字体转换传递，以确定要添加到每种字形群的 advance 的附加量。正跟踪值将禁止可选连字格式。跟踪值通常在 -0.1 与 0.3 之间，超出此范围的值通常是不需要的。

从以下版本开始：

1.6

TRACKING_TIGHT

public static final Float TRACKING_TIGHT

执行紧密跟踪。

从以下版本开始：

1.6

另请参见：

TRACKING

TRACKING_LOOSE

public static final Float TRACKING_LOOSE

执行宽松跟踪。

从以下版本开始：

1.6

另请参见：

TRACKING

TextAttribute

protected TextAttribute(String name)

构造一个具有指定名称的 TextAttribute。

参数：

name - 分配给此 TextAttribute 的属性名

readResolve

protected Object readResolve()
                      throws InvalidObjectException

将反序列化的实例解析为预定义常量。

覆盖：

类 AttributedCharacterIterator.Attribute 中的 readResolve

抛出：

InvalidObjectException

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