Module java.desktop
Package javax.swing.text

Interface StyledDocument

所有超接口:
Document
所有已知实现类:
DefaultStyledDocument, HTMLDocument

public interface StyledDocument extends Document
通用样式文档的接口。
  • Method Details

    • addStyle

      Style addStyle(String nm, Style parent)
      将新样式添加到逻辑样式层次结构中。样式属性从下到上解析,因此在子级别指定的属性将覆盖父级别指定的属性。
      参数:
      nm - 样式的名称(在命名样式集合中必须是唯一的)。如果样式未命名,则名称可以为null,但调用者负责管理返回的未命名样式的引用。未命名样式可能对于诸如样式运行中发现的字符属性覆盖之类的事情很有用。
      parent - 父样式。如果未指定属性,则此参数可以为null,不需要在其他样式中解析未指定的属性。
      返回:
      样式
    • removeStyle

      void removeStyle(String nm)
      从文档中删除先前添加的命名样式。
      参数:
      nm - 要删除的样式的名称
    • getStyle

      Style getStyle(String nm)
      获取先前添加的命名样式。
      参数:
      nm - 样式的名称
      返回:
      样式
    • setCharacterAttributes

      void setCharacterAttributes(int offset, int length, AttributeSet s, boolean replace)
      更改文档中现有内容范围的内容元素属性。将给定Attributes参数中定义的所有属性应用于给定范围。可以通过提供未定义任何属性的Attributes参数并将replace设置为true来完全删除给定范围的所有内容级别属性。
      参数:
      offset - 更改的起始位置 >= 0
      length - 更改的长度 >= 0
      s - 要更改为的非null属性。任何定义的属性将应用于给定范围的文本。
      replace - 指示是否在设置新属性之前应清除先前的属性。如果为true,则操作将完全替换先前的属性。如果为false,则新属性将与先前的属性合并。
    • setParagraphAttributes

      void setParagraphAttributes(int offset, int length, AttributeSet s, boolean replace)
      设置段落属性。
      参数:
      offset - 更改的起始位置 >= 0
      length - 更改的长度 >= 0
      s - 要更改为的非null属性。任何定义的属性将应用于给定范围的文本。
      replace - 指示是否在设置新属性之前应清除先前的属性。如果为true,则操作将完全替换先前的属性。如果为false,则新属性将与先前的属性合并。
    • setLogicalStyle

      void setLogicalStyle(int pos, Style s)
      设置给定位置段落使用的逻辑样式。如果未明确设置字符和段落属性,则它们将通过分配给段落的逻辑样式解析,该逻辑样式可能通过文档中与元素层次结构完全独立的某些层次解析。
      参数:
      pos - 起始位置 >= 0
      s - 要设置的样式
    • getLogicalStyle

      Style getLogicalStyle(int p)
      获取段落中给定位置的逻辑样式。
      参数:
      p - 位置 >= 0
      返回:
      样式
    • getParagraphElement

      Element getParagraphElement(int pos)
      获取表示文档中给定偏移处包围段落的元素。
      参数:
      pos - 偏移 >= 0
      返回:
      元素
    • getCharacterElement

      Element getCharacterElement(int pos)
      获取表示文档中给定偏移处字符的元素。
      参数:
      pos - 偏移 >= 0
      返回:
      元素
    • getForeground

      Color getForeground(AttributeSet attr)
      获取一组属性并将其转换为前景色规范。这可能用于指定更亮、更色调等内容。
      参数:
      attr - 属性集
      返回:
      颜色
    • getBackground

      Color getBackground(AttributeSet attr)
      获取一组属性并将其转换为背景颜色规范。这可能用于指定更亮、更色调等内容。
      参数:
      attr - 属性集
      返回:
      颜色
    • getFont

      Font getFont(AttributeSet attr)
      获取一组属性并将其转换为字体规范。这可用于将诸如家族、样式、大小等内容转换为当前正在使用文档的系统上可用的字体。
      参数:
      attr - 属性集
      返回:
      字体