StyleSheet (Java Platform SE 8 )

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

All Implemented Interfaces:

Serializable， AbstractDocument.AttributeContext
```
public class StyleSheet
extends StyleContext
```
用于定义HTML视图被渲染的视觉特性的支持。样式表是用来转换成HTML模型视觉特征。这使视图是由一个外观定制，在同一模型的多个视图可以以不同的方式呈现，这可以被认为是一个CSS规则库。CSS属性的关键是css.attribute对象类型。的值的类型是由样式表实现，但需要返回CSS值的字符串表示形式是 toString方法。
HTML视图的实现得到他们的属性的主要切入点是getViewAttributes方法。应实现这一要求，以建立用于将属性与视图关联的所需的策略。每个HTMLEditorKit执行（即因此每个相关的jeditorpane）可以有它自己的样式，但是默认的一张，将所有的HTMLEditorKit执行实例共享。这情况也可以有一个样式表，保存文档特定的CSS规范。

为了减少状态，因此视图存储更轻，样式表可以作为一个画家，处理一些工厂的渲染任务。这允许实现，以确定他们要缓存的是什么，并有可能在一个选择器是常见的多个视图的水平上共享。由于样式表可以由多个文件的看法和一般的HTML属性不影响选择器的使用，共享的潜力巨大。

该规则被存储为命名样式，并且存储其他信息以将元素的上下文快速转换为规则的上下文。下面的代码片段将显示指定的样式，因此CSS规则中。
```
  
   import java.util.*;
   import javax.swing.text.*;
   import javax.swing.text.html.*;
  
   public class ShowStyles {
  
       public static void main(String[] args) {
         HTMLEditorKit kit = new HTMLEditorKit();
         HTMLDocument doc = (HTMLDocument) kit.createDefaultDocument();
         StyleSheet styles = doc.getStyleSheet();
  
         Enumeration rules = styles.getStyleNames();
         while (rules.hasMoreElements()) {
             String name = (String) rules.nextElement();
             Style rule = styles.getStyle(name);
             System.out.println(rule.toString());
         }
         System.exit(0);
       }
   }
  
 
```
语义时，CSS样式应该覆盖的视觉属性的元素定义不明确。例如，HTML <body bgcolor=red>使身体有一个红色的背景。但如果HTML文件也包含CSS规则body { background: blue }变得较不清楚身体的背景应该是什么颜色的。当前的实现给出了在元素中定义的视觉属性的最高优先级，也就是说它们总是在任何样式之前检查过的。因此，在前面的示例中，背景将有一个红色的，因为身体元素定义了红色的背景颜色。

正如已经提到的这个支持CSS。我们不支持完整的CSS规范引用的CSS类Javadoc看什么性质我们支持。两大CSS解析相关的概念，我们目前不支持伪选择器，如A:link { color: red }，和important修饰符。

注：此实现目前是不完整的。它可以替换为完整的替代实现。这一类的未来版本将提供更好的CSS支持。

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`StyleSheet.BoxPainter` 班级开展一些CSS格式化的职责。
`static class`	`StyleSheet.ListPainter` 班级开展一些职责的CSS列表格式。

Nested classes/interfaces inherited from class javax.swing.text.StyleContext
StyleContext.NamedStyle, StyleContext.SmallAttributeSet

Field Summary
- Fields inherited from class javax.swing.text.StyleContext
  DEFAULT_STYLE

构造方法摘要

构造方法
Constructor and Description
`StyleSheet()` 构造样式

方法摘要

所有方法静态方法接口方法具体的方法
Modifier and Type	Method and Description
`AttributeSet`	`addAttribute(AttributeSet old, Object key, Object value)` 将一个属性添加到给定的集合中，并返回新的有代表性的集合。
`AttributeSet`	`addAttributes(AttributeSet old, AttributeSet attr)` 向元素添加一组属性。
`void`	`addCSSAttribute(MutableAttributeSet attr, CSS.Attribute key, String value)` 添加一个CSS属性的设置。
`boolean`	`addCSSAttributeFromHTML(MutableAttributeSet attr, CSS.Attribute key, String value)` 添加一个CSS属性的设置。
`void`	`addRule(String rule)` 在表中添加一组规则。
`void`	`addStyleSheet(StyleSheet ss)` 将样式表 `ss`规则的接受者。
`protected MutableAttributeSet`	`createLargeAttributeSet(AttributeSet a)` 创建一个大的属性集，该属性应关闭时间空间。
`protected StyleContext.SmallAttributeSet`	`createSmallAttributeSet(AttributeSet a)` 创建一个紧凑的属性集，可能共享。
`Color`	`getBackground(AttributeSet a)` 需要一组属性，并将其变成一个背景颜色规范。
`URL`	`getBase()` 返回基地。
`StyleSheet.BoxPainter`	`getBoxPainter(AttributeSet a)` 取盒格式化程序用于特定的CSS属性。
`AttributeSet`	`getDeclaration(String decl)` 翻译一个CSS声明一个attributeset表示CSS声明。
`Font`	`getFont(AttributeSet a)` 取字体使用给定的属性。
`Color`	`getForeground(AttributeSet a)` 需要一组属性，并将其变成一个前景颜色规范。
`static int`	`getIndexOfSize(float pt)`
`StyleSheet.ListPainter`	`getListPainter(AttributeSet a)` 获取列表格式化程序用于特定的CSS属性。
`float`	`getPointSize(int index)` 返回点大小，给定一个大小索引。
`float`	`getPointSize(String size)` 给定一个字符串，如“+ 2”，“- 2”，或“2”，返回一个点大小的值。
`Style`	`getRule(HTML.Tag t, Element e)` 取样式来呈现特定的HTML标签类型。
`Style`	`getRule(String selector)` 获取最佳匹配在字符串形式给出的选择规则。
`StyleSheet[]`	`getStyleSheets()` 返回链接的样式表的数组。
`AttributeSet`	`getViewAttributes(View v)` 取一组属性使用的视图中显示。
`void`	`importStyleSheet(URL url)` 进口 `url`样式表。
`void`	`loadRules(Reader in, URL ref)` 加载一组已在CSS1语法条款的规定。
`AttributeSet`	`removeAttribute(AttributeSet old, Object key)` 从集合中移除一个属性。
`AttributeSet`	`removeAttributes(AttributeSet old, AttributeSet attrs)` 移除一组属性。
`AttributeSet`	`removeAttributes(AttributeSet old, Enumeration<?> names)` 移除元素的一组属性。
`void`	`removeStyle(String nm)` 删除先前添加到文档中的一个命名样式。
`void`	`removeStyleSheet(StyleSheet ss)` 从这些接收器将样式表 `ss`。
`void`	`setBase(URL base)` 设置基地。
`void`	`setBaseFontSize(int sz)` 设置基本字体大小，有效值在7和1之间。
`void`	`setBaseFontSize(String size)` 从字符串传递的基础上设置基本的字体大小。
`Color`	`stringToColor(String string)` 将一个彩色字符串如“红”或“# nnnnnn”色彩。
`AttributeSet`	`translateHTMLToCSS(AttributeSet htmlAttrSet)` 将一组HTML属性相当于设置CSS属性。

Methods inherited from class javax.swing.text.StyleContext
addChangeListener, addStyle, getChangeListeners, getCompressionThreshold, getDefaultStyleContext, getEmptySet, getFont, getFontMetrics, getStaticAttribute, getStaticAttributeKey, getStyle, getStyleNames, readAttributes, readAttributeSet, reclaim, registerStaticAttributeKey, removeChangeListener, toString, writeAttributes, writeAttributeSet

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

- Constructor Detail
  - StyleSheet
```
public StyleSheet()
```
    构造样式
- 方法详细信息
  - getRule
```
public Style getRule(HTML.Tag t,
                     Element e)
```
    取样式来呈现特定的HTML标签类型。给定的元素代表标签，可以用来确定属性将在元素嵌套的情况下不同的情况下的嵌套。
    
    参数
    
    t型转化的视觉属性
    
    e代表标签的元素；元素可以用来确定嵌套的情况下，将不同的属性，如果嵌套在其他元素
    
    结果
    
    CSS的属性设置来渲染标签
  - getRule
```
public Style getRule(String selector)
```
    获取最佳匹配在字符串形式给出的选择规则。在 selector是一个空间的元素名称分隔的字符串。例如， selector可能是“主体”
    返回的样式的属性将更改为规则添加和删除。也就是说，如果你要求一个规则与一个选择器“表P”和一个新的规则添加一个选择器的“P”返回的样式将包括新的属性从规则“P”。
    TR TD
  - addRule
```
public void addRule(String rule)
```
    在表中添加一组规则。规则预计将在有效的CSS格式。通常情况下，这将被调用作为分析一个 <样式> 标签的结果。
  - getDeclaration
```
public AttributeSet getDeclaration(String decl)
```
    翻译一个CSS声明一个attributeset表示CSS声明。这通常会被称为由于遇到HTML样式属性。
  - loadRules
```
public void loadRules(Reader in,
                      URL ref)
               throws IOException
```
    加载一组已在CSS1语法条款的规定。如果有与现有规则的冲突，新规定的规则将赢得。
    
    参数
    
    in -流来读取CSS语法
    
    ref -参考网址。此值表示流的位置，并可能为空。在流中指定的所有相关的网址都将基于此参数。
    
    异常
    
    IOException
  - getViewAttributes
```
public AttributeSet getViewAttributes(View v)
```
    取一组属性使用的视图中显示。这基本上是一套可用于view.getattributes属性。
  - removeStyle
```
public void removeStyle(String nm)
```
    删除先前添加到文档中的一个命名样式。
    
    重写：
    
    removeStyle 方法重写，继承类 StyleContext
    
    参数
    
    nm -风格的名字删除
  - addStyleSheet
```
public void addStyleSheet(StyleSheet ss)
```
    将样式表 ss规则的接受者。 ss's规则将覆盖任何以前添加的样式表规则。一个额外的样式表将不会覆盖接收的样式表规则。
    
    从以下版本开始：
    
    一点三
  - removeStyleSheet
```
public void removeStyleSheet(StyleSheet ss)
```
    从这些接收器将样式表 ss。
    
    从以下版本开始：
    
    一点三
  - getStyleSheets
```
public StyleSheet[] getStyleSheets()
```
    返回链接的样式表的数组。如果没有链接的样式表返回null。
    
    从以下版本开始：
    
    一点三
  - importStyleSheet
```
public void importStyleSheet(URL url)
```
    进口 url样式表。将得到的规则直接添加到接收器。如果你不想规则成为接收机部分，创建一个新的样式表，使用addstylesheet挂靠在。
    
    从以下版本开始：
    
    一点三
  - setBase
```
public void setBase(URL base)
```
    设置基地。这是相对所有的import语句，将相对 base。
    
    从以下版本开始：
    
    一点三
  - getBase
```
public URL getBase()
```
    返回基地。
    
    从以下版本开始：
    
    一点三
  - addCSSAttribute
```
public void addCSSAttribute(MutableAttributeSet attr,
                            CSS.Attribute key,
                            String value)
```
    添加一个CSS属性的设置。
    
    从以下版本开始：
    
    一点三
  - addCSSAttributeFromHTML
```
public boolean addCSSAttributeFromHTML(MutableAttributeSet attr,
                                       CSS.Attribute key,
                                       String value)
```
    添加一个CSS属性的设置。
    
    从以下版本开始：
    
    一点三
  - translateHTMLToCSS
```
public AttributeSet translateHTMLToCSS(AttributeSet htmlAttrSet)
```
    将一组HTML属性相当于设置CSS属性。
    
    参数
    
    htmlAttrSet包含HTML attributeset属性。
  - addAttribute
```
public AttributeSet addAttribute(AttributeSet old,
                                 Object key,
                                 Object value)
```
    将一个属性添加到给定的集合中，并返回新的有代表性的集合。这是重新实现转换styleconstant属性CSS转发到父类的行为之前。的styleconstants属性没有对应的CSS入门，这styleconstants属性存储（但可能未使用）。
    
    Specified by:
    
    addAttribute 接口 AbstractDocument.AttributeContext
    
    重写：
    
    addAttribute 方法重写，继承类 StyleContext
    
    参数
    
    old -旧的属性设置
    
    key -非空属性的关键
    
    value -属性值
    
    结果
    
    更新的属性集
    
    另请参见：
    
    MutableAttributeSet.addAttribute(java.lang.Object, java.lang.Object)
  - addAttributes
```
public AttributeSet addAttributes(AttributeSet old,
                                  AttributeSet attr)
```
    向元素添加一组属性。如果这些属性是styleconstants属性，将它们转换为CSS转发到父类的行为之前。
    
    Specified by:
    
    addAttributes 接口 AbstractDocument.AttributeContext
    
    重写：
    
    addAttributes 方法重写，继承类 StyleContext
    
    参数
    
    old -旧的属性设置
    
    attr -添加属性
    
    结果
    
    更新的属性集
    
    另请参见：
    
    MutableAttributeSet.addAttribute(java.lang.Object, java.lang.Object)
  - removeAttribute
```
public AttributeSet removeAttribute(AttributeSet old,
                                    Object key)
```
    从集合中移除一个属性。如果该属性是一个styleconstants属性，该请求将被转换为一个CSS属性来转发到父类的行为之前。
    
    Specified by:
    
    removeAttribute 接口 AbstractDocument.AttributeContext
    
    重写：
    
    removeAttribute 方法重写，继承类 StyleContext
    
    参数
    
    old -老集的属性
    
    key -非空属性名称
    
    结果
    
    更新的属性集
    
    另请参见：
    
    MutableAttributeSet.removeAttribute(java.lang.Object)
  - removeAttributes
```
public AttributeSet removeAttributes(AttributeSet old,
                                     Enumeration<?> names)
```
    移除元素的一组属性。如果该属性是一个styleconstants属性，该请求将被转换为一个CSS属性来转发到父类的行为之前。
    
    Specified by:
    
    removeAttributes 接口 AbstractDocument.AttributeContext
    
    重写：
    
    removeAttributes 方法重写，继承类 StyleContext
    
    参数
    
    old -旧的属性设置
    
    names -属性名称
    
    结果
    
    更新的属性集
    
    另请参见：
    
    MutableAttributeSet.removeAttributes(java.util.Enumeration<?>)
  - removeAttributes
```
public AttributeSet removeAttributes(AttributeSet old,
                                     AttributeSet attrs)
```
    移除一组属性。如果该属性是一个styleconstants属性，该请求将被转换为一个CSS属性来转发到父类的行为之前。
    
    Specified by:
    
    removeAttributes 接口 AbstractDocument.AttributeContext
    
    重写：
    
    removeAttributes 方法重写，继承类 StyleContext
    
    参数
    
    old -旧的属性设置
    
    attrs -属性
    
    结果
    
    更新的属性集
    
    另请参见：
    
    MutableAttributeSet.removeAttributes(java.util.Enumeration<?>)
  - createSmallAttributeSet
```
protected StyleContext.SmallAttributeSet createSmallAttributeSet(AttributeSet a)
```
    创建一个紧凑的属性集，可能共享。这是一个类，要想改变smallattributeset行为挂钩。这可以重新实现返回一个attributeset提供某种属性的转换。
    
    重写：
    
    createSmallAttributeSet 方法重写，继承类 StyleContext
    
    参数
    
    a -属性在紧凑的形式表示的集合。
  - createLargeAttributeSet
```
protected MutableAttributeSet createLargeAttributeSet(AttributeSet a)
```
    创建一个大的属性集，该属性应关闭时间空间。此集将不会被共享。这是一个类，要想改变较大的属性存储格式的行为挂钩（这是simpleattributeset默认）。这可以重新实现返回一个mutableattributeset提供某种属性的转换。
    
    重写：
    
    createLargeAttributeSet 方法重写，继承类 StyleContext
    
    参数
    
    a -属性在较大的形式表示的集合。
  - getFont
```
public Font getFont(AttributeSet a)
```
    取字体使用给定的属性。
    
    重写：
    
    getFont 方法重写，继承类 StyleContext
    
    参数
    
    a -属性设置
    
    结果
    
    字体
  - getForeground
```
public Color getForeground(AttributeSet a)
```
    需要一组属性，并将其变成一个前景颜色规范。这可能是用来指定的东西，如明亮，更多的色调等。
    
    重写：
    
    getForeground 方法重写，继承类 StyleContext
    
    参数
    
    a -属性设置
    
    结果
    
    颜色
  - getBackground
```
public Color getBackground(AttributeSet a)
```
    需要一组属性，并将其变成一个背景颜色规范。这可能是用来指定的东西，如明亮，更多的色调等。
    
    重写：
    
    getBackground 方法重写，继承类 StyleContext
    
    参数
    
    a -属性设置
    
    结果
    
    颜色
  - getBoxPainter
```
public StyleSheet.BoxPainter getBoxPainter(AttributeSet a)
```
    取盒格式化程序用于特定的CSS属性。
  - getListPainter
```
public StyleSheet.ListPainter getListPainter(AttributeSet a)
```
    获取列表格式化程序用于特定的CSS属性。
  - setBaseFontSize
```
public void setBaseFontSize(int sz)
```
    设置基本字体大小，有效值在7和1之间。
  - setBaseFontSize
```
public void setBaseFontSize(String size)
```
    从字符串传递的基础上设置基本的字体大小。该字符串可以确定一个特定的字体大小，与7和1之间的法律值，或确定一个相对的字体大小，如1或- 2。
  - getIndexOfSize
```
public static int getIndexOfSize(float pt)
```
  - getPointSize
```
public float getPointSize(int index)
```
    返回点大小，给定一个大小索引。
  - getPointSize
```
public float getPointSize(String size)
```
    给定一个字符串，如“+ 2”，“- 2”，或“2”，返回一个点大小的值。
  - stringToColor
```
public Color stringToColor(String string)
```
    将一个彩色字符串如“红”或“# nnnnnn”色彩。注：这只会将html3.2彩色字符串或一个字符串的长度为7；否则，它将返回null。

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 StyleSheet

Nested Class Summary

Nested classes/interfaces inherited from class javax.swing.text.StyleContext

Field Summary

Fields inherited from class javax.swing.text.StyleContext

构造方法摘要

方法摘要

Methods inherited from class javax.swing.text.StyleContext

Methods inherited from class java.lang.Object

Constructor Detail

StyleSheet

方法详细信息

getRule

getRule

addRule

getDeclaration

loadRules

getViewAttributes

removeStyle

addStyleSheet

removeStyleSheet

getStyleSheets

importStyleSheet

setBase

getBase

addCSSAttribute

addCSSAttributeFromHTML

translateHTMLToCSS

addAttribute

addAttributes

removeAttribute

removeAttributes

removeAttributes

createSmallAttributeSet

createLargeAttributeSet

getFont

getForeground

getBackground

getBoxPainter

getListPainter

setBaseFontSize

setBaseFontSize

getIndexOfSize

getPointSize

getPointSize

stringToColor