TextAttribute

BACKGROUND

TextAttribute BACKGROUND

用于绘制文本背景的绘画的属性键。 值是Paint实例。 默认值为null，表示不应渲染背景。

文本的逻辑边界将使用此 Paint填充，然后文本将呈现在顶部（但请参阅 SWAP_COLORS ）。

如有必要，文本的可视范围将扩展至包含逻辑范围。 大纲不受影响。

BIDI_EMBEDDING

TextAttribute BIDI_EMBEDDING

文本嵌入级别的属性键。 值是Integer实例。 默认值是null ，表示双向算法应该在没有明确嵌入的情况下运行。

正值1到61是嵌入级别，负值-1到-61是覆盖级别。 值0表示使用基线方向。 这些级别通过embedding levels数组传递给Bidi构造函数。

注意：如果此属性存在于段落中的任何位置，则该段落中的任何Unicode双向控制字符（RLO，LRO，RLE，LRE和PDF）将被忽略，并且该属性不存在的文本运行将被视为它存在并且具有值0。

CHAR_REPLACEMENT

TextAttribute CHAR_REPLACEMENT

用户自定义字形的属性键代替字符的字体标准字形显示。 值是GraphicAttribute的实例。 默认值为空，表示应使用字体提供的标准字形。

该属性用于为嵌入在文本行中的图形或其他组件预留空间。 在执行双向重新排序（参见Bidi ）时，需要正确定位“在线”组件。 每个字符（Unicode代码点）将使用提供的GraphicAttribute进行渲染。 通常，应用此属性的字符应为\uFFFC 。

GraphicAttribute确定文本的逻辑和视觉范围; 实际的字体值将被忽略。

FAMILY

TextAttribute FAMILY

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

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

这将定义的值作为name传递给Font构造函数。 逻辑和物理字体名称都是允许的。 如果找不到所需名称的字体，则使用默认字体。

注意：不幸的是，这个属性是错误的，因为它指定了脸部名称，而不仅仅是家庭。 因此，如果“Lucida Sans Bold”存在，则会选择该面部。 但请注意，如果请求的脸部不存在，默认情况下将使用常规体重。 名字中的“粗体”是面名的一部分，而不是单独要求字体的粗体。

FONT

TextAttribute FONT

用于提供字体以用于呈现文本的属性键。 默认值为空，表示应该执行属性的Font正常解析。

TextLayout和AttributedCharacterIterator按Maps的TextAttributes 。 通常，所有属性都会被检查并用于选择和配置一个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 。

FOREGROUND

TextAttribute FOREGROUND

用于呈现文本的绘画的属性键。 值是Paint实例。 默认值为空，表示使用渲染时在Paint设置的Graphics2D 。

无论 Graphics （参见 SWAP_COLORS ）上设置的 Paint值如何，使用此 Paint都将呈现字形。

INPUT_METHOD_HIGHLIGHT

TextAttribute INPUT_METHOD_HIGHLIGHT

输入法高亮样式的属性键。 默认值为null ，这意味着输入方法样式不应在渲染前应用。

INPUT_METHOD_UNDERLINE

TextAttribute INPUT_METHOD_UNDERLINE

输入法的属性键加下划线。 值是Integer实例。 默认值是-1 ，这意味着没有下划线。

提供了几个常量值，见 UNDERLINE_LOW_ONE_PIXEL ， UNDERLINE_LOW_TWO_PIXEL ， UNDERLINE_LOW_DOTTED ， UNDERLINE_LOW_GRAY ，并 UNDERLINE_LOW_DASHED 。

如果需要，可以与UNDERLINE一起使用。 主要目的是通过输入法使用。 其他用于简单装饰的下划线可能会混淆用户。

输入法下划线同时影响文本的视觉边界和轮廓。

JUSTIFICATION

TextAttribute JUSTIFICATION

属性键用于一段的理由。 值是Number实例。 缺省值为1，表示对齐应使用提供的全宽。 数值固定在[0..1]的范围内。

提供了常量 JUSTIFICATION_FULL和 JUSTIFICATION_NONE 。

指定在TextLayout上请求对齐时要使用的额外空间的分数。 例如，如果线条宽度为50点并且要求对齐至70点，则0.75值将填充以使用剩余空间的四分之三或15点，以使得所得线条将成为65点长度。

注意：这应该对段落中的所有文本具有相同的值，否则行为不确定。

JUSTIFICATION_FULL

Float JUSTIFICATION_FULL

证明线路满足要求的宽度。 这是JUSTIFICATION的默认值。

JUSTIFICATION_NONE

Float JUSTIFICATION_NONE

不要让这条线是合理的。

KERNING

TextAttribute KERNING

用于请求字距调整的属性键。 值是Integer实例。 默认值是0 ，它不请求字距调整。

提供了常数值 KERNING_ON 。

单个字符的默认前进不适用于某些字符序列，例如“To”或“AWAY”。 如果不加紧，相邻的字符就会被太多空间分隔开来。 字距导致选定的字符序列间隔不同，以获得更令人愉悦的视觉效果。

KERNING_ON

Integer KERNING_ON

请求标准字距。

LIGATURES

TextAttribute LIGATURES

用于启用可选连字的属性键。 值是Integer实例。 默认值是0 ，这意味着不要使用可选连字。

定义了常数值 LIGATURES_ON 。

书写系统所需的连结始终处于启用状态。

LIGATURES_ON

Integer LIGATURES_ON

请求标准可选连字。

NUMERIC_SHAPING

TextAttribute NUMERIC_SHAPING

用于将ASCII十进制数字转换为其他小数范围的属性键。 值是NumericShaper实例。 默认值是null ，这意味着不执行数字整形。

定义数字成形器时，在对文本执行任何其他分析之前，文本首先由成形器处理。

注意：这应该对段落中的所有文本具有相同的值，否则行为不确定。

POSTURE

TextAttribute POSTURE

字体姿态的属性键。 值是Number实例。 默认值是POSTURE_REGULAR 。

提供了两个常数值， POSTURE_REGULAR和POSTURE_OBLIQUE 。 值POSTURE_OBLIQUE对应于传递给Font构造函数的样式值Font.ITALIC 。

该值大致是字体的词根的斜率，表示为上升趋势。 正面价值倾向于正确。

系统可以插入提供的值。

这将影响 Font.getItalicAngle返回的字体斜体角度。

POSTURE_OBLIQUE

Float POSTURE_OBLIQUE

标准的斜体姿势。

POSTURE_REGULAR

Float POSTURE_REGULAR

标准的姿势，直立。 这是POSTURE的默认值。

RUN_DIRECTION

TextAttribute RUN_DIRECTION

行的运行方向的属性键。 值是Boolean实例。 默认值为空，表示用于确定运行方向的标准Bidi算法应与值DIRECTION_DEFAULT_LEFT_TO_RIGHT一起使用。

提供常量 RUN_DIRECTION_RTL和 RUN_DIRECTION_LTR 。

这确定传递给 Bidi构造函数的值以选择段落中文本的主要方向。

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

RUN_DIRECTION_LTR

Boolean RUN_DIRECTION_LTR

从左到右运行方向。

RUN_DIRECTION_RTL

Boolean RUN_DIRECTION_RTL

从右向左运行方向。

SIZE

TextAttribute SIZE

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

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

非常大或小的尺寸会影响渲染性能，渲染系统可能无法以这些尺寸渲染文本。 负尺寸是非法的，并导致默认尺寸。

请注意，带有2x转换的12pt字体的外观和度量可能与不带转换的24点字体的不同。

STRIKETHROUGH

TextAttribute STRIKETHROUGH

删除线的属性键。 值是Boolean实例。 默认值是false ，这意味着没有删除线。

提供了常数值 STRIKETHROUGH_ON 。

删除线同时影响文本的视觉边界和轮廓。

STRIKETHROUGH_ON

Boolean STRIKETHROUGH_ON

一个删除线。

SUPERSCRIPT

TextAttribute SUPERSCRIPT

用于上标和下标的属性键。 值是Integer实例。 默认值为0，表示不使用上标或下标。

提供了两个常数值，参见SUPERSCRIPT_SUPER和SUPERSCRIPT_SUB 。 这些值分别为1和-1。 更大幅度的值定义更高级别的上标或下标，例如，2对应于超上标，3对应于超超标，对于负值和下标也相似，达到7（或-7）的水平。 超出此范围的值是保留的; 行为是依赖于平台的。

SUPERSCRIPT可以影响字体的上升和下降。 然而，上升和下降永远不会变成负面的。

SUPERSCRIPT_SUB

Integer SUPERSCRIPT_SUB

标准下标。

SUPERSCRIPT_SUPER

Integer SUPERSCRIPT_SUPER

标准上标。

SWAP_COLORS

TextAttribute SWAP_COLORS

用于交换前景和背景的属性键Paints 。 值是Boolean实例。 默认值是false ，这意味着不交换颜色。

定义了常量值 SWAP_COLORS_ON 。

如果设置了FOREGROUND属性，则其Paint将用作背景，否则将Paint当前位于Graphics 。 如果设置了BACKGROUND属性，则其Paint将用作前景，否则系统将为（已解析）背景找到对比色，以便文本可见。

SWAP_COLORS_ON

Boolean SWAP_COLORS_ON

交换前景和背景。

TRACKING

TextAttribute TRACKING

用于控制跟踪的属性键。 值是Number实例。 默认值是0 ，这意味着不需要额外的跟踪。

提供了常数值 TRACKING_TIGHT和 TRACKING_LOOSE 。

跟踪值乘以字体点大小并通过字体转换，以确定添加到每个字形群集的前进的额外量。 正值跟踪值将抑制可选连字的形成。 跟踪值通常在-0.1和0.3之间; 这个范围以外的值通常是不需要的。

TRACKING_LOOSE

Float TRACKING_LOOSE

执行松散跟踪。

TRACKING_TIGHT

Float TRACKING_TIGHT

执行紧密跟踪。

TRANSFORM

TextAttribute TRANSFORM

用于字体转换的属性键。 值是TransformAttribute实例。 默认值是TransformAttribute.IDENTITY 。

主要目的是支持缩放和倾斜，尽管其他效果也是可能的。

一些变换将导致基线旋转和/或移位。 文本和基线一起转换，以便文本符合新基线。 例如，对于水平基线上的文本，新基线跟随通过变换的单位x向量的方向。 文本指标是根据这个新的基准来衡量的。 所以，例如，在其他条件相同的情况下，使用旋转的TRANSFORM和未旋转的TRANSFORM呈现的文本将被测量为具有相同的上升，下降和前进。

UNDERLINE

TextAttribute UNDERLINE

下划线的属性键。 值是Integer实例。 默认值是-1，这意味着没有下划线。

提供了常数值 UNDERLINE_ON 。

下划线同时影响文本的视觉边界和轮廓。

UNDERLINE_LOW_DASHED

Integer UNDERLINE_LOW_DASHED

单像素虚线下划线。

UNDERLINE_LOW_DOTTED

Integer UNDERLINE_LOW_DOTTED

单个像素点缀低下划线。

UNDERLINE_LOW_GRAY

Integer UNDERLINE_LOW_GRAY

双像素灰色低下划线。

UNDERLINE_LOW_ONE_PIXEL

Integer UNDERLINE_LOW_ONE_PIXEL

单像素实心低下划线。

UNDERLINE_LOW_TWO_PIXEL

Integer UNDERLINE_LOW_TWO_PIXEL

双像素实心低下划线。

UNDERLINE_ON

Integer UNDERLINE_ON

标准下划线。

WEIGHT

TextAttribute 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_BOLD

Float WEIGHT_BOLD

标准的粗体重量。

WEIGHT_DEMIBOLD

Float WEIGHT_DEMIBOLD

比 WEIGHT_BOLD重。

WEIGHT_DEMILIGHT

Float WEIGHT_DEMILIGHT

介于 WEIGHT_LIGHT和 WEIGHT_STANDARD之间的中间体重。

WEIGHT_EXTRABOLD

Float WEIGHT_EXTRABOLD

一个额外的重量。

WEIGHT_EXTRA_LIGHT

Float WEIGHT_EXTRA_LIGHT

最轻的预定重量。

WEIGHT_HEAVY

Float WEIGHT_HEAVY

比 WEIGHT_BOLD重的重量。

WEIGHT_LIGHT

Float WEIGHT_LIGHT

标准重量轻。

WEIGHT_MEDIUM

Float WEIGHT_MEDIUM

介于 WEIGHT_REGULAR和 WEIGHT_BOLD之间的中间体重。

WEIGHT_REGULAR

Float WEIGHT_REGULAR

标准重量。 这是WEIGHT的默认值。

WEIGHT_SEMIBOLD

Float WEIGHT_SEMIBOLD

比 WEIGHT_REGULAR重的重量。

WEIGHT_ULTRABOLD

Float WEIGHT_ULTRABOLD

最重的预定重量。

WIDTH

TextAttribute WIDTH

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

提供了几个常量值，见 WIDTH_CONDENSED ， WIDTH_SEMI_CONDENSED ， WIDTH_REGULAR ， WIDTH_SEMI_EXTENDED ， WIDTH_EXTENDED 。

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

系统可以插入提供的值。

WIDTH_CONDENSED

Float WIDTH_CONDENSED

最精简的预定义宽度。

WIDTH_EXTENDED

Float WIDTH_EXTENDED

最广泛的预定义宽度。

WIDTH_REGULAR

Float WIDTH_REGULAR

标准宽度。 这是WIDTH的默认值。

WIDTH_SEMI_CONDENSED

Float WIDTH_SEMI_CONDENSED

宽度适中。

WIDTH_SEMI_EXTENDED

Float WIDTH_SEMI_EXTENDED

宽度适中扩展。

TextAttribute

TextAttribute (String name)

用指定名称构造一个 TextAttribute 。

readResolve

Object readResolve ()

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