JavaTM Platform
Standard Ed. 6

javax.swing.text.html
类 MinimalHTMLWriter

java.lang.Object
  继承者 javax.swing.text.AbstractWriter
      继承者 javax.swing.text.html.MinimalHTMLWriter

public class MinimalHTMLWriter
     
extends AbstractWriter

MinimalHTMLWriter 是一个回退 writer,HTMLEditorKit 使用它为非 EditorKit 生成的文档写出 HTML。 文档的格式为:

 <html>
   <head>
     <style>
        <!-- list of named styles
         p.normal {
            font-family: SansSerif;
              margin-height: 0;
              font-size: 14
           }
        -->
      </style>
   </head>
   <body>
    <p style=normal>
        Bold, italic, and underline attributes
        of the run are emitted as HTML tags.
        The remaining attributes are emitted as
        part of the style attribute of a <span> tag.
        The syntax is similar to inline styles.
</p>
   </body>
 </html>
 


字段摘要
 
从类 javax.swing.text.AbstractWriter 继承的字段
NEWLINE
 
构造方法摘要
MinimalHTMLWriter(Writer w, StyledDocument doc)
          创建一个新的 MinimalHTMLWriter。
MinimalHTMLWriter(Writer w, StyledDocument doc, int pos, int len)
          创建一个新的 MinimalHTMLWriter。
 
方法摘要
protected  void endFontTag()
          此方法已不再使用,而用写出 <span> 来替换。
protected  boolean inFontTag()
          如果我们当前正处在 <font> 标记中,则返回 true。
protected  boolean isText(Element elem)
          如果元素是文本元素,则返回 true。
protected  void startFontTag(String style)
          此方法已不再使用,而用写出 <span> 来替换。
protected  void text(Element elem)
          写出文本。
 void write()
          从 StyledDocument 生成 HTML 输出。
protected  void writeAttributes(AttributeSet attr)
          写出以下类型的所有属性:StyleConstants.ParagraphConstants、StyleConstants.CharacterConstants、StyleConstants.FontConstants、StyleConstants.ColorConstants。
protected  void writeBody()
          对文档中的元素进行迭代,并基于元素是分支元素还是叶元素来处理它们。
protected  void writeComponent(Element elem)
          负责处理 Component Elements;有意不实现它。
protected  void writeContent(Element elem, boolean needsIndenting)
          以与 HTML 兼容的方式写出属性集。
protected  void writeEndParagraph()
          发出 <p> 标记的结束标记。
protected  void writeEndTag(String endTag)
          写出适当缩进的结束标记。
protected  void writeHeader()
          写出 <head> 和 <style> 标记,然后调用 writeStyles(),以写出所有命名的样式,这些样式作为 <style> 标记的内容。
protected  void writeHTMLTags(AttributeSet attr)
          基于文本的属性设置生成文本的 bold <b>、italic <i> 和 <u> 标记。
protected  void writeImage(Element elem)
          负责处理 Icon Elements;有意不实现它。
protected  void writeLeaf(Element elem)
          负责写出其他非文本叶元素。
protected  void writeNonHTMLAttributes(AttributeSet attr)
          以与 HTML 兼容的方式写出其余的字符级属性(bold、italic 和 underline 之外的属性)。
protected  void writeStartParagraph(Element elem)
          发出段落的开始标记。
protected  void writeStartTag(String tag)
          写出适当缩进的开始标记。
protected  void writeStyles()
          写出所有命名的样式,这些样式作为 <style> 标记的内容。
 
从类 javax.swing.text.AbstractWriter 继承的方法
decrIndent, getCanWrapLines, getCurrentLineLength, getDocument, getElementIterator, getEndOffset, getIndentLevel, getIndentSpace, getLineLength, getLineSeparator, getStartOffset, getText, getWriter, incrIndent, indent, inRange, isLineEmpty, output, setCanWrapLines, setCurrentLineLength, setIndentSpace, setLineLength, setLineSeparator, write, write, write, writeLineSeparator
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

构造方法详细信息

MinimalHTMLWriter

public MinimalHTMLWriter(Writer w,
                         StyledDocument doc)
创建一个新的 MinimalHTMLWriter。

参数:
w - Writer
doc - StyledDocument

MinimalHTMLWriter

public MinimalHTMLWriter(Writer w,
                         StyledDocument doc,
                         int pos,
                         int len)
创建一个新的 MinimalHTMLWriter。

参数:
w - Writer
doc - StyledDocument
pos - 文档中要获取内容的位置。
len - 写出量。
方法详细信息

write

public void write()
           throws IOException,
                  BadLocationException
从 StyledDocument 生成 HTML 输出。

指定者:
AbstractWriter 中的 write
抛出:
IOException - 如果发生任何 I/O 错误
BadLocationException - 如果 pos 表示文档中的一个无效位置

writeAttributes

protected void writeAttributes(AttributeSet attr)
                        throws IOException
写出以下类型的所有属性:StyleConstants.ParagraphConstants、StyleConstants.CharacterConstants、StyleConstants.FontConstants、StyleConstants.ColorConstants。属性名称和值用冒号隔开。每个名称值对都用分号隔开。

覆盖:
AbstractWriter 中的 writeAttributes
参数:
attr - AttributeSet。
抛出:
IOException - 如果发生任何 I/O 错误

text

protected void text(Element elem)
             throws IOException,
                    BadLocationException
写出文本。

覆盖:
AbstractWriter 中的 text
参数:
elem - Element。
抛出:
IOException - 如果发生任何 I/O 错误
BadLocationException - 如果 pos 表示文档中的一个无效位置

writeStartTag

protected void writeStartTag(String tag)
                      throws IOException
写出适当缩进的开始标记。还可以增加缩进量。

抛出:
IOException - 如果发生任何 I/O 错误

writeEndTag

protected void writeEndTag(String endTag)
                    throws IOException
写出适当缩进的结束标记。还可以减少缩进量。

抛出:
IOException - 如果发生任何 I/O 错误

writeHeader

protected void writeHeader()
                    throws IOException
写出 <head> 和 <style> 标记,然后调用 writeStyles(),以写出所有命名的样式,这些样式作为 <style> 标记的内容。内容周围带有有效的 HTML 注释标记,以确保文档在不支持标记的应用程序/浏览器中能够被看到。

抛出:
IOException - 如果发生任何 I/O 错误

writeStyles

protected void writeStyles()
                    throws IOException
写出所有命名的样式,这些样式作为 <style> 标记的内容。

抛出:
IOException - 如果发生任何 I/O 错误

writeBody

protected void writeBody()
                  throws IOException,
                         BadLocationException
对文档中的元素进行迭代,并基于元素是分支元素还是叶元素来处理它们。此方法对作为文本的叶元素进行特殊处理。

抛出:
IOException - 如果发生任何 I/O 错误
BadLocationException

writeEndParagraph

protected void writeEndParagraph()
                          throws IOException
发出 <p> 标记的结束标记。写出标记之前,此方法确保正确关闭所有已打开的其他标记。

抛出:
IOException - 如果发生任何 I/O 错误

writeStartParagraph

protected void writeStartParagraph(Element elem)
                            throws IOException
发出段落的开始标记。如果段落具有与此方法关联的指定样式,则此方法还生成 <p> 标记的类属性,并将其值设置为样式的名称。

抛出:
IOException - 如果发生任何 I/O 错误

writeLeaf

protected void writeLeaf(Element elem)
                  throws IOException
负责写出其他非文本叶元素。

抛出:
IOException - 如果发生任何 I/O 错误

writeImage

protected void writeImage(Element elem)
                   throws IOException
负责处理 Icon Elements;有意不实现它。如何实现此方法是一个策略问题。例如,如果您正在生成 <img> 标记,那么您应该如何表示 src 属性呢(图像的位置)?某些情况下它将是 URL,而其他情况下则可能是从流中读取。

参数:
elem - StyleConstants.IconElementName 类型元素
抛出:
IOException

writeComponent

protected void writeComponent(Element elem)
                       throws IOException
负责处理 Component Elements;有意不实现它。如何实现此方法是一个策略问题。

抛出:
IOException

isText

protected boolean isText(Element elem)
如果元素是文本元素,则返回 true。


writeContent

protected void writeContent(Element elem,
                            boolean needsIndenting)
                     throws IOException,
                            BadLocationException
以与 HTML 兼容的方式写出属性集。

抛出:
IOException - 如果发生任何 I/O 错误
BadLocationException - 如果 pos 表示文档中的一个无效位置

writeHTMLTags

protected void writeHTMLTags(AttributeSet attr)
                      throws IOException
基于文本的属性设置生成文本的 bold <b>、italic <i> 和 <u> 标记。

抛出:
IOException - 如果发生任何 I/O 错误

writeNonHTMLAttributes

protected void writeNonHTMLAttributes(AttributeSet attr)
                               throws IOException
以与 HTML 兼容的方式写出其余的字符级属性(bold、italic 和 underline 之外的属性)。因为字体系列和字体大小这样的属性没有到 HTML 标记的直接映射,因此生成一个 <span> 标记并将其样式属性设置为包含其余属性(如内嵌样式)的列表。

抛出:
IOException - 如果发生任何 I/O 错误

inFontTag

protected boolean inFontTag()
如果我们当前正处在 <font> 标记中,则返回 true。


endFontTag

protected void endFontTag()
                   throws IOException
此方法已不再使用,而用写出 <span> 来替换。

写出 <font> 标记的结束标记。

抛出:
IOException - 如果发生任何 I/O 错误

startFontTag

protected void startFontTag(String style)
                     throws IOException
此方法已不再使用,而用写出 <span> 来替换。

写出 <font> 标记的开始标记。因为字体标记不能嵌套,所以在此方法写出新的开始标记之前将关闭任何打开的字体标记。

抛出:
IOException - 如果发生任何 I/O 错误

JavaTM Platform
Standard Ed. 6

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

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