StyleContext (Java Platform SE 8 )

java.lang.Object
- javax.swing.text.StyleContext

All Implemented Interfaces:

Serializable ， AbstractDocument.AttributeContext

已知直接子类：

StyleSheet
```
public class StyleContext
extends Object
implements Serializable, AbstractDocument.AttributeContext
```
一组风格及其相关资源。该类通过作为容纳各种样式定义重用的各种资源（如字体和颜色）的缓存的容器来确定一组资源的生命周期。如果需要，可以由多个文档共享，以最大限度地分享相关资源。
这个类还提供了对小组属性的有效支持，并通过共享使用并利用其不变性来压缩它们。由于许多风格被复制，共享的潜力是重要的，副本可以非常便宜。较大的集减少了共享的可能性，因此自动恢复到更少的空间有效的实现。

警告：此类的序列化对象与将来的Swing版本不兼容。当前的序列化支持适用于运行相同版本的Swing的应用程序之间的短期存储或RMI。从1.4开始，对所有JavaBeans的长期存储的支持已被添加到java.beans包中。请参阅XMLEncoder 。

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`class`	`StyleContext.NamedStyle` 属性集合，通常用于表示字符和段落样式。
`class`	`StyleContext.SmallAttributeSet` 该类在数组中保存少量属性。

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`DEFAULT_STYLE` 名称附加到段落的默认逻辑风格。

构造方法摘要

构造方法
Constructor and Description
`StyleContext()` 创建一个新的StyleContext对象。

方法摘要

所有方法静态方法接口方法具体的方法
Modifier and Type	Method and Description
`AttributeSet`	`addAttribute(AttributeSet old, Object name, Object value)` 向给定集添加属性，并返回新的代表集。
`AttributeSet`	`addAttributes(AttributeSet old, AttributeSet attr)` 向元素添加一组属性。
`void`	`addChangeListener(ChangeListener l)` 添加一个侦听器来跟踪何时添加或删除样式。
`Style`	`addStyle(String nm, Style parent)` 在样式层次结构中添加一个新样式。
`protected MutableAttributeSet`	`createLargeAttributeSet(AttributeSet a)` 创建一个大的属性集，应该与时间交换空间。
`protected StyleContext.SmallAttributeSet`	`createSmallAttributeSet(AttributeSet a)` 创建可以共享的一组紧凑的属性。
`Color`	`getBackground(AttributeSet attr)` 获取一组属性并将其转换为背景颜色规范。
`ChangeListener[]`	`getChangeListeners()` 返回使用addChangeListener（）添加到此StyleContext的所有 `ChangeListener`的数组。
`protected int`	`getCompressionThreshold()` 返回尝试压缩到唯一/不可变集合的键/值对的最大数量。
`static StyleContext`	`getDefaultStyleContext()` 返回默认的AttributeContext由所有不想定义/提供自己的上下文的文档共享。
`AttributeSet`	`getEmptySet()` 获取一个空的AttributeSet。
`Font`	`getFont(AttributeSet attr)` 从属性集获取字体。
`Font`	`getFont(String family, int style, int size)` 获取一个新的字体。
`FontMetrics`	`getFontMetrics(Font f)` 返回字体的字体指标。
`Color`	`getForeground(AttributeSet attr)` 获取一组属性，并将其转换为前景颜色规范。
`static Object`	`getStaticAttribute(Object key)` 返回先前使用 `registerStaticAttributeKey`的对象。
`static Object`	`getStaticAttributeKey(Object key)` 返回 `key`的字符串
`Style`	`getStyle(String nm)` 获取先前添加到文档的命名样式
`Enumeration<?>`	`getStyleNames()` 获取定义的样式的名称。
`void`	`readAttributes(ObjectInputStream in, MutableAttributeSet a)` 属性中阅读的上下文特定处理
`static void`	`readAttributeSet(ObjectInputStream in, MutableAttributeSet a)` 从给定的对象输入流读取一组属性，这些属性先前已用 `writeAttributeSet` 。
`void`	`reclaim(AttributeSet a)` 返回MutableAttributeSet实现不再需要的集合。
`static void`	`registerStaticAttributeKey(Object key)` 将对象注册为作为属性集中的键的静态对象。
`AttributeSet`	`removeAttribute(AttributeSet old, Object name)` 从集合中删除属性。
`AttributeSet`	`removeAttributes(AttributeSet old, AttributeSet attrs)` 删除元素的一组属性。
`AttributeSet`	`removeAttributes(AttributeSet old, Enumeration<?> names)` 删除元素的一组属性。
`void`	`removeChangeListener(ChangeListener l)` 删除正在添加或删除的跟踪样式的侦听器。
`void`	`removeStyle(String nm)` 删除之前添加到文档的命名样式。
`String`	`toString()` 将StyleContext转换为字符串。
`void`	`writeAttributes(ObjectOutputStream out, AttributeSet a)` 编写属性的上下文特定处理
`static void`	`writeAttributeSet(ObjectOutputStream out, AttributeSet a)` 将一组属性写入给定的对象流以进行序列化。

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- 字段详细信息
  - DEFAULT_STYLE
```
public static final String DEFAULT_STYLE
```
    名称附加到段落的默认逻辑风格。
    
    另请参见：
    
    Constant Field Values
- 构造方法详细信息
  - StyleContext
```
public StyleContext()
```
    创建一个新的StyleContext对象。
- 方法详细信息
  - getDefaultStyleContext
```
public static final StyleContext getDefaultStyleContext()
```
    返回默认的AttributeContext由所有不想定义/提供自己的上下文的文档共享。
    
    结果
    
    上下文
  - addStyle
```
public Style addStyle(String nm,
                      Style parent)
```
    在样式层次结构中添加一个新样式。样式属性从下到上解析，因此在孩子中指定的属性将覆盖父项中指定的属性。
    
    参数
    
    nm - 样式的名称（在文档中的命名样式集合中必须是唯一的）。如果风格未命名，名称可能为null，但是调用者负责管理返回的引用，因为未命名的样式无法通过名称获取。一个未命名的样式可能对于诸如字符属性覆盖（例如在样式运行中找到）的事情是有用的。
    
    parent - 父风格。如果未指定的属性不需要以某种其他风格解析，则此值可能为null。
    
    结果
    
    创建的风格
  - removeStyle
```
public void removeStyle(String nm)
```
    删除之前添加到文档的命名样式。
    
    参数
    
    nm - 要删除的样式的名称
  - getStyle
```
public Style getStyle(String nm)
```
    获取先前添加到文档的命名样式
    
    参数
    
    nm - 风格的名称
    
    结果
    
    样式
  - getStyleNames
```
public Enumeration<?> getStyleNames()
```
    获取定义的样式的名称。
    
    结果
    
    名称列表作为枚举
  - addChangeListener
```
public void addChangeListener(ChangeListener l)
```
    添加一个侦听器来跟踪何时添加或删除样式。
    
    参数
    
    l - 变更听众
  - removeChangeListener
```
public void removeChangeListener(ChangeListener l)
```
    删除正在添加或删除的跟踪样式的侦听器。
    
    参数
    
    l - 变更听众
  - getChangeListeners
```
public ChangeListener[] getChangeListeners()
```
    返回使用addChangeListener（）添加到此StyleContext的所有 ChangeListener的数组。
    
    结果
    
    所有的 ChangeListener被添加或一个空的数组，如果没有收听者被添加
    
    从以下版本开始：
    
    1.4
  - getFont
```
public Font getFont(AttributeSet attr)
```
    从属性集获取字体。这是为了为给定的AttributeSet尝试并获取缓存的字体而实现的，如果失败，则解析字体功能，并从低级字体缓存中提取字体。
    
    参数
    
    attr - 属性集
    
    结果
    
    字体
  - getForeground
```
public Color getForeground(AttributeSet attr)
```
    获取一组属性，并将其转换为前景颜色规范。这可能用于指定更亮，更多色调等的内容。默认情况下，它只返回由StyleConstants.Foreground属性指定的值。
    
    参数
    
    attr - 属性集
    
    结果
    
    颜色
  - getBackground
```
public Color getBackground(AttributeSet attr)
```
    获取一组属性并将其转换为背景颜色规范。这可能用于指定更亮，更多色调等的内容。默认情况下，它只返回由StyleConstants.Background属性指定的值。
    
    参数
    
    attr - 属性集
    
    结果
    
    颜色
  - getFont
```
public Font getFont(String family,
                    int style,
                    int size)
```
    获取一个新的字体。如果存在高速缓存的字体，则从缓存返回一个字体。如果没有，则会将一个字体添加到缓存中。这基本上是1.1级字体功能的低级缓存。
    
    参数
    
    family - 字体系列（如“Monospaced”）
    
    style - 字体的样式（如Font.PLAIN）
    
    size - 点大小> = 1
    
    结果
    
    新的字体
  - getFontMetrics
```
public FontMetrics getFontMetrics(Font f)
```
    返回字体的字体指标。
    
    参数
    
    f - 字体
    
    结果
    
    指标
  - addAttribute
```
public AttributeSet addAttribute(AttributeSet old,
                                 Object name,
                                 Object value)
```
    向给定集添加属性，并返回新的代表集。
    这种方法是线程安全的，尽管大多数Swing方法都不是。有关详细信息，请参阅Concurrency in Swing。
    
    Specified by:
    
    addAttribute在接口 AbstractDocument.AttributeContext
    
    参数
    
    old - 旧属性集
    
    name - 非空属性名称
    
    value - 属性值
    
    结果
    
    更新的属性集
    
    另请参见：
    
    MutableAttributeSet.addAttribute(java.lang.Object, java.lang.Object)
  - addAttributes
```
public AttributeSet addAttributes(AttributeSet old,
                                  AttributeSet attr)
```
    向元素添加一组属性。
    这种方法是线程安全的，尽管大多数Swing方法都不是。请参阅Concurrency in Swing以获取更多信息。
    
    Specified by:
    
    addAttributes在接口 AbstractDocument.AttributeContext
    
    参数
    
    old - 旧属性集
    
    attr - 要添加的属性
    
    结果
    
    更新的属性集
    
    另请参见：
    
    MutableAttributeSet.addAttribute(java.lang.Object, java.lang.Object)
  - removeAttribute
```
public AttributeSet removeAttribute(AttributeSet old,
                                    Object name)
```
    从集合中删除属性。
    这种方法是线程安全的，尽管大多数Swing方法都不是。请参阅Concurrency in Swing了解更多信息。
    
    Specified by:
    
    removeAttribute在界面 AbstractDocument.AttributeContext
    
    参数
    
    old - 旧集属性
    
    name - 非空属性名称
    
    结果
    
    更新的属性集
    
    另请参见：
    
    MutableAttributeSet.removeAttribute(java.lang.Object)
  - removeAttributes
```
public AttributeSet removeAttributes(AttributeSet old,
                                     Enumeration<?> names)
```
    删除元素的一组属性。
    这种方法是线程安全的，尽管大多数Swing方法都不是。有关详细信息，请参阅Concurrency in Swing。
    
    Specified by:
    
    removeAttributes在界面 AbstractDocument.AttributeContext
    
    参数
    
    old - 旧属性集
    
    names - 属性名称
    
    结果
    
    更新的属性集
    
    另请参见：
    
    MutableAttributeSet.removeAttributes(java.util.Enumeration<?>)
  - removeAttributes
```
public AttributeSet removeAttributes(AttributeSet old,
                                     AttributeSet attrs)
```
    删除元素的一组属性。
    这种方法是线程安全的，尽管大多数Swing方法都不是。请参阅Concurrency in Swing了解更多信息。
    
    Specified by:
    
    removeAttributes在界面 AbstractDocument.AttributeContext
    
    参数
    
    old - 旧属性集
    
    attrs - 属性
    
    结果
    
    更新的属性集
    
    另请参见：
    
    MutableAttributeSet.removeAttributes(java.util.Enumeration<?>)
  - getEmptySet
```
public AttributeSet getEmptySet()
```
    获取一个空的AttributeSet。
    
    Specified by:
    
    getEmptySet在接口 AbstractDocument.AttributeContext
    
    结果
    
    集合
  - reclaim
```
public void reclaim(AttributeSet a)
```
    返回MutableAttributeSet实现不再需要的集合。这对于1.1中没有弱参考的操作很有用。这通常将通过MutableAttributeSet实现的finalize方法来调用。
    这种方法是线程安全的，尽管大多数Swing方法都不是。请参阅Concurrency in Swing了解更多信息。
    
    Specified by:
    
    reclaim在界面 AbstractDocument.AttributeContext
    
    参数
    
    a - 设置回收
  - getCompressionThreshold
```
protected int getCompressionThreshold()
```
    返回尝试压缩到唯一/不可变集合的键/值对的最大数量。任何高于此限制的集合都将使用散列表，并且是一个MutableAttributeSet。
    
    结果
    
    门槛
  - createSmallAttributeSet
```
protected StyleContext.SmallAttributeSet createSmallAttributeSet(AttributeSet a)
```
    创建可以共享的一组紧凑的属性。这是一个希望改变SmallAttributeSet行为的子类的钩子。这可以被重新实现以返回提供某种属性转换的AttributeSet。
    
    参数
    
    a - 以紧凑形式表示的属性集。
  - createLargeAttributeSet
```
protected MutableAttributeSet createLargeAttributeSet(AttributeSet a)
```
    创建一个大的属性集，应该与时间交换空间。此集不会共享。这是一个希望更改较大属性存储格式（默认情况下为SimpleAttributeSet）的行为的子类的钩子。这可以重新实现，以返回提供某种属性转换的MutableAttributeSet。
    
    参数
    
    a - 要以较大形式表示的属性集。
  - toString
```
public String toString()
```
    将StyleContext转换为字符串。
    
    重写：
    
    toString在 Object
    
    结果
    
    字符串
  - writeAttributes
```
public void writeAttributes(ObjectOutputStream out,
                            AttributeSet a)
                     throws IOException
```
    编写属性的上下文特定处理
    
    异常
    
    IOException
  - readAttributes
```
public void readAttributes(ObjectInputStream in,
                           MutableAttributeSet a)
                    throws ClassNotFoundException,
                           IOException
```
    属性中阅读的上下文特定处理
    
    异常
    
    ClassNotFoundException
    
    IOException
  - writeAttributeSet
```
public static void writeAttributeSet(ObjectOutputStream out,
                                     AttributeSet a)
                              throws IOException
```
    将一组属性写入给定的对象流以进行序列化。这将特别小心处理已经注册的registerStaticAttributeKey方法的静态属性键。没有注册为静态密钥的任何属性键将被直接序列化。所有值都可以序列化。
    
    参数
    
    out - 输出流
    
    a - 属性集
    
    异常
    
    IOException - 任何I / O错误
  - readAttributeSet
```
public static void readAttributeSet(ObjectInputStream in,
                                    MutableAttributeSet a)
                             throws ClassNotFoundException,
                                    IOException
```
    从先前用writeAttributeSet写出的给定对象输入流中读取一组writeAttributeSet 。这将尝试将仅静态对象的键恢复到当前虚拟机中的静态对象，仅考虑已使用registerStaticAttributeKey方法注册的那些键。从流中检索的属性将被放置在给定的可变集中。
    
    参数
    
    in - 从中读取属性数据的对象流。
    
    a - 设置 a的属性集。
    
    异常
    
    ClassNotFoundException - 读取对象流时遇到上传。
    
    IOException - 读取对象流时遇到上传。
  - registerStaticAttributeKey
```
public static void registerStaticAttributeKey(Object key)
```
    将对象注册为作为属性集中的键的静态对象。这允许密钥被特别处理以进行序列化。
    对于在1.1虚拟机下运行，这将使用toString返回的值连接到类名。 toString返回的值不应该在其中引用类引用（即它应该从Object中的定义中重新实现），以便在稍后重新计算时才能相同。
    
    参数
    
    key - 非空对象密钥
  - getStaticAttribute
```
public static Object getStaticAttribute(Object key)
```
    返回先前使用 registerStaticAttributeKey的对象。
  - getStaticAttributeKey
```
public static Object getStaticAttributeKey(Object key)
```
    返回 key的字符串
    
    另请参见：
    
    getStaticAttribute(java.lang.Object) ， registerStaticAttributeKey(java.lang.Object)

Class StyleContext

Nested Class Summary

Field Summary

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

字段详细信息

DEFAULT_STYLE

构造方法详细信息

StyleContext

方法详细信息

getDefaultStyleContext

addStyle

removeStyle

getStyle

getStyleNames

addChangeListener

removeChangeListener

getChangeListeners

getFont

getForeground

getBackground

getFont

getFontMetrics

addAttribute

addAttributes

removeAttribute

removeAttributes

removeAttributes

getEmptySet

reclaim

getCompressionThreshold

createSmallAttributeSet

createLargeAttributeSet

toString

writeAttributes

readAttributes

writeAttributeSet

readAttributeSet

registerStaticAttributeKey

getStaticAttribute

getStaticAttributeKey