模块  java.desktop
软件包  javax.swing

Class JTextPane

  • 实现的所有接口
    ImageObserver ， MenuContainer ， Serializable ， Accessible ， Scrollable 
    @JavaBean(description="A text component that can be marked up with attributes that are graphically represented.")
public class JTextPane
extends JEditorPane
    一个文本组件，可以使用以图形方式表示的属性进行标记。 您可以在“Java教程”的 Using Text Components部分中找到使用文本窗格的操作方法信息和示例。

    该组件模拟由字符级属性的运行组成的段落。 每个段落都可以附加一个逻辑样式，如果没有被段落或字符运行中设置的属性覆盖，则包含要使用的默认属性。 组件和图像可以嵌入文本流中。

    换行
    有关如何处理换行的讨论，请参阅DefaultEditorKit 。

    警告： Swing不是线程安全的。 有关更多信息，请参阅Swing's Threading Policy 。

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

    从以下版本开始：
    1.2
    另请参见：
    StyledEditorKit ， Serialized Form

    • 构造方法详细信息

      • JTextPane

        public JTextPane()
        创建一个新的JTextPane 。 创建并设置新的StyledEditorKit实例，并将文档模型设置为null 。

      • JTextPane

        public JTextPane​(StyledDocument doc)
        使用指定的文档模型创建新的JTextPane 。 创建并设置新的javax.swing.text.StyledEditorKit实例。
        参数
        doc - 文档模型

    • 方法详细信息

      • setStyledDocument

        public void setStyledDocument​(StyledDocument doc)
        将编辑器与文本文档关联。 当前注册的工厂用于构建文档的视图，该视图由编辑器显示。
        参数
        doc - 要显示/编辑的文档

      • getStyledDocument

        public StyledDocument getStyledDocument()
        获取与编辑器关联的模型。
        结果
        该模型

      • replaceSelection

        public void replaceSelection​(String content)
        用当前字符串表示的新内容替换当前选定的内容。 如果没有选择，则相当于给定文本的插入。 如果没有替换文本，则相当于删除当前选择。 替换文本将具有当前为插入点处的输入定义的属性。 如果文档不可编辑，则发出蜂鸣声并返回。
        重写：
        replaceSelection ，类 JEditorPane
        参数
        content - 用于替换选择的内容

      • insertComponent

        public void insertComponent​(Component c)
        将组件插入到文档中以替换当前选定的内容。 如果没有选择，则组件有效地插入到插入符号的当前位置。 这在关联文档中表示为内容的一个字符的属性。

        给定的组件是JTextPane使用的实际组件。 由于组件不能是多个容器的子组件，因此不应在文本组件共享模型的情况下使用此方法。

        根据Component.getAlignmentY返回的值，相对于文本基线放置组件。 对于Swing组件，可以使用方法JComponent.setAlignmentY方便地设置此值。 例如，设置值0.75将导致75％的组件高于基线，25％的组件低于基线。

        参数
        c - 要插入的组件

      • insertIcon

        public void insertIcon​(Icon g)
        在文档中插入图标作为当前所选内容的替代。 如果没有选择，则图标有效地插入到插入符号的当前位置。 这在关联文档中表示为内容的一个字符的属性。
        参数
        g - 要插入的图标
        另请参见：
        Icon

      • addStyle

        public Style addStyle​(String nm,
                      Style parent)
        在逻辑样式层次结构中添加新样式。 样式属性从下向上解析，因此子项中指定的属性将覆盖父项中指定的属性。
        参数
        nm - 样式的名称（在命名样式集合中必须是唯一的）。 如果样式未命名，则名称可能是null ，但调用者负责管理返回的引用，因为无法通过名称获取未命名的样式。 未命名的样式可能对诸如样式运行中的字符属性覆盖之类的内容有用。
        parent - 父样式。 如果未指定某些其他样式的未指定属性，则可能是null 。
        结果
        新的 Style

      • removeStyle

        public void removeStyle​(String nm)
        删除先前添加到文档中的已命名的非 null样式。
        参数
        nm - 要删除的样式的名称

      • getStyle

        public Style getStyle​(String nm)
        获取先前添加的命名非 null样式。
        参数
        nm - 样式的名称
        结果
        Style

      • setLogicalStyle

        public void setLogicalStyle​(Style s)
        设置用于当前插入符号位置的段落的逻辑样式。 如果没有为字符和段落属性显式设置属性，则它们将通过分配给段落的逻辑样式来解析，该术语可以通过某个层次结构完全独立于文档中的元素层次结构来解析。
        参数
        s - 要分配给段落的逻辑样式，或 null表示没有样式

      • getLogicalStyle

        public Style getLogicalStyle()
        获取分配给由插入符当前位置表示的段落的逻辑样式，或 null 。
        结果
        Style

      • getCharacterAttributes

        @BeanProperty(bound=false)
public AttributeSet getCharacterAttributes()
        获取插入符号当前位置生效的字符属性，或 null 。
        结果
        属性，或 null

      • setCharacterAttributes

        public void setCharacterAttributes​(AttributeSet attr,
                                   boolean replace)
        将给定属性应用于角色内容。 如果有选择，则属性将应用于选择范围。 如果没有选择，则将属性应用于输入属性集，该属性集定义要插入的任何新文本的属性。
        参数
        attr - 属性
        replace - 如果为true，则首先替换现有属性

      • getParagraphAttributes

        @BeanProperty(bound=false)
public AttributeSet getParagraphAttributes()
        获取插入符号位置有效的当前段落属性，如果没有，则 null 。
        结果
        属性

      • setParagraphAttributes

        public void setParagraphAttributes​(AttributeSet attr,
                                   boolean replace)
        将给定属性应用于段落。 如果存在选择，则属性将应用于与选择相交的段落。 如果没有选择，则属性将应用于当前插入符号位置的段落。
        参数
        attr - 非 null属性
        replace - 如果为true， replace替换现有属性

      • getStyledEditorKit

        protected final StyledEditorKit getStyledEditorKit()
        获取编辑器工具包。
        结果
        编辑工具包

      • createDefaultEditorKit

        protected EditorKit createDefaultEditorKit()
        创建默认使用的EditorKit 。 这是为了返回javax.swing.text.StyledEditorKit 。
        重写：
        createDefaultEditorKit在类 JEditorPane
        结果
        编辑工具包

      • paramString

        protected String paramString()
        返回此JTextPane的字符串表示JTextPane 。 此方法仅用于调试目的，返回字符串的内容和格式可能因实现而异。 返回的字符串可能为空，但可能不是null 。
        重写：
        paramString类 JEditorPane
        结果
        此 JTextPane的字符串表示 JTextPane