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版本不兼容。当前的序列化支持适用于短期贮藏或RMI运行相同Swing版本的应用程序之间。为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()` 返回所有的 `ChangeListener`s数组添加到这个stylecontext与addchangelistener()。
`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

- Field Detail
  - DEFAULT_STYLE
```
public static final String DEFAULT_STYLE
```
    给定附加到段落的默认逻辑样式的名称。
    
    另请参见：
    
    Constant Field Values
- Constructor Detail
  - StyleContext
```
public StyleContext()
```
    创建一个新的stylecontext对象。
- 方法详细信息
  - getDefaultStyleContext
```
public static final StyleContext getDefaultStyleContext()
```
    返回默认的attributecontext都懒得定义/供应自己的上下文文件共享。
    
    结果
    
    语境
  - addStyle
```
public Style addStyle(String nm,
                      Style parent)
```
    在样式层次结构中添加一个新样式。样式属性从下向上解决，所以子中指定的属性将覆盖父中指定的属性。
    
    参数
    
    nm -该样式的名称（必须在文件命名样式的集合中是唯一的）。如果样式是未命名的，则该名称可能为空，但调用方负责管理返回的引用作为一个未命名的样式无法获取名称。一位不愿透露姓名的风格可能像字符属性重写如风格运行发现是有用的。
    
    parent -父样式。这可能是空的，如果未指定的属性，不需要在其他一些风格解决。
    
    结果
    
    创作风格
  - 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()
```
    返回所有的 ChangeListeners数组添加到这个stylecontext与addchangelistener()。
    
    结果
    
    所有的 ChangeListeners说如果没有听众已添加一个空数组
    
    从以下版本开始：
    
    一点四
  - getFont
```
public Font getFont(AttributeSet attr)
```
    从属性集获取字体。这是实施尝试获取缓存的字体为给定的attributeset，如果失败，字体的特点是解决，字体是从低级的字体缓存中取出。
    
    参数
    
    attr -属性设置
    
    结果
    
    字体
  - getForeground
```
public Color getForeground(AttributeSet attr)
```
    需要一组属性，并将其变成一个前景颜色规范。这可能是用于指定像更明亮，更色调等默认情况下它只返回由styleconstants前景属性指定的值。
    
    参数
    
    attr -属性设置
    
    结果
    
    颜色
  - getBackground
```
public Color getBackground(AttributeSet attr)
```
    需要一组属性，并将其变成一个背景颜色规范。这可能是用于指定像更明亮，更色调等默认情况下它只返回由styleconstants背景属性指定的值。
    
    参数
    
    attr -属性设置
    
    结果
    
    颜色
  - getFont
```
public Font getFont(String family,
                    int style,
                    int size)
```
    获取一个新字体。如果缓存的字体存在，则返回一个缓存中的字体。如果不是，则将一个字体添加到缓存中。这基本上是一个低级别的缓存，为1.1个字体功能。
    
    参数
    
    family的字体（如“等宽”）
    
    style -字体样式（如字体。平原）
    
    size -点大小> = 1
    
    结果
    
    新的字体
  - getFontMetrics
```
public FontMetrics getFontMetrics(Font f)
```
    返回字体的字体度量。
    
    参数
    
    f -字体
    
    结果
    
    度量
  - addAttribute
```
public AttributeSet addAttribute(AttributeSet old,
                                 Object name,
                                 Object value)
```
    将一个属性添加到给定的集合中，并返回新的有代表性的集合。
    这种方法是线程安全的，虽然大多数摇摆方法不是。更多信息请见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)
```
    向元素添加一组属性。
    这种方法是线程安全的，虽然大多数摇摆方法不是。更多信息请见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)
```
    从集合中移除一个属性。
    这种方法是线程安全的，虽然大多数摇摆方法不是。更多信息请见Concurrency in Swing。
    
    Specified by:
    
    removeAttribute 接口 AbstractDocument.AttributeContext
    
    参数
    
    old -老集的属性
    
    name -非空属性名称
    
    结果
    
    更新的属性集
    
    另请参见：
    
    MutableAttributeSet.removeAttribute(java.lang.Object)
  - removeAttributes
```
public AttributeSet removeAttributes(AttributeSet old,
                                     Enumeration<?> names)
```
    移除元素的一组属性。
    这种方法是线程安全的，虽然大多数摇摆方法不是。更多信息请见Concurrency in Swing。
    
    Specified by:
    
    removeAttributes 接口 AbstractDocument.AttributeContext
    
    参数
    
    old -旧的属性设置
    
    names -属性名称
    
    结果
    
    更新的属性集
    
    另请参见：
    
    MutableAttributeSet.removeAttributes(java.util.Enumeration<?>)
  - removeAttributes
```
public AttributeSet removeAttributes(AttributeSet old,
                                     AttributeSet attrs)
```
    移除元素的一组属性。
    这种方法是线程安全的，虽然大多数摇摆方法不是。更多信息请见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以下，有没有弱引用。这通常被称为Finalize方法的mutableattributeset实施。
    这种方法是线程安全的，虽然大多数摇摆方法不是。更多信息请见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属性。这将尝试恢复键，在当前虚拟机只考虑那些已经与 registerStaticAttributeKey方法注册键的静态对象静态对象。属性检索从流将被放置到特定的集合。
    
    参数
    
    in -对象流读取属性数据。
    
    a -属性设置为将属性定义。
    
    异常
    
    ClassNotFoundException通过向上如果遇到阅读对象的流时。
    
    IOException通过向上如果遇到阅读对象的流时。
  - registerStaticAttributeKey
```
public static void registerStaticAttributeKey(Object key)
```
    将一个对象作为一个静态对象注册为属性集的一个键。这允许键被特殊处理的序列化。
    操作一个1.1的虚拟机下，使用价值由级联的类名toString返回。的toString返回的值不应该在它的类的引用（即应重新实现从对象定义）为了同时重新计算后。
    
    参数
    
    key -非null对象的关键
  - getStaticAttribute
```
public static Object getStaticAttribute(Object key)
```
    返回的对象以前注册的 registerStaticAttributeKey。
  - getStaticAttributeKey
```
public static Object getStaticAttributeKey(Object key)
```
    返回 key将注册的字符串
    
    另请参见：
    
    getStaticAttribute(java.lang.Object)， registerStaticAttributeKey(java.lang.Object)

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class StyleContext

Nested Class Summary

Field Summary

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

Field Detail

DEFAULT_STYLE

Constructor Detail

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