Module java.desktop
Package javax.swing.text

Interface AttributeSet

已知的所有子接口:
MutableAttributeSet, Style
已知的所有实现类:
AbstractDocument.AbstractElement, AbstractDocument.BranchElement, AbstractDocument.LeafElement, DefaultStyledDocument.SectionElement, HTMLDocument.BlockElement, HTMLDocument.RunElement, SimpleAttributeSet, StyleContext.NamedStyle, StyleContext.SmallAttributeSet
public interface AttributeSet
一组唯一属性的集合。这是一个只读的、不可变的接口。属性基本上是一个键和分配给该键的值。该集合可以表示诸如样式运行、逻辑样式等内容。这些通常用于描述将有助于某些图形表示（如字体）的特性。可能的键集是无界的，可以是任何内容。通常，视图实现将响应属性定义并渲染某些内容以表示这些属性。

属性可能会在层次结构中解析。如果一个键在本地无法解析，并且存在一个解析的父级，则该键将通过父级进行解析。

参见:

  • Nested Class Summary

    Nested Classes
    Modifier and Type
    Interface
    Description
    static interface 
    AttributeSet.CharacterAttribute
    该接口是期望存在于为字符级别呈现做出贡献的任何属性键上的类型签名。
    static interface 
    AttributeSet.ColorAttribute
    该接口是期望存在于为颜色呈现做出贡献的任何属性键上的类型签名。
    static interface 
    AttributeSet.FontAttribute
    该接口是期望存在于为确定要用于呈现某些文本的字体做出贡献的任何属性键上的类型签名。
    static interface 
    AttributeSet.ParagraphAttribute
    该接口是期望存在于为段落级别呈现做出贡献的任何属性键上的类型签名。

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final Object
    NameAttribute
    用于命名属性集合的属性名称。
    static final Object
    ResolveAttribute
    用于标识解析父属性集合的属性名称，如果已定义。

  • Method Summary

    Modifier and Type
    Method
    Description
    boolean
    containsAttribute(Object name, Object value)
    如果此集合定义了具有相同名称和相等值的属性，则返回true。
    boolean
    containsAttributes(AttributeSet attributes)
    如果此集合定义了所有具有相等值的给定集合中的属性，则返回true。
    AttributeSet
    copyAttributes()
    返回一个保证随时间不会更改的属性集。
    Object
    getAttribute(Object key)
    获取给定属性的值。
    int
    getAttributeCount()
    返回在此集合中本地定义的属性数。
    Enumeration<?>
    getAttributeNames()
    返回在集合中本地定义的属性的名称的枚举。
    AttributeSet
    getResolveParent()
    获取解析父级。
    boolean
    isDefined(Object attrName)
    检查在不通过另一个属性集解析的情况下，命名属性是否在集合中具有指定的值。
    boolean
    isEqual(AttributeSet attr)
    确定两个属性集是否等效。

  • Field Details

    • NameAttribute

      static final Object NameAttribute
      用于命名属性集合的属性名称。

    • ResolveAttribute

      static final Object ResolveAttribute
      用于标识解析父属性集合的属性名称，如果已定义。

  • Method Details

    • getAttributeCount

      int getAttributeCount()
      返回在此集合中本地定义的属性数。不包括在父集中定义的属性。
      返回:
      属性数 >= 0

    • isDefined

      boolean isDefined(Object attrName)
      检查在不通过另一个属性集解析的情况下，命名属性是否在集合中具有指定的值。
      参数:
      attrName - 属性名称
      返回:
      如果属性已指定值，则返回true

    • isEqual

      boolean isEqual(AttributeSet attr)
      确定两个属性集是否等效。
      参数:
      attr - 一个属性集
      返回:
      如果两个集合等效，则返回true

    • copyAttributes

      AttributeSet copyAttributes()
      返回一个保证随时间不会更改的属性集。
      返回:
      属性集的副本

    • getAttribute

      Object getAttribute(Object key)
      获取给定属性的值。如果在本地找不到该值，则通过解析父级（如果存在）继续搜索，直到找到该值或没有更多父级为止。如果找不到该值，则返回null。
      参数:
      key - 属性绑定的非空键
      返回:
      属性的值，如果未找到则返回null

    • getAttributeNames

      Enumeration<?> getAttributeNames()
      返回在集合中本地定义的属性名称的枚举。不包括解析父级中定义的属性名称（如果有）。Enumeration的值可以是任何内容，不限于特定的Object类型。

      此方法永远不会返回null。对于没有属性的集合，它返回一个空的Enumeration。

      返回:
      属性名称

    • containsAttribute

      boolean containsAttribute(Object name, Object value)
      如果此集合定义了具有相同名称和相等值的属性，则返回true。如果在本地找不到这样的属性，则将在解析父层次结构中搜索。
      参数:
      name - 非空属性名称
      value - 值
      返回:
      如果集合定义了具有相等值的属性，则返回true，无论是在本地还是通过其解析父级
      抛出:
      NullPointerException - 如果name或value为null

    • containsAttributes

      boolean containsAttributes(AttributeSet attributes)
      如果此集合定义了具有相等值的给定集合中的所有属性，则返回true。如果在本地找不到属性，则将在解析父层次结构中搜索。
      参数:
      attributes - 要检查的属性集
      返回:
      如果此集合定义了所有具有相等值的属性，则返回true，无论是在本地还是通过其解析父级
      抛出:
      NullPointerException - 如果attributes为null

    • getResolveParent

      AttributeSet getResolveParent()
      获取解析父级。
      返回:
      父级