JavaTM 2 Platform
Standard Ed. 5.0

javax.swing.text.html
类 HTMLEditorKit.InsertHTMLTextAction

java.lang.Object
  继承者 javax.swing.AbstractAction
      继承者 javax.swing.text.TextAction
          继承者 javax.swing.text.StyledEditorKit.StyledTextAction
              继承者 javax.swing.text.html.HTMLEditorKit.HTMLTextAction
                  继承者 javax.swing.text.html.HTMLEditorKit.InsertHTMLTextAction
所有已实现的接口:
ActionListener, Serializable, Cloneable, EventListener, Action
正在封闭类:
HTMLEditorKit

public static class HTMLEditorKit.InsertHTMLTextAction
extends HTMLEditorKit.HTMLTextAction

InsertHTMLTextAction 可用于将任意 HTML 字符串插入现有 HTML 文档。至少需要提供两个 HTML.Tag。第一个 Tag 是 parentTag,它标识要向其添加元素的文档中的父级。第二个 Tag 是 addTag,它标识在 HTML 字符串中所看到的、应该被添加到文档中的首个标记。要记住的一个重要问题是解析器将生成所有适当的标记,即使它们不在传入的 HTML 字符串中也是如此。

例如,要创建一个动作,将一个表插入正文中。parentTag 应为 HTML.Tag.BODY,addTag 应为 HTML.Tag.TABLE,并且字符串可以类似于 <table><tr><td></td></tr></table>。

还有一个选项用来提供替换的 parentTag 和 addTag。如果在 offset 处没有 parentTag,则将检查它们。


字段摘要
protected  HTML.Tag addTag
          HTML 中的 Tag(从此 Tag 开始添加标记)。
protected  HTML.Tag alternateAddTag
          HTML 中的替换 Tag,如果未找到 parentTag 但找到了 alternateParentTag,则从此替换 Tag 开始添加标记。
protected  HTML.Tag alternateParentTag
          如果未找到 parentTag,则要在文档中检查的替换 Tag。
protected  String html
          要插入的 HTML。
protected  HTML.Tag parentTag
          要在文档中检查的 Tag。
 
从类 javax.swing.AbstractAction 继承的字段
changeSupport, enabled
 
从接口 javax.swing.Action 继承的字段
ACCELERATOR_KEY, ACTION_COMMAND_KEY, DEFAULT, LONG_DESCRIPTION, MNEMONIC_KEY, NAME, SHORT_DESCRIPTION, SMALL_ICON
 
构造方法摘要
HTMLEditorKit.InsertHTMLTextAction(String name, String html, HTML.Tag parentTag, HTML.Tag addTag)
           
HTMLEditorKit.InsertHTMLTextAction(String name, String html, HTML.Tag parentTag, HTML.Tag addTag, HTML.Tag alternateParentTag, HTML.Tag alternateAddTag)
           
 
方法摘要
 void actionPerformed(ActionEvent ae)
          将 HTML 插入文档。
protected  void insertAtBoundary(JEditorPane editor, HTMLDocument doc, int offset, Element insertElement, String html, HTML.Tag parentTag, HTML.Tag addTag)
          当在边界上插入时调用。
protected  void insertAtBoundry(JEditorPane editor, HTMLDocument doc, int offset, Element insertElement, String html, HTML.Tag parentTag, HTML.Tag addTag)
          已过时。 从 Java 2 平台 v1.3 开始,使用 insertAtBoundary
protected  void insertHTML(JEditorPane editor, HTMLDocument doc, int offset, String html, int popDepth, int pushDepth, HTML.Tag addTag)
          HTMLEditorKit.insertHTML 的一个覆盖。
 
从类 javax.swing.text.html.HTMLEditorKit.HTMLTextAction 继承的方法
elementCountToTag, findElementMatchingTag, getElementsAt, getHTMLDocument, getHTMLEditorKit
 
从类 javax.swing.text.StyledEditorKit.StyledTextAction 继承的方法
getEditor, getStyledDocument, getStyledEditorKit, setCharacterAttributes, setParagraphAttributes
 
从类 javax.swing.text.TextAction 继承的方法
augmentList, getFocusedComponent, getTextComponent
 
从类 javax.swing.AbstractAction 继承的方法
addPropertyChangeListener, clone, firePropertyChange, getKeys, getPropertyChangeListeners, getValue, isEnabled, putValue, removePropertyChangeListener, setEnabled
 
从类 java.lang.Object 继承的方法
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

字段详细信息

html

protected String html
要插入的 HTML。


parentTag

protected HTML.Tag parentTag
要在文档中检查的 Tag。


addTag

protected HTML.Tag addTag
HTML 中的 Tag(从此 Tag 开始添加标记)。


alternateParentTag

protected HTML.Tag alternateParentTag
如果未找到 parentTag,则要在文档中检查的替换 Tag。


alternateAddTag

protected HTML.Tag alternateAddTag
HTML 中的替换 Tag,如果未找到 parentTag 但找到了 alternateParentTag,则从此替换 Tag 开始添加标记。

构造方法详细信息

HTMLEditorKit.InsertHTMLTextAction

public HTMLEditorKit.InsertHTMLTextAction(String name,
                                          String html,
                                          HTML.Tag parentTag,
                                          HTML.Tag addTag)

HTMLEditorKit.InsertHTMLTextAction

public HTMLEditorKit.InsertHTMLTextAction(String name,
                                          String html,
                                          HTML.Tag parentTag,
                                          HTML.Tag addTag,
                                          HTML.Tag alternateParentTag,
                                          HTML.Tag alternateAddTag)
方法详细信息

insertHTML

protected void insertHTML(JEditorPane editor,
                          HTMLDocument doc,
                          int offset,
                          String html,
                          int popDepth,
                          int pushDepth,
                          HTML.Tag addTag)
HTMLEditorKit.insertHTML 的一个覆盖。如果它抛出了一个异常,则将它包装到 RuntimeException 中并抛出。


insertAtBoundary

protected void insertAtBoundary(JEditorPane editor,
                                HTMLDocument doc,
                                int offset,
                                Element insertElement,
                                String html,
                                HTML.Tag parentTag,
                                HTML.Tag addTag)
当在边界上插入时调用。它确定了弹出数,之后确定需要执行的压入数,然后调用 insertHTML。

从以下版本开始:
1.3

insertAtBoundry

@Deprecated
protected void insertAtBoundry(JEditorPane editor,
                                          HTMLDocument doc,
                                          int offset,
                                          Element insertElement,
                                          String html,
                                          HTML.Tag parentTag,
                                          HTML.Tag addTag)
已过时。 从 Java 2 平台 v1.3 开始,使用 insertAtBoundary

当在边界上插入时调用。它确定了弹出数,之后确定需要执行的压入数,然后调用 insertHTML。


actionPerformed

public void actionPerformed(ActionEvent ae)
将 HTML 插入文档。

参数:
ae - 事件

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策