所有类


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

对于每个文本属性,文档描述了:

  • 属性值的类型,
  • 有限制时的有效值
  • 相关常量
  • 属性值不存在(或值为 null)时的默认效果。
  • 效果的描述。
  • 请求的精确属性不可用时的应变行为。

值的类型

  • 属性值必须始终是不可变的。
  • 在给出限制列表的地方,集合之外的所有值都是为将来使用保留的,当前则被忽略。
  • 如果该值为 null,或类型不正确,那么它将具有默认效果。特定值的效果可以使用插值替换,特别是在具有 Multiple Master 字体的情况下。此插值根据请求值的上面和下面最近定义的常量来计算:
    interpolation = (request - below)/(above - below);

插值

  • 字体应将一些值插入到特定的环境中。例如,当 WEIGHT 的值为 2.13 时。如果字体中上下最近的值是 WEIGHT_BOLD = 2.0 和 WEIGHT_HEAVY = 2.25,则字体将 WEIGHT 请求解释为 BOLD 和 HEAVY 之间 52% 处的效果。如果上下最近的值是 WEIGHT_SEMIBOLD = 1.25 和 WEIGHT_ULTRABOLD = 2.75,则将 WEIGHT 请求解释为 SEMIBOLD 和 ULTRABOLD 之间 58.67% 处的效果。
  • 如果字体没有足够的能力处理给定的请求(如上标),则应模拟到其最佳性能。要确定是否正在执行模拟,客户端应查询该字体,了解使用了哪些实际属性。

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

字段摘要
static TextAttributeBACKGROUND
          背景 Paint 装饰的属性键。
static TextAttributeBIDI_EMBEDDING
          用于嵌套式双向延伸的嵌入级别的属性键。
static TextAttributeCHAR_REPLACEMENT
          用于代替文本中显示的用户定义字形的属性键。
static TextAttributeFAMILY
          用于未本地化字体系列名称的属性键。
static TextAttributeFONT
          用于呈现文本的字体的属性键。
static TextAttributeFOREGROUND
          用于前景 paint 装饰的属性键。
static TextAttributeINPUT_METHOD_HIGHLIGHT
          用于输入方法突出显示样式的属性键。
static TextAttributeINPUT_METHOD_UNDERLINE
          输入方法下划线装饰的属性键。
static TextAttributeJUSTIFICATION
          段落调整的属性键。
static FloatJUSTIFICATION_FULL
          将此行调整到完整的请求宽度。
static FloatJUSTIFICATION_NONE
          不允许调整该行。
static TextAttributeNUMERIC_SHAPING
          将 ASCII 十进制数字转换为其他十进制范围数字的属性键。
static TextAttributePOSTURE
          字体形态的属性键。
static FloatPOSTURE_OBLIQUE
          标准斜体形态。
static FloatPOSTURE_REGULAR
          标准直立形态。
static TextAttributeRUN_DIRECTION
          行延伸方向的属性键。
static BooleanRUN_DIRECTION_LTR
          从左到右的延伸方向。
static BooleanRUN_DIRECTION_RTL
          从右到左的延伸方向。
static TextAttributeSIZE
          字体大小的属性键。
static TextAttributeSTRIKETHROUGH
          删除线装饰的属性键。
static BooleanSTRIKETHROUGH_ON
          单个删除线。
static TextAttributeSUPERSCRIPT
          用于上标和下标的属性键。
static IntegerSUPERSCRIPT_SUB
          标准下标。
static IntegerSUPERSCRIPT_SUPER
          标准上标。
static TextAttributeSWAP_COLORS
          交换前景和背景 Paint(或 Color)的属性键。
static BooleanSWAP_COLORS_ON
          交换前景和背景。
static TextAttributeTRANSFORM
          转换字体的属性键。
static TextAttributeUNDERLINE
          下划线装饰的属性键。
static IntegerUNDERLINE_LOW_DASHED
          单像素短划线低下划线。
static IntegerUNDERLINE_LOW_DOTTED
          单像素点线式低下划线。
static IntegerUNDERLINE_LOW_GRAY
          双像素灰色低下划线。
static IntegerUNDERLINE_LOW_ONE_PIXEL
          单像素实心低下划线。
static IntegerUNDERLINE_LOW_TWO_PIXEL
          双像素实心低下划线。
static IntegerUNDERLINE_ON
          标准下划线,位于用于罗马字体文本的罗马基线处,并在其他文本的下降位置之下。
static TextAttributeWEIGHT
          字体 weight 的属性键。
static FloatWEIGHT_BOLD
          标准的粗体 weight。
static FloatWEIGHT_DEMIBOLD
          比 BOLD 稍轻的 weight。
static FloatWEIGHT_DEMILIGHT
          LIGHT 和 STANDARD 之间的中间 weight。
static FloatWEIGHT_EXTRA_LIGHT
          最轻的预定义 weight。
static FloatWEIGHT_EXTRABOLD
          特别重的 weight。
static FloatWEIGHT_HEAVY
          比 BOLD 稍重的 weight。
static FloatWEIGHT_LIGHT
          标准的轻 weight。
static FloatWEIGHT_MEDIUM
          REGULAR 和 BOLD weight 之间的中间 weight。
static FloatWEIGHT_REGULAR
          标准 weight。
static FloatWEIGHT_SEMIBOLD
          比 REGULAR 稍重的 weight。
static FloatWEIGHT_ULTRABOLD
          最重的预定义 weight。
static TextAttributeWIDTH
          字体宽度的属性键。
static FloatWIDTH_CONDENSED
          最精简的预定义 width。
static FloatWIDTH_EXTENDED
          最宽的预定义 width。
static FloatWIDTH_REGULAR
          标准 width。
static FloatWIDTH_SEMI_CONDENSED
          适度精简的 width。
static FloatWIDTH_SEMI_EXTENDED
          适度扩展的 width。
 
从类 java.text.AttributedCharacterIterator.Attribute 继承的字段
INPUT_METHOD_SEGMENT, LANGUAGE, READING
 
构造方法摘要
protected TextAttribute(String name)
          构造一个具有指定名称的 TextAttribute
 
方法摘要
protected  ObjectreadResolve()
          将反序列化的实例解析成预定义常量。
 
从类 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
用于未本地化字体系列名称的属性键。

FAMILY

String

常量

"Serif", "SansSerif"

默认值

Host default;

描述

字体系列的名称。如果未发现系列名,则使用默认字体。该名称不应是完整的字体名称,或指定了其他属性(如名称 "Helvetica Bold ")。如果该名称与已知的系列名称不匹配,则可能导致使用默认字体。


WEIGHT

public static final TextAttribute WEIGHT
字体 weight 的属性键。

WEIGHT

Float

常量

WEIGHT_EXTRA_LIGHT = 0.5、
WEIGHT_LIGHT = 0.75、
WEIGHT_DEMILIGHT = 0.875、
WEIGHT_REGULAR = 1.0、
WEIGHT_SEMIBOLD = 1.25、
WEIGHT_MEDIUM = 1.5、
WEIGHT_DEMIBOLD = 1.75、
WEIGHT_BOLD = 2.0、
WEIGHT_HEAVY = 2.25、
WEIGHT_EXTRABOLD = 2.5、
WEIGHT_ULTRABOLD = 2.75

默认值

WEIGHT_REGULAR

描述

该值大致为词干宽度与常规 weight 的比。如果字体有一个不同的特定常量值,则按照类描述中的说明插入该值。

应变方法

目前没有。不过,以后可能会使用形状处理
来模拟没有这些属性值的字体的 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
LIGHT 和 STANDARD 之间的中间 weight。

另请参见:
WEIGHT

WEIGHT_REGULAR

public static final Float WEIGHT_REGULAR
标准 weight。如果未指定 WEIGHT,则使用此 weight。

另请参见:
WEIGHT

WEIGHT_SEMIBOLD

public static final Float WEIGHT_SEMIBOLD
比 REGULAR 稍重的 weight。

另请参见:
WEIGHT