模块 java.desktop
包 javax.swing

类 JTextPane

java.lang.Object
java.awt.Component
java.awt.Container
javax.swing.JComponent
javax.swing.text.JTextComponent
javax.swing.JEditorPane
javax.swing.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
可以用图形表示的属性标记的文本组件。您可以在 使用文本组件 中找到使用文本窗格的操作方法信息和示例，这是 The Java Tutorial. 中的一个部分

该组件对由一系列字符级属性组成的段落建模。每个段落都可以附加一个逻辑样式，其中包含要使用的默认属性，如果没有被段落或字符运行上设置的属性重写的话。组件和图像可以嵌入到文本流中。

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

Warning: Swing 不是线程安全的。有关详细信息，请参阅 Swing 的线程策略。

Warning: 此类的序列化对象将与未来的 Swing 版本不兼容。当前的序列化支持适用于运行相同版本 Swing 的应用程序之间的短期存储或 RMI。从 1.4 开始，对所有 JavaBeans 的长期存储的支持已添加到 java.beans 包中。请参阅 XMLEncoder 。

自从：
1.2
参见：

  • 构造方法详细信息

    • JTextPane

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

    • JTextPane

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

  • 方法详情

    • getUIClassID

      @BeanProperty (bound =false) public String  getUIClassID()
      返回 UI 的类 ID。
      重写：
      getUIClassID 在类 JEditorPane 中
      返回：
      字符串“TextPaneUI”
      参见：

    • setDocument

      public void setDocument(Document  doc)
      将编辑器与文本文档相关联。这必须是 StyledDocument 。
      重写：
      setDocument 在类 JTextComponent 中
      参数：
      doc - 要显示/编辑的文档
      抛出：
      IllegalArgumentException - 如果 doc 不能缩小为 StyledDocument，这是此文本组件所需的模型类型
      参见：

    • 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 - 要插入的图标
      参见：

    • 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 - 如果为真，则首先替换现有属性

    • getParagraphAttributes

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

    • setParagraphAttributes

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

    • getInputAttributes

      @BeanProperty (bound =false) public MutableAttributeSet  getInputAttributes()
      获取窗格的输入属性。
      返回：
      属性

    • getStyledEditorKit

      protected final StyledEditorKit  getStyledEditorKit()
      获取编辑器工具包。
      返回：
      编辑器套件

    • createDefaultEditorKit

      protected EditorKit  createDefaultEditorKit()
      创建默认使用的 EditorKit。这是为了返回 javax.swing.text.StyledEditorKit 而实现的。
      重写：
      createDefaultEditorKit 在类 JEditorPane 中
      返回：
      编辑器套件

    • setEditorKit

      public final void setEditorKit(EditorKit  kit)
      设置当前安装的用于处理内容的工具包。这是建立编辑器内容类型的绑定属性。
      重写：
      setEditorKit 在类 JEditorPane 中
      参数：
      kit - 所需的编辑器行为
      抛出：
      IllegalArgumentException - 如果套件不是 StyledEditorKit
      参见：

    • paramString

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