JavaTM Platform
Standard Ed. 6

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 实例被用作属性键,标识 FontTextLayoutAttributedCharacterIterator 和其他处理文本属性的类中的属性。此类中定义的其他常量可以用作属性值。

对于每个文本属性,文档提供了:

属性摘要

值类型 主要常量 默认值
FAMILY String 请参阅 Font DIALOGDIALOG_INPUT
SERIFSANS_SERIFMONOSPACED
"Default"(使用平台默认值)
WEIGHT Number WEIGHT_REGULAR、WEIGHT_BOLD WEIGHT_REGULAR
WIDTH Number WIDTH_CONDENSED、WIDTH_REGULAR 、
WIDTH_EXTENDED
WIDTH_REGULAR
POSTURE Number POSTURE_REGULAR、POSTURE_OBLIQUE POSTURE_REGULAR
SIZE Number 12.0
TRANSFORM TransformAttribute 请参阅 TransformAttribute IDENTITY TransformAttribute.IDENTITY
SUPERSCRIPT Integer SUPERSCRIPT_SUPER、SUPERSCRIPT_SUB 0(使用标准字形和规格)
FONT Font null(不重写字体分辨率)
CHAR_REPLACEMENT GraphicAttribute null(使用字体字形绘制文本)
FOREGROUND Paint null(使用当前图形绘制)
BACKGROUND Paint null(不呈现背景)
UNDERLINE Integer UNDERLINE_ON -1(不呈现下划线)
STRIKETHROUGH Boolean STRIKETHROUGH_ON false(不呈现删除线)
RUN_DIRECTION Boolean RUN_DIRECTION_LTR、
RUN_DIRECTION_RTL
null(使用 Bidi 标准默认值)
BIDI_EMBEDDING Integer 0(使用基线方向)
JUSTIFICATION Number JUSTIFICATION_FULL JUSTIFICATION_FULL
INPUT_METHOD_HIGHLIGHT InputMethodHighlight
Annotation
(参见类) null(不应用输入高亮显示)
INPUT_METHOD_UNDERLINE Integer UNDERLINE_LOW_ONE_PIXEL、
UNDERLINE_LOW_TWO_PIXEL
-1(不呈现下划线)
SWAP_COLORS Boolean SWAP_COLORS_ON false(不交换颜色)
NUMERIC_SHAPING NumericShaper null(不对数字进行定形)
KERNING Integer KERNING_ON 0(不要求进行字距调整)
LIGATURES Integer LIGATURES_ON 0(不形成可选的连字)
TRACKING Number TRACKING_LOOSE、TRACKING_TIGHT 0(不添加跟踪)

另请参见:
Font, TextLayout, AttributedCharacterIterator, 序列化表格

字段摘要
static TextAttribute BACKGROUND
          用于呈现文本背景的 paint 的属性键。
static TextAttribute BIDI_EMBEDDING
          文本嵌入级别的属性键。
static TextAttribute CHAR_REPLACEMENT
          用于取代字符的字体标准字型显示的用户定义字形的属性键。
static TextAttribute FAMILY
          字体名称的属性键。
static TextAttribute FONT
          用于提供呈现文本字体的属性键。
static TextAttribute FOREGROUND
          用于呈现文本的 paint 的属性键。
static TextAttribute INPUT_METHOD_HIGHLIGHT
          用于输入法高亮显示样式的属性键。
static TextAttribute INPUT_METHOD_UNDERLINE
          输入法下划线的属性键。
static TextAttribute JUSTIFICATION
          段落调整的属性键。
static Float JUSTIFICATION_FULL
          将线条调整到完整的请求宽度。
static Float JUSTIFICATION_NONE
          不允许调整线条。
static TextAttribute KERNING
          请求进行字距调整的属性键。
static Integer KERNING_ON
          请求标准字距调整。
static TextAttribute LIGATURES
          启用可选连字的属性键。
static Integer LIGATURES_ON
          请求标准可选连字。
static TextAttribute NUMERIC_SHAPING
          将 ASCII 十进制数字转换为其他十进制范围数字的属性键。
static TextAttribute POSTURE
          字体形态的属性键。
static Float POSTURE_OBLIQUE
          标准斜体形态。
static Float POSTURE_REGULAR
          标准直立形态。
static TextAttribute RUN_DIRECTION
          线条延伸方向的属性键。
static Boolean RUN_DIRECTION_LTR
          从左到右的延伸方向。
static Boolean RUN_DIRECTION_RTL
          从右到左的延伸方向。
static TextAttribute SIZE
          字体大小的属性键。
static TextAttribute STRIKETHROUGH
          删除线的属性键。
static Boolean STRIKETHROUGH_ON
          单删除线。
static TextAttribute SUPERSCRIPT
          用于上标和下标的属性键。
static Integer SUPERSCRIPT_SUB
          标准下标。
static Integer SUPERSCRIPT_SUPER
          标准上标。
static TextAttribute SWAP_COLORS
          交换前景和背景 Paint 的属性键。
static Boolean SWAP_COLORS_ON
          交换前景和背景。
static TextAttribute TRACKING
          控制跟踪的属性键。
static Float TRACKING_LOOSE
          执行宽松跟踪。
static Float TRACKING_TIGHT
          执行紧密跟踪。
static TextAttribute TRANSFORM
          字体转换的属性键。
static TextAttribute UNDERLINE
          下划线的属性键。
static Integer UNDERLINE_LOW_DASHED
          单像素虚线低下划线。
static Integer UNDERLINE_LOW_DOTTED
          单像素点线式低下划线。
static Integer UNDERLINE_LOW_GRAY
          双像素灰色低下划线。
static Integer UNDERLINE_LOW_ONE_PIXEL
          单像素实心低下划线。
static Integer UNDERLINE_LOW_TWO_PIXEL
          双像素实心低下划线。
static Integer UNDERLINE_ON
          标准下划线。
static TextAttribute WEIGHT
          字体 weight 的属性键。
static Float WEIGHT_BOLD
          标准的粗体 weight。
static Float WEIGHT_DEMIBOLD
          比 WEIGHT_BOLD 稍轻的 weight。
static Float WEIGHT_DEMILIGHT
          WEIGHT_LIGHTWEIGHT_STANDARD 之间的中间 weight。
static Float WEIGHT_EXTRA_LIGHT
          最轻的预定义 weight。
static Float WEIGHT_EXTRABOLD
          特别重的 weight。
static Float WEIGHT_HEAVY
          比 WEIGHT_BOLD 稍重的 weight。
static Float WEIGHT_LIGHT
          标准的轻 weight。
static Float WEIGHT_MEDIUM
          WEIGHT_REGULARWEIGHT_BOLD 之间的中间 weight。
static Float WEIGHT_REGULAR
          标准 weight。
static Float WEIGHT_SEMIBOLD
          比 WEIGHT_REGULAR 稍重的 weight。
static Float WEIGHT_ULTRABOLD
          最重的预定义 weight。
static TextAttribute WIDTH
          字体宽度的属性键。
static Float WIDTH_CONDENSED
          最精简的预定义 width。
static Float WIDTH_EXTENDED
          最大扩展的预定义 width。
static Float WIDTH_REGULAR
          标准 width。
static Float WIDTH_SEMI_CONDENSED
          适度精简的 width。
static Float WIDTH_SEMI_EXTENDED
          适度扩展的 width。
 
从类 java.text.AttributedCharacterIterator.Attribute 继承的字段
INPUT_METHOD_SEGMENT, LANGUAGE, READING
 
构造方法摘要
protected TextAttribute(String name)
          构造一个具有指定名称的 TextAttribute
 
方法摘要
protected  Object readResolve()
          将反序列化的实例解析为预定义常量。
 
从类 java.text.AttributedCharacterIterator.Attribute 继承的方法
equals, getName, hashCode, toString
 
从类 java.lang.Object 继承的方法
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

字段详细信息

FAMILY

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

Font 类定义用于逻辑字体名称 DIALOGDIALOG_INPUTSANS_SERIFSERIFMONOSPACED 的常量。

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

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


WEIGHT

public static final TextAttribute WEIGHT
字体 weight 的属性键。这些值是 Number 的实例。默认值为 WEIGHT_REGULAR

这里提供了一些常量值,请参阅 WEIGHT_EXTRA_LIGHTWEIGHT_LIGHTWEIGHT_DEMILIGHTWEIGHT_REGULARWEIGHT_SEMIBOLDWEIGHT_MEDIUMWEIGHT_DEMIBOLDWEIGHT_BOLDWEIGHT_HEAVYWEIGHT_EXTRABOLDWEIGHT_ULTRABOLDWEIGHT_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_LIGHTWEIGHT_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_REGULARWEIGHT_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_CONDENSEDWIDTH_SEMI_CONDENSEDWIDTH_REGULARWIDTH_SEMI_EXTENDEDWIDTH_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_REGULARPOSTURE_OBLIQUEPOSTURE_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_SUPERSUPERSCRIPT_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 的正常分辨率。

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

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

但是,如果 FONT 和其他属性都存在于 Map 中,那么呈现系统会将 Font 中定义的属性与附加属性合并。此合并过程将 TextAttributes 分为两组。一组(“主要”组)被认为是字体的选择和规格行为的基础。这些属性有 FAMILYWEIGHTWIDTHPOSTURESIZETRANSFORMSUPERSCRIPTTRACKING。另一组(“次要”组)由除了 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_RTLRUN_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_FULLJUSTIFICATION_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
用于输入法高亮显示样式的属性键。

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

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

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

另请参见:
Font, InputMethodHighlight, Annotation

INPUT_METHOD_UNDERLINE

public static final TextAttribute INPUT_METHOD_UNDERLINE
输入法下划线的属性键。这些值是 Integer 的实例。默认值为 -1,表示没有下划线。

这里提供了一些常量值,请参阅 UNDERLINE_LOW_ONE_PIXELUNDERLINE_LOW_TWO_PIXELUNDERLINE_LOW_DOTTEDUNDERLINE_LOW_GRAYUNDERLINE_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_TIGHTTRACKING_LOOSE

跟踪值与字体磅值大小相乘,并通过字体转换传递,以确定要添加到每种字形群的 advance 的附加量。正跟踪值将禁止可选连字格式。跟踪值通常在 -0.10.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

JavaTM Platform
Standard Ed. 6

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

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